Snowball クライアントのコマンド

以下は、Amazon Simple Storage Service (Amazon S3) へのデータ転送を管理する上で役に立つその他の Snowball クライアント コマンドに関する情報です。単一の Snowball に接続した Snowball クライアント の複数のインスタンスを別々のターミナルウィンドウで実行できます。

データ転送中に、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 -m Path/to/manifest/file -u 29 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/