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ユーザーへのカスタムポリシーのアタッチ」をご参照ください。