Todos os produtos
Search

Este produto

    Object Storage Service:probe

    Central de documentação

    Object Storage Service:probe

    Última atualização: Jul 03, 2026

    O comando probe detecta problemas de conectividade de rede entre o cliente local e o OSS, mede a largura de banda de upload e download e verifica o status de links simbólicos locais.

    Notas de uso

    A verificação da largura de banda de upload exige as permissões oss:GetObject, oss:PutObject e oss:DeleteObject. A verificação da largura de banda de download exige a permissão oss:GetObject. Para mais informações, consulte Conceder uma política personalizada.

    Visão geral

    O comando probe identifica problemas de rede entre o cliente local e o OSS, mede a largura de banda de upload e download e verifica o status de links simbólicos antes do upload.

    • Detecção de exceções de rede

      O ossutil testa a rede ao fazer upload ou download de objetos. Especifique nomes de objetos para manter os arquivos transferidos no caminho definido. Caso contrário, o ossutil cria objetos temporários para detecção e os exclui em seguida.

    • Verificação das larguras de banda de upload e download

      O ossutil recomenda um nível de simultaneidade com base nos núcleos da CPU e na largura de banda da rede para maximizar o throughput.

    • Verificação do status de links simbólicos locais

      O upload é interrompido se um link simbólico estiver anormal. Verifique o status dos links simbólicos antes de iniciar o upload e corrija quaisquer problemas previamente.

    Após executar o comando probe, visualize o procedimento de detecção e os resultados.

    • Detectar exceções de rede por meio de upload ou download de objetos

      • √ indica sucesso. × indica falha.

      • Em caso de sucesso, o ossutil retorna o tamanho do objeto, o tempo decorrido e o caminho de upload ou download.

      • Em caso de falha, o ossutil retorna causas ou códigos de erro para solução de problemas.

        Os códigos de erro estão listados em Visão geral.

      • Após a detecção, o ossutil cria um arquivo de log chamado logOssProbe+DetectionCompletionTime.log no diretório de instalação com resultados detalhados do comando probe.

    • Verificar um item específico

      Ao verificar a largura de banda ou o status de links simbólicos, o ossutil retorna resultados e recomendações.

    Verificar a conectividade de rede fazendo upload de um objeto

    O ossutil verifica a conectividade de rede entre o cliente local e um bucket ao fazer upload de um objeto.

    • Sintaxe do comando

      ossutil probe {--upload [file_name]} {--bucket bucket_name} [--object object_name] [--addr domain_name] [--upmode]

      A tabela a seguir descreve os parâmetros do comando anterior.

      Parâmetro

      Tipo

      Obrigatório

      Descrição

      --upload

      /

      Sim

      Detecta problemas de rede fazendo upload de um objeto.

      file_name

      string

      Não

      Caminho completo do arquivo local para upload. Se não especificado, o ossutil gera e faz upload de um arquivo temporário.

      --bucket

      string

      Não

      Nome do bucket.

      --object

      string

      Não

      Nome do objeto para upload. Se especificado, o objeto é armazenado no bucket com este nome. Caso contrário, o ossutil exclui o objeto enviado após a detecção.

      --addr

      string

      Não

      Endereço de rede para ping nas verificações de conectividade.

      Valor padrão: www.aliyun.com.

      --upmode

      string

      Não

      Método usado para fazer upload do objeto.

      Valores válidos:

      • normal (padrão): O objeto é enviado por upload simples.

      • append: O objeto é enviado por upload de anexação.

      • multipart: O objeto é enviado por upload multipart.

    • Comandos de exemplo

      • Verificar a rede fazendo upload de um objeto aleatório e especificando o endereço de rede

        Faça upload de um objeto aleatório para examplebucket e execute ping em aliyun.com:

        ossutil probe --upload --bucket examplebucket --addr aliyun.com

        Saída de exemplo:

        begin parse parameters and prepare file...[√]
begin network detection...[√]
begin upload file(normal)...[√]

