翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Snowball Edge との間でのデータ移行に Amazon S3 アダプターを使用したファイルの転送
以下は、Amazon S3 アダプターの概要です。Amazon S3 REST API アクションを使用して、 AWS Snowball Edge デバイスに既にある S3 バケットとの間でプログラムでデータを転送するために使用できます。 Amazon S3 この Amazon S3 REST API サポートは、アクションのサブセットのみに限定されています。このアクションのサブセットをいずれかの AWS SDKsで使用して、プログラムでデータを転送できます。また、Amazon S3 でサポートされる AWS Command Line Interface (AWS CLI) コマンドのサブセットを使用して、プログラムでデータを転送できます。
ソリューションが AWS SDK for Java バージョン 1.11.0 以降を使用している場合は、次の を使用する必要があります`S3ClientOptions`。
+ `disableChunkedEncoding()` – インターフェイスでは、チャンクエンコーディングがサポートされないことを示します。
+ `setPathStyleAccess(true)` – すべてのリクエストに対して、パススタイルのアクセスを使用するようにインターフェイスを設定します。
詳細については、*Amazon AppStream SDK for Java* の [Class S3ClientOptions.Builder](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/S3ClientOptions.Builder.html) を参照してください。
**重要**
デバイス上のローカルバケットへのデータの読み取りと書き込みには、一度に 1 つの方法のみを使用することをお勧めします AWS Snowball Edge 。NFS インターフェイスと Amazon S3 アダプターの両方を同じバケットで同時に使用すると、読み取り/書き込みの競合が発生する可能性があります。
「[AWS Snowball Edge クォータ](limits.md)」で、制限の詳細を説明しています。
AWS サービスが Snowball Edge で適切に動作するには、サービスのポートを許可する必要があります。詳細については、「[Snowball Edge の AWS サービスのポート要件](port-requirements.md)」を参照してください。
**Topics**
+ [Amazon S3 アダプターで使用するための AWS CLI バージョン 1.16.14 のダウンロードとインストール Amazon S3](#aws-cli-version)
+ [Snowball Edge デバイスで AWS CLI および API オペレーションを使用する](#using-adapter-cli-specify-region)
+ [Snowball Edge でのローカル Amazon S3 認証情報の取得と使用](#adapter-credentials)
+ [Snowball Edge の Amazon S3 アダプターでサポートされていない Amazon S3 機能](#snowball-edge-s3-unsupported-features)
+ [Snowball Edge へのデータ転送パフォーマンスを向上させるための小さなファイルのバッチ処理](batching-small-files.md)
+ [Snowball Edge との間のデータ転送でサポートされる AWS CLI コマンド](using-adapter-cli.md)
+ [Snowball Edge でのデータ転送でサポートされている Amazon S3 REST API アクション](using-adapter-supported-api.md)
## Amazon S3 アダプターで使用するための AWS CLI バージョン 1.16.14 のダウンロードとインストール Amazon S3
現在、Snowball Edge デバイスで Amazon S3 アダプターの使用がサポートされているのは、 AWS CLI 1.16.14 以前のバージョンのみです。の新しいバージョン AWS CLI は、Amazon S3 S3 アダプターと互換性がありません。
**注記**
Snowball Edge で Amazon S3 互換ストレージを使用している場合は、最新バージョンの を使用できます AWS CLI。最新バージョンをダウンロードして使用するには、「[AWS Command Line Interface ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)」を参照してください。
### Linux オペレーティングシステム AWS CLI に をインストールする
この連鎖コマンドを実行します。
```
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.14.zip" -o "awscli-bundle.zip";unzip awscli-bundle.zip;sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws;/usr/local/bin/aws --version;
```
### Windows オペレーティングシステム AWS CLI に をインストールする
お使いのオペレーティングシステム用のインストーラファイルをダウンロードして実行します。
+ [Python 2 にバンドルされた 32 ビットインストーラ](https://s3.amazonaws.com/aws-cli/AWSCLI32-1.16.14.msi)
+ [Python 3 にバンドルされた 32 ビットインストーラ](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3-1.16.14.msi)
+ [Python 2 にバンドルされた 64 ビットインストーラ](https://s3.amazonaws.com/aws-cli/AWSCLI64-1.16.14.msi)
+ [Python 3 にバンドルされた 64 ビットインストーラ](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3-1.16.14.msi)
+ [正しいバージョンを自動的にインストールする 32 ビットおよび 64 ビットのインストーラを含むセットアップファイル](https://s3.amazonaws.com/aws-cli/AWSCLISetup-1.16.14.exe)
## Snowball Edge デバイスで AWS CLI および API オペレーションを使用する
AWS CLI または API オペレーションを使用して Snowball Edge で IAM、Amazon S3、Amazon EC2 コマンドを発行する場合は、リージョンを「」として指定する必要があります`snow`。 これを行うには、次の例のように、 コマンド自体で `AWS configure`または を使用します。
```
aws configure --profile abc
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: 1234567
Default region name [None]: snow
Default output format [None]: json
```
Or
```
aws s3 ls --endpoint http://192.0.2.0:8080 --region snow --profile snowballEdge
```
### AWS Snowball Edgeの Amazon S3 API インターフェイスを使用した認可
Amazon S3 アダプターを使用する場合、すべてのインタラクションはデフォルトで AWS 署名バージョン 4 アルゴリズムで署名されます。この認可は、ソースからインターフェイスに移動するデータを検証するためにのみ使用されます。すべての暗号化と復号はデバイス上で行います。暗号化されていないデータは、デバイスに保存されません。
インターフェイスを使用する際は、次の点に注意が必要です。
+ AWS Snowball Edge デバイスへのリクエストに署名するためにローカルの Amazon S3 認証情報を取得するには、`snowballEdge list-access-keys` および `snowballEdge get-secret-access-keys` Snowball Edge クライアントコマンドを実行します。詳細については、「[Snowball Edge クライアントの設定と使用](using-client-commands.md)」を参照してください。これらのローカル Amazon S3 認証情報には、アクセスキーとシークレットキーのキーペアが含まれます。これらのキーは、ジョブに関連付けられたデバイスでのみ有効です。（ AWS Identity and Access Management IAM) カウンターパートがないため AWS クラウド 、 では使用できません。
+ 暗号化キーは、使用する AWS 認証情報によって変更されません。署名バージョン 4 のアルゴリズムを使用した署名は、ソースからインターフェイスに移動するデータを検証するためだけに使用されます。このため、この署名は Snowball でデータを暗号化するために使用される暗号化キーには関係しません。
## Snowball Edge でのローカル Amazon S3 認証情報の取得と使用
Snowball Edge とのやり取りはすべて、 AWS 署名バージョン 4 アルゴリズムで署名されます。アルゴリズムの詳細については、「AWS 全般のリファレンス**」の「[Signature Version 4 Signing Process](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html)」を参照してください。
Snowball Edge クライアントエッジデバイスに対するリクエストに署名するローカル Amazon S3 認証情報は、`snowballEdge list-access-keys` および `snowballEdge get-secret-access-key` Snowball Edge クライアント情報を実行して取得できます。[Snowball Edge の認証情報の取得](using-client-commands.md#client-credentials) を参照してください。これらのローカル Amazon S3 認証情報には、アクセスキー ID とシークレットキーのキーペアが含まれます。これらの認証情報は、ジョブに関連付けられたデバイスでのみ有効です。IAM 対応部分 AWS クラウド がないため、 では使用できません。
これらの認証情報は、サーバーの AWS 認証情報ファイルに追加できます。通常、デフォルトの認証情報プロファイルファイルは `~/.aws/credentials` にありますが、この場所はプラットフォームごとに異なる場合があります。このファイルは、多くの AWS SDKsと によって共有されます AWS CLI。ローカル認証情報は、次の例のようにプロファイル名を付けて保存できます。
```
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
### Snowball Edge の S3 アダプター AWS CLI をエンドポイントとして使用するように を設定する
を使用して AWS Snowball Edge デバイスにコマンド AWS CLI を発行する場合は、エンドポイントが Amazon S3 アダプターであることを指定します。次に示すように、HTTPS エンドポイント、またはセキュリティで保護されていない HTTP エンドポイントの使用を選択できます。
**セキュリティで保護された HTTPS エンドポイント**
```
aws s3 ls --endpoint https://192.0.2.0:8443 --ca-bundle path/to/certificate --profile snowballEdge
```
**セキュリティで保護されていない HTTP エンドポイント**
```
aws s3 ls --endpoint http://192.0.2.0:8080 --profile snowballEdge
```
`8443`の HTTPS エンドポイントを使用すると、データはサーバーから Snowball Edge に安全に転送されます。この暗号化は、新しい IP アドレスを取得する際に Snowball Edge によって生成される証明書を使用して行われます。証明書を取得したら、ローカルの `ca-bundle.pem` ファイルに保存できます。次に、以下で説明するように、証明書へのパスを含めるように AWS CLI プロファイルを設定できます。
**証明書をインターフェイスエンドポイントに関連付けるには**
1. Snowball Edge を電源とネットワークに接続し、電源を入れます。
1. デバイスの起動が終了したら、ローカルネットワークでの IP アドレスを書き留めておきます。
1. ネットワーク上のターミナルから Snowball Edge に ping を送信できることを確認します。
1. ターミナルで `snowballEdge get-certificate` コマンドを実行します。このコマンドの詳細については、「[Snowball Edge でのパブリックキー証明書の管理](snowball-edge-certificates-cli.md)」を参照してください。
1. `snowballEdge get-certificate` コマンドの出力をファイルに保存します (例: `ca-bundle.pem`)。
1. ターミナルから次のコマンドを実行します。
```
aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem
```
この手順を完了したら、次の例のように、これらのローカル認証情報、証明書、および指定されたエンドポイントを使用して CLI コマンドを実行できます。
```
aws s3 ls --endpoint https://192.0.2.0:8443 --profile snowballEdge
```
## Snowball Edge の Amazon S3 アダプターでサポートされていない Amazon S3 機能
Amazon S3 アダプターを使用して、Amazon S3 API アクションにより、Snowball Edge との間でデータをプログラムで転送できます。ただし、Amazon S3 アダプターを使用する場合、すべての Amazon S3 転送機能および API アクションが、Snowball Edge デバイスで使用できるわけではありません。例えば、以下の機能とアクションは、Snowball Edge での使用がサポートされません。
+ [TransferManager](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/examples-s3-transfermanager.html) – このユーティリティは SDK for Java を使用してローカル環境から Amazon S3 にファイルを転送します。代わりに、インターフェイスを使用して、サポートされる API アクションまたは AWS CLI コマンドを使用することを検討してください。
+ [GET Bucket (オブジェクトのリスト化) バージョン 2](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html) – この GET アクションを実装すると、バケット内の一部またはすべて (最大 1,000) のオブジェクトが返されます。[GET Bucket (List Objects) バージョン 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html) アクションまたは [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) AWS CLI コマンドを使用することを検討してください。
+ [ListBuckets](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html) – オブジェクトエンドポイントでの ListBuckets はサポートされていません。次のコマンドは、Snowball Edge の Amazon S3 互換ストレージでは機能しません。
```
aws s3 ls --endpoint https://192.0.2.0 --profile profile
```
# Snowball Edge へのデータ転送パフォーマンスを向上させるための小さなファイルのバッチ処理
各コピーオペレーションには、暗号化のために多少のオーバーヘッドがあります。小さなファイルを AWS Snowball Edge デバイスに転送するプロセスを高速化するために、それらを 1 つのアーカイブにまとめてバッチ処理できます。ファイルをバッチ処理する際に、サポートされるアーカイブ形式のいずれかでファイルがバッチ処理済みの場合は、Amazon S3 へのインポート時に自動抽出されます。
通常は、1 MB 以下のファイルがバッチ処理に含まれている必要があります。バッチ処理に含めるファイル数にハード制限はありませんが、バッチ処理に 10000 ファイルを上限とすることが推奨されます。バッチに 10 万以上のファイルがあると、デバイスに戻った後で Amazon S3 にインポートされるファイルの速度に影響します。各バッチの合計サイズは 100 GB 以下にすることをお勧めします。
ファイルのバッチ処理は手動によって管理するプロセスです。ファイルをバッチ処理したら、 `--metadata snowball-auto-extract=true`オプションを指定して コマンドを使用して AWS CLI `cp` Snowball Edge デバイスに転送します。`snowball-auto-extract=true` を指定すると、バッチ処理されたファイルのサイズが 100 GB 以下であれば、データが Amazon S3 にインポートされる際に、アーカイブファイルのコンテンツが自動的に抽出されます。
**注記**
100 GB を超えるバッチは、Amazon S3 にインポートされる際に抽出されません。
**小さなファイルのバッチ処理をするには**
1. バッチ処理をする小さなファイルの形式を決めます。自動抽出機能は、`TAR`、`ZIP`、`tar.gz` 形式でサポートされます。
1. サイズやまとめてバッチ処理するファイルの数を含め、まとめてバッチ処理する小さなファイルを特定します。
1. 次の例に示すように、コマンドラインでファイルをバッチ処理します。
+ Linux では、デバイスにファイルを転送するときに使用するのと同じコマンドラインで、ファイルのバッチ処理ができます。
```
tar -cf - /Logs/April | aws s3 cp - s3://amzn-s3-demo-bucket/batch01.tar --metadata snowball-auto-extract=true --endpoint http://192.0.2.0:8080
```
**注記**
または、任意のアーカイブユーティリティを使用して 1 つ以上の大きなアーカイブにファイルをバッチ処理することもできます。ただし、この方法では、アーカイブを Snowball Edge に転送する前に、アーカイブを保存するために追加のローカルストレージが必要です。
+ Windows では、すべてのファイルがコマンドの実行元と同じディレクトリにある場合、以下のコマンド例を使用してファイルをバッチ処理します。
```
7z a -tzip -so "test" | aws s3 cp - s3://amzn-s3-demo-bucket/batch01.zip --metadata snowball-auto-extract=true --endpoint http://192.0.2.0:8080
```
コマンドの実行元とは別のディレクトリのファイルをバッチ処理する場合は、以下のコマンド例を使用します。
```
7z a -tzip -so "test" "c:\temp" | aws s3 cp - s3://amzn-s3-demo-bucket/batch01.zip --metadata snowball-auto-extract=true --endpoint http://10.x.x.x:8080
```
**注記**
Microsoft Windows 2016の場合、Tar を利用できませんが、*Windows 用 Tar* ウェブサイトからダウンロードできます。
7 ZIP は、 7ZIP ウェブサイトからダウンロードできます。
1. Snowball Edge を使用して、Amazon S3 に転送する小さなファイルをすべてアーカイブするまで、操作を繰り返します。
1. アーカイブしたファイルを Snowball に転送します。データを自動抽出し、ステップ 1 で前述したサポートされているアーカイブ形式のいずれかを使用した場合は、 `--metadata snowball-auto-extract=true`オプションを指定して コマンドを使用します AWS CLI `cp`。
**注記**
非アーカイブファイルがある場合は、このコマンドを使用しないでください。
アーカイブファイルを作成する場合、抽出によって現在のデータ構造が維持されます。つまり、ファイルとフォルダを含むアーカイブファイルを作成すると、Snowball Edge は Amazon S3 プロセスへの取り込み中にこれを再作成します。
アーカイブファイルは、保存されているディレクトリと同じディレクトリに抽出され、それに応じてフォルダ構造が構築されます。アーカイブファイルをコピーするときは、`--metadata snowball-auto-extract=true` フラグを設定することが重要です。設定しないと、Snowball Edge は、Amazon S3 にインポートされるときにデータを抽出しません。
ファイル `a.txt`、`b.txt`、`c.txt` を含む /Logs/April/ のフォルダ構造がある場合、ステップ 3 の例を使用します。このアーカイブファイルが /amzn-s3-demo-bucket/ のルートに配置されている場合、抽出後のデータは次のようになります。
```
/amzn-s3-demo-bucket/Logs/April/a.txt
/amzn-s3-demo-bucket/Logs/April/b.txt
/amzn-s3-demo-bucket/Logs/April/c.txt
```
アーカイブファイルが /amzn-s3-demo-bucket/Test/ に配置されている場合、抽出は次のようになります。
```
/amzn-s3-demo-bucket/Test/Logs/April/a.txt
/amzn-s3-demo-bucket/Test/Logs/April/b.txt
/amzn-s3-demo-bucket/Test/Logs/April/c.txt
```
# Snowball Edge との間のデータ転送でサポートされる AWS CLI コマンド
以下は、Snowball Edge の Amazon S3 アダプターまたは Amazon S3 互換ストレージを applicable AWS Command Line Interface （AWS CLI) コマンドのエンドポイントとして指定する方法に関する情報です。また、Snowball Edge のアダプターまたは Amazon S3 互換ストレージを使用して AWS Snowball Edge デバイスへのデータ転送がサポートされている Amazon S3 の AWS CLI コマンドのリストも確認できます。
**注記**
AWS CLI 呼び出し先のリージョンの指定など AWS CLI、 のインストールと設定の詳細については、[AWS Command Line Interface 「 ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)」を参照してください。
現在、Snowball Edge デバイスは、バージョン 1.16.14 以前のみの AWS CLI で Amazon S3 アダプターの使用をサポートしています。「[Snowball Edge クライアントバージョンの検索](using-adapter.md#aws-cli-version)」を参照してください。Snowball Edge で Amazon S3 互換ストレージを使用している場合は、 の最新バージョンを使用できます AWS CLI。最新バージョンをダウンロードして使用するには、「[AWS Command Line Interface ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)」を参照してください。
**注記**
AWS CLIのバージョン 1.16.14 をインストールする前に、Python のバージョン 2.6.5\$1 または 3.4 をインストールしていることを確認してください。
## Amazon S3 と Snowball Edge を使用したデータ転送でサポートされる AWS CLI コマンド
以下は、 AWS Snowball Edge デバイスがサポートする Amazon S3 の AWS CLI コマンドとオプションのサブセットの説明です。コマンドまたはオプションが以下に一覧表示されていない場合、そのコマンドまたはオプションはサポートされません。`--sse` や `--storage-class` など、一部のサポートされていないオプションを、コマンドとともに宣言できます。ただし、それらのオプションは無視され、データのインポート方法に影響はありません。
+ [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) – ファイルまたはオブジェクトを AWS Snowball Edge デバイスとの間でコピーします。このコマンドのオプションは、次のとおりです。
+ `--dryrun` (ブール値) – 指定したコマンドによって実行されなかったオペレーションが表示されます。
+ `--quiet` (ブール値) – 指定したコマンドによって実行されたオペレーションは表示されません。
+ `--include` (文字列) – 指定したパターンと一致するファイルまたはオブジェクトをコマンドから除外しないでください。詳細については、*AWS CLI コマンドリファレンス*の [Use of Exclude and Include Filters](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) を参照してください。
+ `--exclude` (文字列) – 指定したパターンと一致するすべてのファイルまたはオブジェクトをコマンドから除外します。
+ `--follow-symlinks | --no-follow-symlinks` (ブール値) – ローカルファイルシステムから Amazon S3にアップロードする場合にのみ、シンボリックリンク (symlinks) をたどります。Amazon S3 はシンボリックリンクをサポートしないため、リンクターゲットのコンテンツはリンク名でアップロードされます。どちらのオプションも指定されていない場合、デフォルトでは、シンボリックリンクをたどります。
+ `--only-show-errors` (ブール値) – エラーと警告のみが表示されます。その他の出力は非表示になります。
+ `--recursive` (ブール値) – コマンドは、指定したディレクトリまたはプレフィックスのすべてのファイルまたはオブジェクトに対して実行されます。
+ `--page-size` (整数) – 各リスト操作に応答して返される結果の数。デフォルト値は 1000 です (許可される最大値)。オペレーションがタイムアウトする場合は、それより低い値を使用すると有効な可能性があります。
+ `--metadata` (マップ) – Amazon S3 内のオブジェクトに保存するメタデータのマップ。このマップは、このリクエストに含まれているすべてのオブジェクトに適用されます。同期では、この機能では、変更されていないファイルは新しいメタデータを受け取らないことを意味します。2 つの Amazon S3 の場所の間でコピーする際は、特に指定がない限り、`metadata-directive` の引数はデフォルトで `REPLACE` になります。
+ [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) – AWS Snowball Edge デバイス上のオブジェクトを一覧表示します。このコマンドのオプションは、次のとおりです。
+ `--human-readable` (ブール値) – ファイルサイズが、人が読み取れる形式で表示されます。
+ `--summarize` (ブール値) – 概要情報が表示されます。この情報は、オブジェクトの数とその合計サイズです。
+ `--recursive` (ブール値) – コマンドは、指定したディレクトリまたはプレフィックスのすべてのファイルまたはオブジェクトに対して実行されます。
+ `--page-size` (整数) – 各リスト操作に応答して返される結果の数。デフォルト値は 1000 です (許可される最大値)。オペレーションがタイムアウトする場合は、それより低い値を使用すると有効な可能性があります。
+ [rm](https://docs.aws.amazon.com/cli/latest/reference/s3/rm.html) – AWS Snowball Edge デバイス上のオブジェクトを削除します。このコマンドのオプションは、次のとおりです。
+ `--dryrun` (ブール値) – 指定したコマンドによって実行されなかったオペレーションが表示されます。
+ `--include` (文字列) – 指定したパターンと一致するファイルまたはオブジェクトをコマンドから除外しないでください。詳細については、*AWS CLI コマンドリファレンス*の [Use of Exclude and Include Filters](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) を参照してください。
+ `--exclude` (文字列) – 指定したパターンと一致するすべてのファイルまたはオブジェクトをコマンドから除外します。
+ `--recursive` (ブール値) – コマンドは、指定したディレクトリまたはプレフィックスのすべてのファイルまたはオブジェクトに対して実行されます。
+ `--page-size` (整数) – 各リスト操作に応答して返される結果の数。デフォルト値は 1000 です (許可される最大値)。オペレーションがタイムアウトする場合は、それより低い値を使用すると有効な可能性があります。
+ `--only-show-errors` (ブール値) – エラーと警告のみが表示されます。その他の出力は非表示になります。
+ `--quiet` (ブール値) – 指定したコマンドによって実行されたオペレーションは表示されません。
+ [sync](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html) – ディレクトリとプレフィックスを同期します。このコマンドは、新しいファイルおよび更新されたファイルを送信元ディレクトリから送信先にコピーします。このコマンドが送信先にディレクトリを作成するのは、ファイルが 1 つ以上含まれる場合に限られます。
**重要**
1 つのディレクトリから同じ Snowball Edge の別のディレクトリへの同期はサポートされません。
ある AWS Snowball Edge デバイスから別の AWS Snowball Edge デバイスへの同期はサポートされていません。
このオプションは、オンプレミスのデータストレージと Snowball Edge の間でコンテンツを同期する場合にのみ使用できます。
+ `--dryrun` (ブール値) – 指定したコマンドによって実行されなかったオペレーションが表示されます。
+ `--quiet` (ブール値) – 指定したコマンドによって実行されたオペレーションは表示されません。
+ `--include` (文字列) – 指定したパターンと一致するファイルまたはオブジェクトをコマンドから除外しないでください。詳細については、*AWS CLI コマンドリファレンス*の [Use of Exclude and Include Filters](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) を参照してください。
+ `--exclude` (文字列) – 指定したパターンと一致するすべてのファイルまたはオブジェクトをコマンドから除外します。
+ `--follow-symlinks` または `--no-follow-symlinks` (ブール値) – ローカルファイルシステムから Amazon S3にアップロードする場合にのみ、シンボリックリンク (symlinks) をたどります。Amazon S3 はシンボリックリンクをサポートしないため、リンクターゲットのコンテンツはリンク名でアップロードされます。どちらのオプションも指定されていない場合、デフォルトでは、シンボリックリンクをたどります。
+ `--only-show-errors` (ブール値) – エラーと警告のみが表示されます。その他の出力は非表示になります。
+ `--no-progress` (ブール値) – ファイル転送の進行状況は表示されません。このオプションは､`--quiet` オプションと `--only-show-errors` オプションが指定されていない場合にのみ適用されます。
+ `--page-size` (整数) – 各リスト操作に応答して返される結果の数。デフォルト値は 1000 です (許可される最大値)。オペレーションがタイムアウトする場合は、それより低い値を使用すると有効な可能性があります。
+ `--metadata` (マップ) – Amazon S3 内のオブジェクトに保存するメタデータのマップ。このマップは、このリクエストに含まれているすべてのオブジェクトに適用されます。同期では、この機能では、変更されていないファイルは新しいメタデータを受け取らないことを意味します。2 つの Amazon S3 の場所の間でコピーする際は、特に指定がない限り、`metadata-directive` の引数はデフォルトで `REPLACE` になります。
**重要**
1 つのディレクトリから同じ Snowball Edge の別のディレクトリへの同期はサポートされません。
ある AWS Snowball Edge デバイスから別の AWS Snowball Edge デバイスへの同期はサポートされていません。
このオプションは、オンプレミスのデータストレージと Snowball Edge の間でコンテンツを同期する場合にのみ使用できます。
+ `--size-only` (ブール値) – このオプションにより、各キーのサイズだけを基準として、送信元から送信先へ同期するかどうかが決定されます。
+ `--exact-timestamps` (ブール値) – Amazon S3 からローカルストレージに同期する際、タイムスタンプが完全に一致する場合にのみ、同サイズの項目が無視されます。デフォルトの動作では、ローカルバージョンが Amazon S3 バージョンより新しい場合を除き、同サイズの項目が無視されます。
+ `--delete` (ブール値) – 送信先だけに存在し、送信元には存在しないファイルが、同期中に削除されます。
ファイルまたはフォルダは、「`my photo.jpg`」や「`My Documents`」のように名前にスペースを含めて使用できます。ただし、 AWS CLI コマンドでスペースを適切に処理してください。詳細については、*AWS Command Line Interface ユーザーガイド*の[AWS CLIのパラメータ値の指定](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html)を参照してください。
# Snowball Edge でのデータ転送でサポートされている 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)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/sig-v4-authenticating-requests.html)」を参照してください。
+ [GET Bucket (オブジェクトのリスト化) バージョン 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html)は、サポートされます。ただし、この GET オペレーションの実装では、以下はサポートされません。
+ Pagination (ページ分割)
+ マーカー
+ 区切り記号
+ リストが返される際、リストはソートされません。
Version 1 のみがサポートされます。GET Bucket (List Objects) version 2 はサポートされません。
+ [GET Service](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTServiceGET.html)
+ [HEAD Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketHEAD.html)
+ [HEAD Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html)
+ [GET Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html) – Snow デバイスの S3 バケットからオブジェクトをダウンロードします。
+ [PUT Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html) – オブジェクトが を使用して AWS Snowball Edge デバイスにアップロードされると`PUT Object`、ETag が生成されます。
ETag は、オブジェクトのハッシュです。ETag は、オブジェクトのコンテンツに加えた変更のみを反映し、メタデータに加えた変更は反映しません。ETag は、オブジェクトデータの MD5 ダイジェストである場合と、そうでない場合があります。ETags の詳細については、*Amazon Simple Storage Service API リファレンス*の[共通の応答ヘッダー](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonResponseHeaders.html)を参照してください。
+ [DELETE Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html)
+ [マルチパートアップロードの開始](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadInitiate.html) – この実装では、 AWS Snowball Edge デバイスに既にあるオブジェクトに対してマルチパートアップロードリクエストを開始すると、まずそのオブジェクトが削除されます。次に、デバイスを部分的にコピーします AWS Snowball Edge 。
+ [マルチパートアップロードのリスト](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadListMPUpload.html)
+ [Upload Part](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadUploadPart.html)
+ [Complete Multipart Upload](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadComplete.html)
+ [マルチパートアップロードの中止](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadAbort.html)
**注記**
ここに記載されていない Amazon S3 アダプター REST API アクションはサポートされません。サポートされていない REST API アクションを Snowball Edge で使用すると、アクションがサポートされていないことを示すエラーメッセージが返されます。