サポートされている REST API アクション

AWS Snowball Edge デバイスと Amazon S3 で使用できる REST API アクションを以下に示します。

Snowball Edge デバイスでサポートされる REST API アクション

HEAD Snowball Edge

説明

現在のところ、Snowball Edge REST API オペレーションは 1 つだけです。このオペレーションは、特定のデバイスのステータス情報を返すために使用できます。このオペレーションは、Snowball Edge のステータスを返します。このステータスには、トラブルシューティングの目的で AWS Support が使用できる情報が含まれています。

AWS SDK または 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>

Amazon S3 アダプターでサポートされる REST API アクション

以下は、Amazon S3 アダプターの使用でサポートされる Amazon S3 REST API アクションの一覧です。このリストには、Amazon S3 での API アクションの動作に関する情報へのリンクが含まれています。また、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 REST API コールでは、SigV4 署名が必要です。AWS CLI または AWS SDK を使用してこれらの API コールを実行する場合、SigV4 署名は自動的に処理されます。それ以外の場合は、お客様独自の SigV4 署名ソリューションを実装する必要があります。詳細については、Amazon Simple Storage Service ユーザーガイドのリクエストの認証 (AWS 署名バージョン 4)を参照してください。

• GET Bucket (オブジェクトのリスト化) バージョン 1は、サポートされます。ただし、この GET オペレーションの実装では、以下はサポートされません。

  • ページ分割

  • マーカー

  • 区切り記号

  • リストが返される際、リストはソートされません。

  Version 1 のみがサポートされます。GET Bucket (List Objects) version 2 はサポートされません。

• GET Service

• HEAD Bucket

• HEAD Object

• GET Object – Snow デバイスの S3 バケットからオブジェクトをダウンロードします。

• PUT Object – PUT Object を使用する AWS Snowball Edge デバイスにオブジェクトをアップロードすると、ETag が生成されます。

  ETag は、オブジェクトのハッシュです。ETag は、オブジェクトのコンテンツに加えた変更のみを反映し、メタデータに加えた変更は反映しません。ETag は、オブジェクトデータの MD5 ダイジェストである場合と、そうでない場合があります。ETags の詳細については、Amazon Simple Storage Service API リファレンスの共通の応答ヘッダーを参照してください。

• DELETE Object

• マルチパートアップロードの開始 – この実装では、AWS Snowball Edge デバイス上に既にあるオブジェクトに対してマルチパートアップロードリクエストを開始すると、まずそのオブジェクトが削除されます。次に、いくつかのパートに分けられて、AWS Snowball Edge デバイスにコピーされます。

• マルチパートアップロードのリスト

• Upload Part

• Complete Multipart Upload

• マルチパートアップロードの中止

注記

ここに記載されていない Amazon S3 アダプター REST API アクションはサポートされません。サポートされていない REST API アクションを Snowball Edge で使用すると、アクションがサポートされていないことを示すエラーメッセージが返されます。