Snowball Edge との間のデータ転送でサポートされる AWS CLI コマンド

フォーカスモード

Snowball Edge との間のデータ転送でサポートされる AWS CLI コマンド - AWS Snowball Edge デベロッパーガイド

以下は、 applicable AWS Command Line Interface （AWS CLI) コマンドのエンドポイントとして Snowball Edge で Amazon S3 アダプターまたは Amazon S3 互換ストレージを指定する方法に関する情報です。Snowball Edge のアダプターまたは Amazon S3 互換ストレージを使用して AWS Snowball Edge デバイスへのデータ転送がサポートされている Amazon S3 の AWS CLI コマンドのリストも確認できます。

注記

AWS CLI 呼び出し先のリージョンの指定など AWS CLI、のインストールと設定の詳細については、AWS Command Line Interface 「ユーザーガイド」を参照してください。

現在、Snowball Edge デバイスは、バージョン 1.16.14 以前のみの AWS CLI で Amazon S3 アダプターの使用をサポートしています。「Snowball Edge クライアントバージョンの検索」を参照してください。Snowball Edge で Amazon S3 互換ストレージを使用している場合は、の最新バージョンを使用できます AWS CLI。最新バージョンをダウンロードして使用するには、「AWS Command Line Interface ユーザーガイド」を参照してください。

注記

AWS CLIのバージョン 1.16.14 をインストールする前に、Python のバージョン 2.6.5+ または 3.4 をインストールしていることを確認してください。

Amazon S3 と Snowball Edge を使用したデータ転送でサポートされる AWS CLI コマンド

以下は、 AWS Snowball Edge デバイスがサポートする Amazon S3 の AWS CLI コマンドとオプションのサブセットの説明です。コマンドまたはオプションが以下に一覧表示されていない場合、そのコマンドまたはオプションはサポートされません。--sse や --storage-class など、一部のサポートされていないオプションを、コマンドとともに宣言できます。ただし、それらのオプションは無視され、データのインポート方法に影響はありません。

cp – ファイルまたはオブジェクトを AWS Snowball Edge デバイスとの間でコピーします。このコマンドのオプションは、次のとおりです。
- --dryrun (ブール値) – 指定したコマンドによって実行されなかったオペレーションが表示されます。
- --quiet (ブール値) – 指定したコマンドによって実行されたオペレーションは表示されません。
- --include (文字列) – 指定したパターンと一致するファイルまたはオブジェクトをコマンドから除外しないでください。詳細については、AWS CLI コマンドリファレンスの 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 – AWS Snowball Edge デバイス上のオブジェクトを一覧表示します。このコマンドのオプションは、次のとおりです。
- --human-readable (ブール値) – ファイルサイズが、人が読み取れる形式で表示されます。
- --summarize (ブール値) – 概要情報が表示されます。この情報は、オブジェクトの数とその合計サイズです。
- --recursive (ブール値) – コマンドは、指定したディレクトリまたはプレフィックスのすべてのファイルまたはオブジェクトに対して実行されます。
- --page-size (整数) – 各リスト操作に応答して返される結果の数。デフォルト値は 1000 です (許可される最大値)。オペレーションがタイムアウトする場合は、それより低い値を使用すると有効な可能性があります。
rm – AWS Snowball Edge デバイス上のオブジェクトを削除します。このコマンドのオプションは、次のとおりです。
- --dryrun (ブール値) – 指定したコマンドによって実行されなかったオペレーションが表示されます。
- --include (文字列) – 指定したパターンと一致するファイルまたはオブジェクトをコマンドから除外しないでください。詳細については、AWS CLI コマンドリファレンスの Use of Exclude and Include Filters を参照してください。
- --exclude (文字列) – 指定したパターンと一致するすべてのファイルまたはオブジェクトをコマンドから除外します。
- --recursive (ブール値) – コマンドは、指定したディレクトリまたはプレフィックスのすべてのファイルまたはオブジェクトに対して実行されます。
- --page-size (整数) – 各リスト操作に応答して返される結果の数。デフォルト値は 1000 です (許可される最大値)。オペレーションがタイムアウトする場合は、それより低い値を使用すると有効な可能性があります。
- --only-show-errors (ブール値) – エラーと警告のみが表示されます。その他の出力は非表示になります。
- --quiet (ブール値) – 指定したコマンドによって実行されたオペレーションは表示されません。
sync – ディレクトリとプレフィックスを同期します。このコマンドは、新しいファイルおよび更新されたファイルを送信元ディレクトリから送信先にコピーします。このコマンドが送信先にディレクトリを作成するのは、ファイルが 1 つ以上含まれる場合に限られます。

重要
1 つのディレクトリから同じ Snowball Edge の別のディレクトリへの同期はサポートされません。
ある AWS Snowball Edge デバイスから別の AWS Snowball Edge デバイスへの同期はサポートされていません。
このオプションは、オンプレミスのデータストレージと Snowball Edge の間でコンテンツを同期する場合にのみ使用できます。
- --dryrun (ブール値) – 指定したコマンドによって実行されなかったオペレーションが表示されます。
- --quiet (ブール値) – 指定したコマンドによって実行されたオペレーションは表示されません。
- --include (文字列) – 指定したパターンと一致するファイルまたはオブジェクトをコマンドから除外しないでください。詳細については、AWS CLI コマンドリファレンスの 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のパラメータ値の指定を参照してください。