*************************  upload result  *************************
upload file:success
upload file size:143360(byte)
upload time consuming:456(ms)
(only the time consumed by probe command)

upload object is oss-test-probe-1716280906324488100-quky8a902r

************************* report log info*************************
report log file:E:\00-OSS\01-ossutil\05-v2\ossutil-2.0.0-beta.24041600-windows-amd64\logOssProbe20240521164146.log

      • Fazer upload de example.txt de D:\localpath para examplebucket usando upload simples

        O objeto enviado é excluído após a detecção. Comando de exemplo:

        ossutil probe --upload D:\localpath\example.txt --bucket examplebucket

        Saída de exemplo:

        begin parse parameters and prepare file...[√]
begin network detection...[√]
begin upload file(normal)...[√]

*************************  upload result  *************************
upload file:success
upload file size:9(byte)
upload time consuming:366(ms)
(only the time consumed by probe command)

upload object is oss-test-probe-1716281191298397500-hi8237d15e

************************* report log info*************************
report log file:E:\00-OSS\01-ossutil\05-v2\ossutil-2.0.0-beta.24041600-windows-amd64\logOssProbe20240521164631.log

    Verificar a conectividade de rede baixando de uma URL de objeto

    O ossutil verifica a conectividade de rede entre o cliente local e um bucket ao baixar um objeto de sua URL.

    • Sintaxe do comando

      ossutil probe {--download} {--url http_url} [--addr=domain_name] [file_name]

      A tabela a seguir descreve os parâmetros do comando anterior.

      Parâmetro

      Tipo

      Obrigatório

      Descrição

      --download

      /

      Sim

      Detecta problemas de rede baixando um objeto.

      --url

      string

      Sim

      URL do objeto a ser baixado.

      • Se a ACL do objeto for public-read, use a URL do objeto. Exemplo: https://examplebucket.oss-cn-beijing.aliyuncs.com/example.jpg.

      • Se a ACL do objeto for private, use uma URL assinada entre aspas duplas (""). Exemplo: "https://examplebucket.oss-cn-beijing.aliyuncs.com/example.jpg?Expires=1552015472&OSSAccessKeyId=TMP.5r9f1FV12y8_Qis6LUVmvoSCUSs7aboCCHtydQ0axN32Sn-UvyY3AAAwLAIUarYNLcO87AKMEcE5O3AoCFAQuRdZYyVFyqOW8QkGAN-bamUiQ&Signature=bIa4llbMbldrl7rwckr%2FXXvTtxw%3D".

      --addr

      string

      Não

      Endereço de rede para ping nas verificações de conectividade.

      Valor padrão: www.aliyun.com.

      file_name

      string

      Não

      Caminho local para onde o objeto será baixado.

      • Se você especificar apenas o nome do objeto, mas não definir um diretório, o objeto será armazenado com o nome especificado no diretório de instalação do ossutil.

      • Se você especificar apenas um diretório, mas não definir o nome do objeto, o objeto será armazenado com seu nome original no diretório especificado.

      • Se você não especificar este parâmetro, o objeto será armazenado com seu nome original no diretório de instalação do ossutil.

    • Comandos de exemplo

      • Baixar um objeto public-read e salvá-lo com um novo nome

        Baixe example.txt de https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt e salve-o como /localfile/test.txt:

        ossutil probe --download --url https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt  /localfile/test.txt

        Saída de exemplo:

        begin parse parameters and prepare object...[√]
begin network detection...[√]
begin download file...[√]

*************************  download result  *************************
download file:success
download file size:9(byte)
download time consuming:278(ms)
(only the time consumed by probe command)

download file is E:\localfile\test.txt

************************* report log info*************************
report log file:E:\00-OSS\01-ossutil\05-v2\ossutil-2.0.0-beta.24041600-windows-amd64\logOssProbe20240521173050.log

      • Baixar um objeto public-read e especificar um endereço de ping

        Baixe example.txt de https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt e execute ping em aliyun.com:

        ossutil probe --download --url https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt --addr aliyun.com

        Saída de exemplo:

        begin parse parameters and prepare object...[√]
