ボールトロックの完了 (ロック ID の POST) - Amazon S3 Glacier

このページは、Vaults と 2012 RESTAPI年のオリジナルを使用する S3 Glacier サービスの既存のお客様専用です。

アーカイブストレージソリューションをお探しの場合は、Amazon S3、S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval、S3 Glacier Deep Archive の S3 Glacier ストレージクラスを使用することをお勧めします。これらのストレージオプションの詳細については、Amazon S3 ユーザーガイドの「S3 Glacier ストレージクラス」およびS3 Glacier ストレージクラスを使用した長期データストレージ」を参照してください。 Amazon S3 これらのストレージクラスは Amazon S3 を使用しAPI、すべてのリージョンで利用可能で、Amazon S3 コンソール内で管理できます。Storage Cost Analysis、Storage Lens、高度なオプションの暗号化機能などの機能を提供します。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ボールトロックの完了 (ロック ID の POST)

説明

このオペレーションでは、ボールトロックを InProgress 状態から Locked 状態にすることによってボールトロック処理を完了します。これにより、ボールトロックポリシーは変更できなくなります。ボールトロックは、InProgressを要求することによって ボールトロックの開始 (ロックポリシーの POST) 状態になります。ボールトロックの状態は、ボールトロックの取得 (ロックポリシーの GET)を要求することによって取得できます。ボールトロック処理の詳細については、「S3 Glacier ボールトロック」を参照してください。

このオペレーションはべき等です。このリクエストは、ボールトロックが Locked 状態にあり、指定したロック ID がボールトのロックに使用されたロック ID と一致する場合は常に成功します。

ボールトロックが Locked 状態のときにリクエストで無効なロック ID が渡された場合は、AccessDeniedException エラーが返されます。ボールトロックが InProgress 状態のときにリクエストで無効なロック ID が渡された場合は、InvalidParameter エラーがスローされます。

リクエスト

ボールトロック処理を完了するには、ボールトの POST サブリソースの URI に有効なロック ID を指定した HTTP lock-policy リクエストを送信します。

構文

POST /AccountId/vaults/vaultName/lock-policy/lockId HTTP/1.1 Host: glacier.Region.amazonaws.com Date: Date Authorization: SignatureValue Content-Length: Length x-amz-glacier-version: 2012-06-01
注記

-AccountIdvalueAWS アカウントID。この値はリクエストの署名に使用した認証情報に関連する AWS アカウント ID と一致する必要があります。AWS アカウント ID、または Amazon S3 Glacier がリクエストの署名に使用した認証情報に関連する AWS アカウント ID を使用している場合はオプションで`-`「-」のどちらかを指定できます。お客様のアカウント ID を指定する場合は、ハイフン(`-`)を含めないでください。

lockId の値は、ボールトロックの開始 (ロックポリシーの POST)リクエストによって取得したロック ID です。

リクエストパラメータ

リクエストヘッダー

この操作では、すべての操作で共通のリクエストヘッダーのみ使用します。共通のリクエストヘッダーの詳細については、「一般的なリクエストヘッダー」を参照してください。

リクエスト本文

この操作にリクエストボディはありません。

レスポンス

オペレーションリクエストが成功した場合、サービスは HTTP 応答 204 No Content を返します。

構文

HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date

レスポンスヘッダー

この操作はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。共通のレスポンスヘッダーの詳細については、「共通のレスポンスヘッダー」を参照してください。

レスポンス本文

このオペレーションでは、レスポンス本文は返しません。

エラー

Amazon S3 Glacier の例外とエラーメッセージについては、「エラーレスポンス」を参照してください。

リクエストの例

次の例では、ボールトロック処理を完了するためにロック ID を指定した HTTP POST リクエストを送信します。

POST /-/vaults/examplevault/lock-policy/AE863rKkWZU53SLW5be4DUcW HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 Content-Length: length x-amz-glacier-version: 2012-06-01

レスポンスの例

リクエストが成功した場合、次の例に示すように、Amazon S3 Glacier (S3 Glacier) は HTTP 204 No Content レスポンスを返します。

HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT

以下も参照してください。

言語固有の Amazon SDK のいずれかでこの API を使用する方法の詳細については、次を参照してください。