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/