begin network detection...[√]
begin download file...[√]

*************************  download result  *************************
download file:success
download file size:9(byte)
download time consuming:316(ms)
(only the time consumed by probe command)

download file is E:\00-OSS\01-ossutil\05-v2\ossutil-2.0.0-beta.24041600-windows-amd64\example.txt

************************* report log info*************************
report log file:E:\00-OSS\01-ossutil\05-v2\ossutil-2.0.0-beta.24041600-windows-amd64\logOssProbe20240521173448.log

    Verificar a conectividade de rede baixando de um bucket

    O ossutil verifica a conectividade de rede entre o cliente local e um bucket ao baixar um objeto diretamente dele.

    • Sintaxe do comando

      ossutil probe {--download} {--bucket bucket_name} [--object object_name] [--addr domain_name] [file_name]

      A tabela a seguir descreve os parâmetros do comando anterior.

      Parâmetro

      Tipo

      Obrigatório

      Descrição

      --download

      /

      Sim

      Detecta problemas de rede baixando um objeto.

      --bucket

      string

      Sim

      Nome do bucket.

      --object

      string

      Não

      Nome do objeto a ser baixado. Se especificado, o ossutil baixa esse objeto. Caso contrário, o ossutil cria um objeto temporário, faz upload dele para o bucket, realiza o download e depois o exclui após a detecção.

      --addr

      string

      Não

      Endereço de rede para ping nas verificações de conectividade.

      Valor padrão: www.aliyun.com.

      file_name

      string

      Não

      Caminho local para onde o objeto será baixado.

      • Se você especificar apenas o nome do objeto, mas não definir um diretório, o objeto será armazenado com o nome especificado no diretório de instalação do ossutil.

      • Se você especificar apenas um diretório, mas não definir o nome do objeto, o objeto será armazenado com seu nome original no diretório especificado.

      • Se você não especificar este parâmetro, o objeto será armazenado com seu nome original no diretório de instalação do ossutil.

    • Comandos de exemplo

      • Baixar um objeto e salvá-lo com um novo nome

        Baixe ossfolder/example.txt de examplebucket e salve-o como /localfolder/text.txt:

        ossutil probe --download --bucket examplebucket --object ossfolder/example.txt /localfolder/text.txt

        Saída de exemplo:

        begin parse parameters and prepare object...[√]
begin network detection...[√]
begin download file...[√]

*************************  download result  *************************
download file:success
download file size:9(byte)
download time consuming:416(ms)
(only the time consumed by probe command)

download file is E:\localfolder\text.txt

************************* report log info*************************
report log file:E:\00-OSS\01-ossutil\05-v2\ossutil-2.0.0-beta.24041600-windows-amd64\logOssProbe20240521180217.log

      • Baixar um objeto temporário e especificar um endereço de ping

        Baixe um objeto temporário de examplebucket e execute ping em aliyun.com:

        ossutil probe --download --bucket examplebucket --addr aliyun.com

        Saída de exemplo:

        begin parse parameters and prepare object...[√]
begin network detection...[√]
begin download file...[√]

*************************  download result  *************************
download file:success
download file size:143360(byte)
download time consuming:865(ms)
(only the time consumed by probe command)

download file is E:\00-OSS\01-ossutil\05-v2\ossutil-2.0.0-beta.24041600-windows-amd64\oss-test-probe-1716286063484973300-rrmrfgtv8w

