このページは、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 ストレージクラス
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ボールトロックの完了 (ロック 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
注記
-AccountId
valueAWS アカウント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 を使用する方法の詳細については、次を参照してください。