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

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

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

Description

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

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

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

Requests

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

Syntax

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値は AWS アカウント ID. この値は、 AWS アカウント リクエストに署名するため使用された認証情報に関連する ID。次のいずれかを実行できます。 AWS アカウント ID、またはオプションで単一の '-'(ハイフン)を使用します。この場合、Amazon S3 Glacier は AWS アカウント リクエストに署名するため使用された認証情報に関連する ID。アカウント ID を指定する場合は、ID にハイフン ('-') を含めないでください。

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

リクエストパラメータ

リクエストヘッダー

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

リクエストボディ

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

Responses

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

Syntax

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

レスポンスヘッダー

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

レスポンス本文

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

Errors

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

Examples

リクエストの例

次の例では、ボールトロック処理を完了するためにロック 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 を使用する方法の詳細については、以下を参照してください。