************************* report log info*************************
report log file:E:\00-OSS\01-ossutil\05-v2\ossutil-2.0.0-beta.24041600-windows-amd64\logOssProbe20240521180533.log

    Verificar um item específico

    Execute o comando probe para verificar o status de links simbólicos, a largura de banda de upload ou a largura de banda de download. O ossutil retorna os nomes de links simbólicos anormais e um nível de simultaneidade recomendado com base nos resultados.

    • Sintaxe do comando

      ossutil probe {--probe-item item_value} {--bucket bucket-name} [--object object_name][--parallel <value>][--part-size <value>][--runtime <value>]

      A tabela a seguir descreve os parâmetros do comando anterior.

      Parâmetro

      Tipo

      Obrigatório

      Descrição

      --probe-item

      string

      Sim

      Item a ser verificado.

      Valores válidos:

      • cycle-symlink: verifica links simbólicos anormais no caminho local.

      • upload-speed: verifica a largura de banda de upload.

      • download-speed: verifica a largura de banda de download.

      • download-time: verifica o tempo necessário para baixar um objeto.

      --bucket

      string

      Sim quando o valor de --probe-item não for cycle-symlink

      Nome do bucket.

      --object

      string

      Sim quando --probe-item estiver definido como download-speed

      Caminho do objeto. O objeto deve existir e ter tamanho superior a 5 MB. Exemplo: ossfolder/example.txt.

      --parallel

      int

      Não

      Número de tarefas simultâneas para um único objeto. Valor padrão: 1.

      Nota

      Este parâmetro só tem efeito quando --probe-item está definido como download-time.

      --part-size

      int

      Não

      Tamanho da parte em bytes. Por padrão, o ossutil determina o tamanho da parte com base no tamanho do objeto.

      Valores válidos: 1 a 9223372036854775807.

      Nota

      Este parâmetro só tem efeito quando --probe-item está definido como download-time.

      --runtime

      int

      Não

      Tempo máximo de execução. O comando para quando esse tempo é atingido.

      Nota

      Este parâmetro só tem efeito quando --probe-item está definido como upload-speed ou download-speed.

    • Comandos de exemplo

      • Verificar links simbólicos anormais no diretório localfolder:

        Comando de exemplo:

        ossutil probe --probe-item cycle-symlink  D:\localfolder

        Saída de exemplo:

         success

0.009583(s) elapsed

        A saída indica que não existem links simbólicos anormais.

      • Verificar a largura de banda de upload

        Faça upload de um objeto temporário para examplebucket e obtenha um nível de simultaneidade recomendado:

        Comando de exemplo:

        ossutil probe --probe-item upload-speed --bucket examplebucket

        Saída de exemplo:

        cpu core count:8
parallel:8,average speed:1956.41(KB/s),current speed:2976.00(KB/s),max speed:2976.00(KB/s)
parallel:9,average speed:1903.45(KB/s),current speed:1216.00(KB/s),max speed:2720.00(KB/s)
parallel:10,average speed:1945.38(KB/s),current speed:1184.00(KB/s),max speed:3168.00(KB/s)
parallel:11,average speed:2102.07(KB/s),current speed:7840.00(KB/s),max speed:7840.00(KB/s)
parallel:12,average speed:1899.03(KB/s),current speed:1568.00(KB/s),max speed:3168.00(KB/s)
parallel:13,average speed:1934.34(KB/s),current speed:1760.00(KB/s),max speed:8544.00(KB/s)
parallel:14,average speed:1765.52(KB/s),current speed:1984.00(KB/s),max speed:2880.00(KB/s)
parallel:15,average speed:2284.14(KB/s),current speed:2016.00(KB/s),max speed:6688.00(KB/s)
parallel:16,average speed:2544.55(KB/s),current speed:4032.00(KB/s),max speed:9344.00(KB/s)

suggest parallel is 16, max average speed is 2544.55(KB/s)

        A saída mostra uma CPU de 8 núcleos, uma largura de banda média máxima de upload de 2544,55 KB/s e uma simultaneidade recomendada de 16.

      • Verificar a largura de banda de download

        Baixe example.txt de examplebucket e obtenha um nível de simultaneidade recomendado:

        Comando de exemplo:

        ossutil probe --probe-item download-speed --bucket examplebucket --object example.txt

        Saída de exemplo:

        cpu core count:8
