文档中心

bcecmd 使用多层命令结构， 所有命令都以 bcecmd 开头，您可以用如下命令来使用 BOSProbe 提供的上传和下载检测功能：

$ bcecmd bosprobe <command> [options]

参数解释

命令输出

• 网络检测结果；
• 上传检测结果；
• 错误信息；
• 建议；
• 检测报告保存地址。

上传检测

描述： 上传检测用于检测和收集上传过程中遇到的错误和收集网络信息，并生成报告和错误信息提示。上传的文件可以是BOSProbe生成的一个大小为1M的随机文件，也可以是您手动指定的随意大小的文件。

命令格式:

bcecmd bosprobe upload -b <bucket> [-a <ak>] [-s <sk>] [-f local-path] [-o object] [-e endpoint]

说明：

• -b 上传到指定的bucket （必需指定）;
• -a 您使用的AK （bucket 为公共写时无需指定，非必需）;
• -s 您使用的SK （bucket 为公共写时无需指定，非必需）;
• -f 要上传的文档的路径, 如果为空，bosprobe则随机生成的文件;
• -o 指定上传的文件在bucket中存储的名称，如果为空，则为本地文件名;
• -e endpoint， 如果您指定了endpoint， 则上传数据到此endpoint 如果没指定，则根据bucket name推导出endpoint。

注意：

• 如果Bucket不是公共读写，执行命令时请指定AK/SK。

示例：

• 1.随机生成文件上传到指定endpoint

  操作示例： bcecmd bosprobe upload –a 123 –s 456 –b mybucket -e su.bcebos.com

• 2.随机生成文件上传到指定ip

  操作示例： bcecmd bosprobe upload -a 123 -s 456 -b mybucket -e 123.234.1.233

• 3.上传指定文件

  操作示例： bcecmd bosprobe upload –a 123 –s 456 –b mybucket –f ./file -o filename -e su.bcebos.com

检测结果示例

• 1.上传成功

  网络检测中.... [网络良好]
  上传检测中.... [上传成功]
  
  ************************* 上传 **************************
  OBJECT NAME:    probe20171219210323660.temp
  FILE SIZE  :    1048576
  USED TIME  :    316 ms
  SPEED      :    3.16 MB/s
  
  ************************* 建    议 **************************
  测试通过
  
  如果提示没能解决问题，您也可以在百度智能云的管理控制台创建工单，将BOSProbe生成的日志文件(如果未能够生成日志文件，
  请将BosProbe的所有输出信息复制到本地文件)反馈给我们，我们会尽快处理！
  
  此次测试的日志保存于: /home/xxxx/bosprobe2017-xx-xx_xx_xx_xx_89568.log

• 2.上传失败

  网络检测中.... [网络良好]
  上传检测中.... [上传失败]
  
  ************************* 错误信息 **************************
  ERROR CODE: NoSuchBucket
  ERROR MSG : [Code: NoSuchBucket; Message: The specified bucket does not exist.; RequestId: xxx]
  
  ************************* 建    议 **************************
  请检查您指定的 bucket 是否存在，如果存在，请您确认bucket name是否拼写正确、endpoint是否正确!
  
  如果提示没能解决问题，您也可以在百度智能云的管理控制台创建工单，将BOSProbe生成的日志文件(如果未能够生成日志文件，
  请将BosProbe的所有输出信息复制到本地文件)反馈给我们，我们会尽快处理！
  
  此次测试的日志保存于: /home/xxxx/bosprobe2017-xx-xx_xx_xx_xx_9729.log

说明：

• 错误原因不同错误信息和建议会不同；
• 您可以根据检测结果中的建议来解决上传错误，如果给出的建议不能解决您的问题，您可以在百度智能云的管理控制台创建工单，并将BOSProbe生成的报告文件(如果未能够生成报告文件，请将BosProbe的所有输出信息复制到本地文件)反馈给我们，我们会尽快处理！

下载检测

描述：

下载检测用于检测和收集下载过程中遇到的错误和网络信息。下载检测时，您可以指定要下载的 object 名， 也可以不指定（如果不指定，BOSProbe将选择bucket中的第一个 object 用于下载测试）。

命令格式:

bcecmd bosprobe download [-a <ak>] [-s <sk>] [-f url] [-b bucket] [-o object] [-t to] [-e endpoint]

说明：

• -a 当前操作用户AK （bucket 为公共写和使用url下载测试时无需指定，非必需）；
• -s 当前操作用户SK （bucket 为公共写和使用url下载测试时无需指定，非必需）；
• -f object的url, 测试url下载时为必需；
• -b 要下载的文件所在的Bucket （测试url下载测试时非必需，非url下载测试时必需）；
• -o 要下载的object的名称 (非必需)；
• -t 文件保存的local地址 （非必需）；
• -e endpoint （非必需）。

注意：

• 不能即指定url又指定bucket 或object， 即 -f 不能与 -b -o 同时使用；
• 测试url下载时不需要指定 endpoint， 即 -e 不能与 -f一起使用。

示例：

• 1.url下载测试

  操作示例：bcecmd bosprobe download -f http://bj.bcebos.com/mybucket/file1.txt 操作示例：bcecmd bosprobe download –f http://bj.bcebos.com/mybucket/file1.txt -t ./tmp/example.txt`

• 2.从指定bucket随机下载测试

  操作示例： bcecmd bosprobe download –a 123 –s 456 –b mybucket

• 3.下载指定object 操作示例: bcecmd bosprobe download –a 123 –s 456 –b mybucket –o file1.txt

• 4.下载指定object到本地指定位

  操作示例: bcecmd bosprobe download –a 123 –s 456 –b mybucket –o file1.txt –t ./tmp/example.txt

检测结果示例

• 1.下载成功

  网络检测中.... [网络良好]
  下载检测中.... [下载成功]
  
  ************************* 下载 **************************
      OBJECT NAME:    file1.txt
      FILE SIZE  :    555
      USED TIME  :    144 ms
      SPEED      :    0.00 MB/s
  
  ************************* 建    议 **************************
  测试通过
  
  如果提示没能解决问题，您也可以在百度智能云的管理控制台创建工单，将BOSProbe生成的日志文件(如果未能够生成日志文件，
  请将BosProbe的所有输出信息复制到本地文件)反馈给我们，我们会尽快处理！
  
  此次测试的日志保存于: /home/xxxx/bosprobe2017-xx-xx_xx_xx_xx_84579.log

• 2.下载失败

  网络检测中.... [网络良好]
  下载检测中.... [下载失败]
  
  ************************* 错误信息 **************************
      ERROR CODE: NoSuchKey
      ERROR MSG : [Code: NoSuchKey; Message: The specified key does not exist.; RequestId: xxx]
  
  ************************* 建    议 **************************
  您指定的object在BOS中不存在， 请您检查object name是否拼写正确! 如果指定的 object key 为目录， 
  请给object key 加上后缀 "/"。
  
  如果提示没能解决问题，您也可以在百度智能云的管理控制台创建工单，将BOSProbe生成的日志文件(如果未能够生成日志文件，
  请将BosProbe的所有输出信息复制到本地文件)反馈给我们，我们会尽快处理！
  
  此次测试的日志保存于: /home/xxxx/bosprobe2017-xx-xx_xx_xx_xx_86018.log