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 の取得」をご参照ください。
    • --addr=domain_name：オプション。 このパラメーターには、オブジェクトのダウンロード時に ping するドメイン名または IP アドレスを指定します。 このパラメーターが指定されていない場合、ping 操作は実行されません。
      • --addr= オプションがデフォルト値に設定されている場合、www.aliyun.com に対して ping が実行されます。
      • --addr= オプションがドメイン名または IP アドレスに設定されている場合、指定されたドメイン名または IP アドレスに対して ping が実行されます。
    • file_name：オプション。 このパラメーターには、ダウンロードしたオブジェクトを保存するファイルパスを指定します。 file_name が指定されていない場合、ossutil はダウンロードしたオブジェクトを現在のディレクトリに保存し、オブジェクト名を決定します。 file_name を使用してオブジェクト名やディレクトリ名を指定する場合、ossutil は指定された file_name 値を使用して、ダウンロードしたオブジェクトに名前を付けるか、ダウンロードしたオブジェクトを file_name で指定したディレクトリに保存します。
  • バケットからオブジェクトをダウンロードし、トラブルシューティングレポートを生成する 
    ./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。 有効値：
  • normal
  • append
  • multipart
--upload オブジェクトを OSS にアップロードします。
--download OSS からオブジェクトをダウンロードします。
--loglevel ログレベルを指定します。 デフォルト値は null で、ログファイルが生成されないことを示します。 有効値：
  • info：プロンプトログを生成します。
  • debug：対応する HTTP リクエストとレスポンス情報を含む詳細なログを生成します。
--proxy-host プロキシサーバーの URL を指定します。 HTTP、HTTPS、SOCKS5 がサポートされています。 URL の例：http://120.79.**.**:3128 や socks5://120.79.**.**:1080 など。
--proxy-user プロキシサーバーのユーザー名を指定します。 デフォルト値は null です。
--proxy-pwd プロキシサーバーのパスワードを指定します。 デフォルト値は null です。
注 一般的なオプションの詳細は、「サポートされているすべてのオプションの表示」をご参照ください。