このガイドはまもなく廃止される予定で、更新はされません。
今後は、第 1 世代の 80 TB Snowball デバイスはご使用いただけません。すべてのデータ転送ジョブで Snowball Edge Storage Optimized デバイスを使用します。Snowball Edge のドキュメントについては、AWS Snowball Edgeデベロッパーガイド。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Snowball クライアントのコマンド
ここでは、Amazon Simple Storage Service (Amazon S3) へのデータ転送を管理する際に役立つ、Snowball クライアントのコマンドについて説明します。単一の Snowball に接続された別々のターミナルウィンドウで、Snowball クライアントの複数のインスタンスを実行できます。
トピック
- Snowball クライアントの Copy コマンド
- Snowball クライアントの List コマンド
- Snowball クライアントの Make Directory コマンド
- Snowball クライアントの Retry コマンド
- Snowball クライアントの Remove コマンド
- Snowball クライアントの Start コマンド
- Snowball クライアントの Status コマンド
- Snowball クライアントの Stop コマンド
- Snowball クライアントの Test コマンド
- Snowball クライアントの Validate コマンド
- Snowball クライアントの Version コマンド
- 詳細なオプションの使用
データ転送中は、Snowball のルートレベルに 1 つ以上のフォルダが表示されます。このフォルダやこのレベルにある他のものは、このジョブを作成したときに選択した Amazon S3 バケットと同じ名前になります。Snowball のルートレベルにデータを書き込むことはできません。すべてのデータは、いずれかのバケットフォルダまたはそのサブフォルダに書き込む必要があります。
ファイルまたはフォルダは、「my
photo.jpg
」や「My Documents
」のように名前にスペースを含めて使用できます。ただし、クライアントのコマンドでは適切にスペースを処理していることを確かめます。詳細については、次の例を参照してください。
-
Linux および Mac バージョンのクライアント –
snowball ls s3://mybucket/My\ Folder/my\ photo.jpg
-
Windows バージョンのクライアント –
snowball ls "s3://mybucket/My Documents/my photo.jpg"
Snowball を使用して Amazon S3 にデータを転送する前に、転送するファイルやフォルダが、Amazon S3 のオブジェクトキーの命名のガイドラインに従って命名されていることを確認します。
Snowball クライアントの使用中に問題が発生したときは、標準 Snowball のトラブルシューティング を参照してください。
Snowball クライアントの Copy コマンド
snowball cp
コマンドは、Snowball とデータソースの間でファイルやフォルダをコピーします。Snowball コピーコマンド (snowball cp
) のオプションの詳細については、snowball cp コマンドのオプション を参照してください。Snowball クライアントを使ったデータ転送では、コマンドオプションに加え、転送するデータの種類を定義するスキーマもサポートされます。スキーマの詳細については、「Snowball クライアントのスキーマ」を参照してください。
使用方法
snowball cp [OPTION...] SRC... s3://
DEST
インポートの例
snowball cp --recursive /Logs/April s3://MyBucket/Logs
snowball cp -r /Logs/April s3://MyBucket/Logs
エクスポートの例
snowball cp --recursive s3://MyBucket/Logs/ /Logs/April
snowball cp -r s3://MyBucket/Logs/ /Logs/April
Snowball コピーコマンド (snowball cp
) のオプションの詳細については、snowball cp コマンドのオプション を参照してください。
Snowball クライアントの List コマンド
snowball ls
コマンドは、指定されたパスにある Snowball コンテンツの一覧を表示します。このコマンドでワークステーション、データソース、その他 Snowball 外のネットワークロケーションのコンテンツをリストすることはできません。
使用方法
snowball ls [OPTION...] s3://
DEST
例
snowball ls s3://MyBucket/Logs/April
Snowball クライアントの Make Directory コマンド
snowball mkdir
コマンドは、Snowball に新規サブフォルダを作成します。ルートレベルで新しいフォルダを作成することはできません。ルートレベルはバケットフォルダ用に予約されています。
使用方法
snowball mkdir [OPTION...] s3://
DEST
例
snowball mkdir s3://MyBucket/Logs/April/ExpenseReports
Snowball クライアントの Retry コマンド
snowball retry
コマンドは、最後に snowball cp
を実行したときにコピーされなかったすべてのファイルに対して snowball cp
コマンドを再実行します。コピーされていないファイルのリストは、プレーンテキストログでワークステーションの一時ディレクトリに保存されています。snowball cp
コマンドがファイルのコピーに失敗した場合は、そのログへの完全パスがターミナルに表示されます。
使用例
snowball retry
Snowball クライアントの Remove コマンド
snowball rm
コマンドは、Snowball にあるファイルとフォルダを削除します。デバイス上にあるものをすべて削除する snowball rm -r
など、多数のファイルまたはディレクトリを削除するためにこのオペレーションを実行すると、完了までに時間がかかることがあります。その後で snowball ls
コマンドを実行すると、削除が完了したときにデバイスの状態が表示されます。
ただし、snowball status
コマンドによって報告されるストレージ量は、snowball rm
コマンドが発行される前の残りストレージ量が表示されることがあります。この場合は、1 時間ほどで snowball status
コマンドを試行して新しい残りのストレージの値を確認してください。
使用方法
snowball rm [OPTION...] s3://
DEST
例
snowball rm --recursive s3://MyBucket/Logs/April
snowball rm -r s3://MyBucket/Logs/April
Snowball クライアントの Start コマンド
snowball start
コマンドは、Snowball の IP アドレスとお客様の認証情報を使用して、Snowball へのアクセスを認証します。snowball
start
コマンドを実行すると、snowball cp
コマンドを何度でも実行できるようになります。
使用方法
snowball start -i
IP Address
-mPath/to/manifest/file
-u29 character unlock code
例
snowball start -i 192.0.2.0 -m /user/tmp/manifest -u 01234-abcde-01234-ABCDE-01234
Snowball クライアントの Status コマンド
snowball status
コマンドは、Snowball のステータスを返します。
使用例
snowball status
出力例
Snowball Status: SUCCESS S3 Endpoint running at: http://192.0.2.0:8080 Total Size: 72 TB Free Space: 64 TB
Snowball クライアントの Stop コマンド
snowball stop
コマンドは、Snowball クライアントの現在のインスタンスから Snowball への通信を停止します。
このコマンドは、データソースサーバーと Snowball との間の、他のすべてのコマンドが停止していることを確認するときに使用します。単一の Snowball に接続されたクライアントに複数のインスタンスが存在する場合は、データの転送を停止する準備ができた後に、各インスタンスでこのコマンドを使用します。このコマンドを実行して、別のインスタンスでデータをコピーしながら、1 つのインスタンスを停止できます。
使用例
snowball stop
Snowball クライアントの Test コマンド
snowball test
コマンドは、データ転送を開始する前にテストします。詳細については、「Snowball クライアントを使用したデータ転送のテスト」を参照してください。
使用例
snowball test
Snowball クライアントの Validate コマンド
パスを指定しない限り、snowball validate
コマンドは、Snowball 上のオブジェクトのすべてのメタデータと転送ステータスを確認します。パスを指定した場合は、そのパスが指しているコンテンツとそのサブディレクトリを検証します。このコマンドは、現在転送プロセスの途中にあるファイルを、転送ステータスが未完了であるファイルとしてリストします。
これをインポートジョブで行うと、コンテンツは問題なく AWS 内にインポートされます。
このコマンドは、完了するまで時間がかかる場合があり、場合によっては、スタックのように見えることがあります。ファイルが多数ある場合や、多数のフォルダ内で入れ子構造になっている場合、この影響はさらに大きくなります。このコマンドは、verbose
オプションを指定して実行することをお勧めします。
使用例
snowball -v validate
Snowball クライアントの Version コマンド
snowball version
コマンドは、ターミナルに Snowball クライアントのバージョンを表示します。
使用例
snowball version
詳細なオプションの使用
Snowball クライアントコマンドを実行する度に、verbose
オプションを使用して追加情報を確認できます。この追加情報は、コマンドの実行中にターミナルに表示されます。
verbose
オプションは、各コマンドの実行内容を把握するのに役立ちます。また、Snowball クライアントで発生する可能性のある問題をトラブルシューティングしやすくなります。
verbose オプションはデフォルトでオフになっています。次の例のように、コマンドの実行中にこのオプションを指定してオンにすることができます。
snowball -v cp /Logs/April/logs1.csv s3://MyBucket/Logs/April/logs1.csv
snowball --verbose ls s3://MyBucket/Logs/April/