Archive、コールドアーカイブ、およびディープコールドアーカイブのオブジェクトは、読み取る前に解凍する必要があります。解凍を開始した後、以下のいずれかの方法を使用して、操作が完了したかどうかを確認します。
少数のオブジェクト:
HeadObjectを呼び出し、x-oss-restore応答ヘッダーを確認します。OSS コンソール、SDK、ossutil、および API を介して利用可能です。多数のオブジェクト:
ListObjectsV2、ListObjects、またはListObjectVersionsを呼び出し、RestoreInfo応答要素を確認します。SDK および API を介してのみ利用可能です。
復元状態
どちらの方法も、以下の3つの状態のいずれかを返します。
| 状態 | HeadObject (x-oss-restore ヘッダー) | ListObjects (RestoreInfo 要素) |
|---|---|---|
| 復元されていませんまたは復元がタイムアウトしました | ヘッダーが返されない | 要素が返されない |
| 復元中 | ongoing-request="true" | ongoing-request="true" |
| 復元完了 | ongoing-request="false", expiry-date="<date>" | ongoing-request="false", expiry-date="<date>" |
解凍が完了すると、expiry-date の値は、オブジェクトが再び読み取り不可になる日時を示します。
特定のオブジェクトの確認
HeadObject を使用して、個々のオブジェクトの解凍状態を確認します。
注意事項
多数のオブジェクトに対して HeadObject を呼び出すと、高額な GET リクエスト料金が発生します。詳細については、「API 操作呼び出し料金」をご参照ください。一度に多数のオブジェクトを確認するには、代わりに「バッチクエリ方式」を使用してください。
権限
oss:GetObject 権限が必要です。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。
複数のオブジェクトを一度に確認する
ListObjectsV2、ListObjects、または ListObjectVersions を使用して、プレフィックスで複数のオブジェクトの解凍状態を確認します。
OSS コンソールと ossutil は、バッチ解凍ステータスクエリをサポートしていません。SDK または API を使用してください。
注意事項
これらの操作は、ストレージクラスでオブジェクトをフィルタリングしません。Archive、コールドアーカイブ、またはディープコールドアーカイブのオブジェクトのみを確認するには、クライアント側で storage-class 属性によって結果をフィルタリングします。
権限
oss:ListObjects権限が必要です。オブジェクトバージョンをリストするには、
oss:ListObjectVersions権限も必要です。
詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。