parallel:8,average speed:1.41(KB/s),current speed:1.69(KB/s),max speed:1.78(KB/s)
parallel:9,average speed:1.48(KB/s),current speed:1.02(KB/s),max speed:1.95(KB/s)
parallel:10,average speed:1.52(KB/s),current speed:1.60(KB/s),max speed:2.11(KB/s)
parallel:11,average speed:1.41(KB/s),current speed:2.17(KB/s),max speed:2.34(KB/s)
parallel:12,average speed:1.86(KB/s),current speed:1.71(KB/s),max speed:2.47(KB/s)
parallel:13,average speed:1.90(KB/s),current speed:0.58(KB/s),max speed:2.65(KB/s)
parallel:14,average speed:1.17(KB/s),current speed:0.99(KB/s),max speed:2.29(KB/s)
parallel:15,average speed:1.86(KB/s),current speed:1.42(KB/s),max speed:2.84(KB/s)
parallel:16,average speed:1.93(KB/s),current speed:0.76(KB/s),max speed:2.56(KB/s)

suggest parallel is 16, max average speed is 1.93(KB/s)

        A saída mostra uma CPU de 8 núcleos, uma largura de banda média máxima de download de 1,93 KB/s e uma simultaneidade recomendada de 16.

      • Verificar a largura de banda de download com tempo máximo de execução

        Baixe example.zip de examplebucket com limite de tempo de 2 segundos:

        ossutil probe --probe-item download-speed --bucket examplebucket --object  example.zip --runtime 2

        Saída de exemplo:

        cpu core count:8
parallel:8,average speed:937.76(KB/s),current speed:952.00(KB/s),max speed:1044.00(KB/s)))
parallel:9,average speed:935.59(KB/s),current speed:936.00(KB/s),max speed:1016.00(KB/s))
parallel:10,average speed:924.45(KB/s),current speed:940.00(KB/s),max speed:968.00(KB/s)
parallel:11,average speed:930.48(KB/s),current speed:828.00(KB/s),max speed:1104.00(KB/s))
parallel:12,average speed:908.21(KB/s),current speed:920.00(KB/s),max speed:1000.00(KB/s))
parallel:13,average speed:923.86(KB/s),current speed:992.00(KB/s),max speed:992.00(KB/s)
parallel:14,average speed:794.14(KB/s),current speed:776.00(KB/s),max speed:948.00(KB/s)
parallel:15,average speed:835.28(KB/s),current speed:936.00(KB/s),max speed:960.00(KB/s)
parallel:16,average speed:935.62(KB/s),current speed:932.00(KB/s),max speed:984.00(KB/s)

suggest parallel is 8, max average speed is 937.76(KB/s)

run download-speed  2 seconds with parallel 8
parallel:8,average speed:809.67(KB/s),current speed:651.08(KB/s),max speed:891.08(KB/s)
281.731035(s) elapsed

      • Verificar o tempo de download

        Baixe example.txt de examplebucket e meça o tempo decorrido:

        ossutil probe --probe-item download-time --bucket examplebucket --object example.txt

        Saída de exemplo:

        download-speed part-size:-1, parallel:1 total bytes:9, cost:0.057 s, avg speed:NaN(kB/s)

0.539351(s) elapsed

      • Verificar o tempo de download com tamanho de parte personalizado

        Baixe example.zip de examplebucket com tamanho de parte de 10 MB:

        ossutil probe --probe-item download-time --bucket examplebucket --object example.zip --part-size 10000000

        Saída de exemplo:

        downloading average speed:904.75(KB/s),current speed:1777.62(KB/s),max speed:1868.00(KB/s)
download-speed part-size:10000000, parallel:1 total bytes:11881599, cost:12.831 s, avg speed:966.92(kB/s)

13.188139(s) elapsed

      • Verificar o tempo de download com nível de simultaneidade personalizado

        Baixe example.zip de examplebucket com 3 tarefas simultâneas:

        ossutil probe --probe-item download-time --bucket examplebucket --object example.zip --parallel 3

        Saída de exemplo:

        downloading average speed:910.58(KB/s),current speed:1740.00(KB/s),max speed:1876.00(KB/s)
download-speed part-size:-1, parallel:3 total bytes:11881599, cost:12.728 s, avg speed:966.92(kB/s)

12.984432(s) elapsed