翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Snow Family デバイスでサポートされている Amazon S3 RESTAPIアクション
以下に、 AWS Snowball Edge デバイスと Amazon S3 で使用できるRESTAPIアクションを示します。
トピック
Snowball Edge デバイスでサポートされているRESTAPIアクション
HEAD Snowball Edge オペレーション
現在、特定のデバイスのステータス情報を返すために使用できる Snowball Edge RESTAPIオペレーションは 1 つだけです。このオペレーションは、Snowball Edge デバイスのステータスを返します。このステータスには、トラブルシューティング AWS Support の目的で で使用できる情報が含まれます。
このオペレーションは、 または で AWS SDKsは使用できません AWS CLI。curl
または HTTPクライアントを使用することをお勧めします。このオペレーションに対しては、リクエストに署名する必要はありません。
リクエスト
次の例では、Snowball Edge デバイスの IP アドレスは です。192.0.2.0
。 この値を実際のデバイスの IP アドレスに置き換えます。
curl -X HEAD http://
192.0.2.0
:8080
レスポンス
<Status xsi:schemaLocation="http://s3.amazonaws.com/doc/2006-03-01/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <snowballIp>127.0.0.1</snowballIp> <snowballPort>8080</snowballPort> <snowballId>
device-id
</snowballId> <totalSpaceInBytes>499055067136</totalSpaceInBytes> <freeSpaceInBytes>108367699968</freeSpaceInBytes> <jobId>job-id
</jobId> <snowballServerVersion>1.0.1</snowballServerVersion> <snowballServerBuild>DevBuild</snowballServerBuild> <snowballClientVersion>Version 1.0</snowballClientVersion> <snowballRoundTripLatencyInMillis>33</snowballRoundTripLatencyInMillis> </Status>
Snowball Edge デバイスで Amazon S3 アダプターでサポートされているRESTAPIアクション
以下は、Amazon S3 アダプターの使用でサポートされている Amazon S3 RESTAPIアクションのリストです。このリストには、APIアクションが Amazon S3 とどのように連携するかに関する情報へのリンクが含まれています。このリストでは、Amazon S3 APIアクションと対応する AWS Snowball Edge デバイスの動作の違いについても説明します。以下の例が示すように、 AWS Snowball Edge デバイスから返されるレスポンスはすべて、Server
を AWSSnowball
として宣言します。
HTTP/1.1 201 OK x-amz-id-2: JuKZqmXuiwFeDQxhD7M8KtsKobSzWA1QEjLbTMTagkKdBX2z7Il/jGhDeJ3j6s80 x-amz-request-id: 32FE2CEB32F5EE25 Date: Fri, 08 2016 21:34:56 GMT Server: AWSSnowball
Amazon S3 RESTAPI呼び出しには SigV4 署名が必要です。 AWS CLI または AWS SDK を使用してこれらのAPI呼び出しを行う場合、SigV4 署名が処理されます。それ以外の場合は、お客様独自の SigV4 署名ソリューションを実装する必要があります。詳細については、Amazon Simple Storage Service ユーザーガイドの「リクエストの認証 (AWS 署名バージョン 4)」を参照してください。
-
GET バケット (リストオブジェクト) バージョン 1 – サポートされています。ただし、このGETオペレーションの実装では、以下はサポートされていません。
-
ページ分割
-
マーカー
-
区切り記号
-
リストが返される際、リストはソートされません。
Version 1 のみがサポートされます。GET バケット (リストオブジェクト) バージョン 2 はサポートされていません。
-
-
GET オブジェクト — Snow デバイスの S3 バケットからのDOWNLOADオブジェクトの です。
-
PUT オブジェクト — オブジェクトが を使用して AWS Snowball Edge デバイスにアップロードされると
PUT Object
、 が生成されETagます。ETag は オブジェクトのハッシュです。は、オブジェクトの内容に対する変更のみETagを反映し、メタデータに対する変更は反映しません。は、オブジェクトデータのMD5ダイジェストである場合ETagとそうでない場合があります。の詳細についてはETags、Amazon Simple Storage Service リファレンスの「一般的なレスポンスヘッダー」を参照してください。 API
-
マルチパートアップロードの開始 – この実装では、 AWS Snowball Edge デバイス上に既にあるオブジェクトに対してマルチパートアップロードリクエストを開始すると、まずそのオブジェクトが削除されます。次に、デバイスを部分的にコピーします AWS Snowball Edge 。
注記
ここで示されていない Amazon S3 アダプターRESTAPIアクションはサポートされていません。サポートされていないRESTAPIアクションを Snowball Edge で使用すると、そのアクションがサポートされていないことを示すエラーメッセージが返されます。