Archive、Cold Archive、またはDeep Cold Archiveオブジェクトを復元した後、オブジェクトを読む前にオブジェクトが復元されていることを確認してください。 多数のオブジェクトを復元した後、ListObjectsV2
、ListObjects
、またはListObjectVersions
操作を呼び出して、名前に特定のプレフィックスが含まれるオブジェクトがRestoreInfo
応答要素に基づいて復元されているかどうかを確認できます。 少数のオブジェクトを復元した後、HeadObject
操作を呼び出し、オブジェクト名を指定して、オブジェクトがx-oss-restore
レスポンスヘッダーに基づいて復元されているかどうかを確認できます。
複数のオブジェクトに関する復元情報を同時にクエリ
複数のオブジェクトに関する復元情報を同時にクエリする場合は、ListObjectsV2
、ListObjects
、またはListObjectVersions
操作を呼び出して、RestoreInfo
応答要素を確認します。
復元操作が実行されなかった場合、または復元操作がタイムアウトした場合、
RestoreInfo
応答要素は返されません。復元操作が進行中の場合は、
RestoreInfo
応答要素の右側にprocessive-request="true"
が表示されます。復元操作が完了した場合、
RestoreInfo
応答要素の右側にcending-request="false"
が表示されます。 この場合、オブジェクトを読み取ることができない時間を示すために、RestoreInfo応答要素にexpiry-date
が含まれます。
使用上の注意
ListObjectsV2
、ListObjects
、またはListObjectVersions
操作を呼び出す場合、オブジェクトのストレージクラスを指定することはできません。 アーカイブ、コールドアーカイブ、ディープコールドアーカイブなどのストレージクラスに基づいて、返された結果のオブジェクトをフィルタリングする場合は、各オブジェクトのstorage-class
属性を確認し、ストレージクラスがクライアントで指定されていないオブジェクトを除外します。
権限
複数のオブジェクトに関する復元情報を同時にクエリするには、
oss:ListObjects
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。すべてのバージョンのオブジェクトに関する復元情報を同時にクエリするには、
oss:ListObjectVersions
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
ListObjectsV2
、ListObjects
、またはListObjectVersions
操作を呼び出して、Object Storage Service (OSS) コンソールまたはossutilを使用して複数のオブジェクトに関する復元情報を同時に照会することはできません。
特定のオブジェクトに関する復元情報のクエリ
少数の特定のオブジェクトに関する復元情報を照会する場合は、HeadObject
操作を呼び出して、オブジェクトがx-oss-restore
レスポンスヘッダーに基づいて復元されているかどうかを確認できます。
復元操作が実行されない場合、または復元操作がタイムアウトした場合、
x-oss-restore
応答ヘッダーは返されません。復元操作が進行中の場合は、
x-oss-restore
レスポンスヘッダーの右側にprocessive-request="true"
が表示されます。復元操作が完了すると、
x-oss-restore
レスポンスヘッダーの右側にcending-request="false"
が表示されます。 この場合、expiry-date
がx-oss-restore応答ヘッダーに含まれ、オブジェクトを読み取ることができなくなるまでの時間を示します。
使用上の注意
HeadObject
操作を呼び出して多数のオブジェクトに関する復元情報を照会すると、GETリクエストに対して高額の料金が発生します。 詳細については、「API操作呼び出し料金」をご参照ください。
権限
特定のオブジェクトに関する復元情報をクエリするには、oss:GetObject
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。