probe コマンドは、OSS へのアクセスをモニタリングし、アップロードプロセスやダウンロードプロセス中にネットワーク障害や不適切なパラメーター設定によって発生した問題をトラブルシューティングする場合に使用します。
コマンド構文
- オブジェクトの URL を使用してバケットからローカルデバイスにオブジェクトをダウンロードし、トラブルシューティングレポートを生成する
./ossutil probe --download --url http_url [--addr=domain_name] [file_name]
オブジェクトの URL を使用してオブジェクトをバケットからローカルデバイスにダウンロードした後、ネットワーク伝送品質をテストし、トラブルシューティングレポートを生成できます。- --url:特定のバケット内のオブジェクトの URL を指定します。
- オブジェクトの ACL が公開読み取り/書き込みの場合、URL は署名を含みません。 例:
https://bucketname.oss-cn-beijing.aliyuncs.com/myphoto.jpg
- オブジェクトの ACL が非公開の場合、URL は署名を含み、先頭と末尾は二重引用符 (") です。 例:
“https://bucketname.oss-cn-beijing.aliyuncs.com/myphoto.jpg?Expires=1552015472&OSSAccessKeyId=TMP.xxxxxxxx5r9f1FV12y8_Qis6LUVmvoSCUSs7aboCCHtydQ0axN32Sn-UvyY3AAAwLAIUarYNLcO87AKMEcE5O3AxxxxxxoCFAQuRdZYyVFyqOW8QkGAN-bamUiQ&Signature=bIa4llbMbldrl7rwckr%2FXXvTtxw%3D”
注 オブジェクトの URL を取得する方法の詳細は、「URL の取得」をご参照ください。 - オブジェクトの ACL が公開読み取り/書き込みの場合、URL は署名を含みません。 例:
- --addr=domain_name:オプション。 このパラメーターには、オブジェクトのダウンロード時に ping するドメイン名または IP アドレスを指定します。 このパラメーターが指定されていない場合、ping
操作は実行されません。
- --addr= オプションがデフォルト値に設定されている場合、
www.aliyun.com
に対して ping が実行されます。 - --addr= オプションがドメイン名または IP アドレスに設定されている場合、指定されたドメイン名または IP アドレスに対して ping が実行されます。
- --addr= オプションがデフォルト値に設定されている場合、
- file_name:オプション。 このパラメーターには、ダウンロードしたオブジェクトを保存するファイルパスを指定します。 file_name が指定されていない場合、ossutil はダウンロードしたオブジェクトを現在のディレクトリに保存し、オブジェクト名を決定します。 file_name を使用してオブジェクト名やディレクトリ名を指定する場合、ossutil は指定された file_name 値を使用して、ダウンロードしたオブジェクトに名前を付けるか、ダウンロードしたオブジェクトを file_name で指定したディレクトリに保存します。
- --url:特定のバケット内のオブジェクトの URL を指定します。
- バケットからオブジェクトをダウンロードし、トラブルシューティングレポートを生成する
./ossutil probe --download --bucketname bucket-name [--object=object_name] [--addr=domain_name] [file_name]
- --bucketname:ダウンロードするオブジェクトを含むバケットの名前を指定します。
- --object=:オプション。 このパラメーターには、ダウンロードしたオブジェクトを保存するファイルパスを指定します。 例:path/myphoto.jpg。 --object= が指定されていない場合、ossutil は一時オブジェクトを生成し、bucket-name パラメーターで指定されたバケットにアップロードした後でダウンロードします。 このオブジェクトがダウンロードされた後、ossutil はこのオブジェクトをローカルデバイスとバケットから削除します。
- オブジェクトをアップロードしてトラブルシューティングレポートを生成する
./ossutil probe --upload [file_name] --bucketname bucket-name [--object=obj ect_name] [--addr=domain_name] [--upmode]
- file_name:オプション。 このパラメーターには、bucket-name パラメーターで指定されたバケットにアップロードするオブジェクトの名前を指定します。 file_name が指定されていない場合、ossutil は一時オブジェクトを生成し、指定されたバケットにアップロードします。 probe の完了後、この一時オブジェクトは削除されます。
- --object=:オプション。 このパラメータには、オブジェクトまたはディレクトリの名前を指定します。 例:path/myphoto.jpg。 --object= が指定されていない場合、ossutil はアップロードされたオブジェクトの名前を生成します。 probe の完了後、このオブジェクトは削除されます。
- --upmode:オプション。 このパラメーターには、アップロード方法を指定します。 デフォルト値:normal。 有効値:
- normal
- append
- multipart
例
- オブジェクトの URL を使用してバケットからローカルデバイスにオブジェクトをダウンロードし、トラブルシューティングレポートを生成する
./ossutil probe --download --url https://bucket1.oss-cn-beijing.aliyuncs.com/myphoto.jpg --addr=www.aliyun.com /file/myphoto.jpg
- バケットからオブジェクトをダウンロードし、トラブルシューティングレポートを生成する
./ossutil probe --download --bucketname bucket1 --object=myphoto.jpg --addr=www.aliyun.com /file/myphoto.jpg
- アップロード結果を確認し、トラブルシューティングレポートを生成する
./ossutil probe --upload /file/myphoto.jpg --bucketname bucket1 --object=myphoto.jpg --upmode normal
トラブルシューティングレポートの表示
probe コマンドの実行後、各タスクの実行手順と、アップロードまたはダウンロードの全体的な結果を表示できます。
- 手順の後に × が表示されている場合、操作は失敗しています。
- 手順の後に × が表示されていない場合、操作は成功しています。 アップロードまたはダウンロードが成功した場合、オブジェクトのサイズと、オブジェクトのアップロード時刻またはダウンロード時刻が表示されます。
アップロードまたはダウンロードが失敗した場合、失敗の原因やトラブルシューティングのアドバイスが表示されます。
注 エラーの数が少ない場合、トラブルシューティングのアドバイスが生成されないことがあります。 この場合、OSS エラーコードの説明に従って、エラーコードに応じて問題をトラブルシューティングできます。
probe コマンドの実行後、名前の先頭が logOssProbe で始まるオブジェクトが現在のディレクトリに生成されます。 このオブジェクトには、問題をトラブルシューティングするために実行したコマンドの詳細が含まれています。
一般的なオプション
次の表に、probe コマンドに追加できるオプションを示します。
オプション | 説明 |
---|---|
--url | オブジェクトのネットワークアドレスを指定します。 ossutil はこのアドレスを使用してオブジェクトをダウンロードします。 |
--bucketname | OSS のバケットの名前を指定します。 |
--object | OSS のオブジェクトの名前を指定します。 |
--addr | ping するドメイン名を指定します。 デフォルト値:www.aliyun.com 。
|
--upmode | アップロード方法を指定します。 デフォルト値:normal。 有効値:
|
--upload | オブジェクトを OSS にアップロードします。 |
--download | OSS からオブジェクトをダウンロードします。 |
--loglevel | ログレベルを指定します。 デフォルト値は null で、ログファイルが生成されないことを示します。 有効値:
|
--proxy-host | プロキシサーバーの URL を指定します。 HTTP、HTTPS、SOCKS5 がサポートされています。 URL の例:http://120.79.**.**:3128 や socks5://120.79.**.**:1080 など。 |
--proxy-user | プロキシサーバーのユーザー名を指定します。 デフォルト値は null です。 |
--proxy-pwd | プロキシサーバーのパスワードを指定します。 デフォルト値は null です。 |
注 一般的なオプションの詳細は、「サポートされているすべてのオプションの表示」をご参照ください。