Todos os produtos
Search

Este produto

    Object Storage Service:View options

    Central de documentação

    Object Storage Service:View options

    Última atualização: Aug 27, 2026

    Execute ossutil -h para listar todas as opções de linha de comando suportadas.

    Nota

    A partir do ossutil V1.6.16, use ossutil como nome do binário na linha de comando. Não é necessário alterar o nome do binário com base no seu sistema operacional. Caso utilize uma versão do ossutil anterior à 1.6.16, altere o nome do binário para corresponder ao seu sistema operacional. Para mais informações, consulte Command reference for ossutil.

    Formato do comando

    ossutil -h

    Para visualizar as opções de um comando específico, execute ossutil help [command], por exemplo, ossutil help cp.

    Opções comuns

    A maioria dos comandos do ossutil suporta as seguintes opções:

    Opção

    Descrição

    -c, --config-file

    Caminho para o arquivo de configuração do ossutil, lido na inicialização. Para gerenciar buckets em várias contas, crie arquivos de configuração separados e use -c para especificar qual utilizar.

    -e, --endpoint

    Endpoint do bucket. Para gerenciar buckets em várias regiões, especifique o endpoint correspondente. Regions and Endpoints.

    -i, --access-key-id

    AccessKey ID para acesso ao OSS. Especifique esta opção ao gerenciar buckets em várias contas.

    -k, --access-key-secret

    AccessKey secret para acesso ao OSS. Especifique esta opção ao gerenciar buckets em várias contas.

    -p, --password

    Solicita que você insira o AccessKey secret pelo teclado. O valor inserido substitui qualquer AccessKey secret configurado em outro local.

    --loglevel

    Gera um arquivo ossutil.log no diretório de trabalho atual. Por padrão, nenhum arquivo de log é gerado.

    Valores válidos:

    • info: Registra os registros de operação do ossutil.

      ossutil [command] --loglevel=info

    • debug: Emite logs de fluxo HTTP e a string de assinatura original para solução de problemas.

      ossutil [command] --loglevel=debug

    --proxy-host, --proxy-user, --proxy-pwd

    Opções de configuração de proxy:

    • --proxy-host: URL do servidor proxy. São suportados HTTP, HTTPS e SOCKS5.

    • --proxy-user: Nome de usuário do servidor proxy. O valor padrão é vazio.

    • --proxy-pwd: Senha do servidor proxy. O valor padrão é vazio.

    Após a configuração, o ossutil roteia o tráfego através do proxy.

    ossutil ls oss://bucket1 --proxy-host http://47.88.**.**:3128 --proxy-user test --proxy-pwd test

    --mode

    Tipo de credencial. Valores válidos:

    • AK: Acesse o OSS usando um AccessKey ID e um AccessKey secret.

    • StsToken: Acesse o OSS usando um token do Security Token Service (STS).

    • RamRoleArn: Acesse o OSS usando a operação AssumeRole de um usuário RAM.

    • EcsRamRole: Implemente acesso sem senha em uma instância ECS usando uma função RAM para a instância ECS.

    Se omitido, a lógica de autenticação padrão será aplicada.

    --ecs-role-name

    Nome da função RAM no modo de autenticação EcsRamRole.

    --token-timeout

    Período de validade da credencial de acesso temporário no modo RamRoleArn. Unidade: segundos. Padrão: 3600.

    --ram-role-arn

    Alibaba Cloud Resource Name (ARN) da função RAM no modo de autenticação RamRoleArn.

    --role-session-name

    Nome da sessão no modo de autenticação RamRoleArn.

    --read-timeout

    Tempo limite de leitura do cliente. Unidade: segundos. Padrão: 1200.

    --connect-timeout

    Tempo limite de conexão do cliente. Unidade: segundos. Padrão: 120.

    --sts-region

    Região do service STS, por exemplo, cn-hangzhou. As regiões suportadas estão listadas em Endpoints.

    Endpoint STS padrão no modo RamRoleArn: sts.aliyuncs.com.

    --skip-verify-cert

    Ignora a verificação do certificado digital do lado do servidor.

    --ua

    Anexa um valor personalizado ao cabeçalho de solicitação HTTP User-Agent. Use com --loglevel debug para visualizar o User-Agent completo nos logs.

    Outras opções

    Os comandos do ossutil também suportam as seguintes opções:

    Nome da opção

    Descrição

    -s, --short-format

    Exibe resultados em formato curto. Padrão: formato longo.

    --bigfile-threshold

    Limiar de tamanho de arquivo para upload retomável. Unidade: bytes. Padrão: 100 MB. Intervalo: 0 a 9223372036854775807.

    --acl

    Configura a lista de controle de acesso (ACL).

    --range

    Especifica um intervalo de bytes baseado em zero para baixar de um arquivo.

    • É possível especificar um intervalo. Por exemplo, 3-9 indica do 3º ao 9º byte, inclusive.

    • Defina um ponto inicial, como 3-, para baixar do byte 3 até o final do arquivo, inclusive.

    • Indique a posição final. Por exemplo, -9 especifica o intervalo do byte 0 ao byte 9.

    --all-versions

    Especifica todas as versões de um objeto.

    --type

    Método de validação de dados. Valores válidos:

    • crc64 (padrão): Executa uma verificação de redundância cíclica de 64 bits (CRC64).

    • md5: Executa validação MD5.

    -v, --version

    Exibe a versão do ossutil e sai.

    -u, --update

    Executa uma operação de atualização.

    --origin

    Valor do campo origin no cabeçalho de solicitação HTTP.

    --upmode

    Modo de upload usado no comando probe. Valores válidos:

    • normal (padrão): Upload simples.

    • append: Upload por anexação.

    • multipart: Upload multipart.

    --sse-algorithm

    Algoritmo de criptografia do lado do servidor para o bucket. Valores válidos:

    • KMS: Usa uma chave gerenciada pelo Key Management Service (KMS) para criptografia e descriptografia, conhecido como SSE-KMS.

    • AES256: Usa uma chave gerenciada pelo OSS para criptografia e descriptografia, conhecido como SSE-OSS.

    --include

    Lista objetos que atendem às condições especificadas. Por exemplo, *.jpg lista todos os arquivos no formato JPG.

    The --include and --exclude options.

    --exclude

    Lista objetos que não atendem às condições especificadas. Por exemplo, *.txt lista todos os arquivos que não estão no formato TXT.

    The --include and --exclude options.

    -r, --recursive

    Opera recursivamente em todos os objetos correspondentes no bucket. Sem esta opção, apenas o objeto especificado é afetado.

    --addr

    Especifica um endereço de rede para teste de conectividade via ping.

    Valor padrão: www.aliyun.com

    --kms-masterkey-id

    ID da chave mestra do cliente (CMK) no KMS.

    --version-id

    ID da versão do objeto.

    --version-id-marker

    Lista versões de objetos com IDs alfabeticamente posteriores ao marcador especificado. Requer que o versionamento esteja ativado.

    -m, --multipart

    Especifica que a operação se aplica a eventos de upload multipart incompletos no bucket.

    -d, --directory

    Retorna apenas os arquivos e subdiretórios no diretório atual.

    --payer

    Pagador da solicitação. Defina como requester para o modo de pagamento pelo solicitante.

    --maxupspeed

    Velocidade máxima de upload. Unidade: KB/s. Padrão: 0 (sem limite).

    --maxdownspeed

    Velocidade máxima de download. Unidade: KB/s. Padrão: 0 (sem limite).

    --retry-times

    Número de tentativas após um erro. Padrão: 10. Intervalo: 1 a 500.

    Nota

    As novas tentativas ocorrem imediatamente após um erro.

    --download

    Testa a conectividade de rede baixando um objeto do bucket de destino usando a URL do arquivo.

    -j, --jobs

    Número de tarefas simultâneas para operações com múltiplos arquivos. Padrão: 3. Intervalo: 1 a 10000.

    -a, --all-type

    Especifica que a operação se aplica a objetos e eventos de upload multipart incompletos no bucket.

    --disable-empty-referer

    Especifica que o campo Referer não pode estar vazio.

    --method

    Método de solicitação HTTP. Os valores válidos incluem PUT, GET e DELETE.

    --output-dir

    Diretório de saída para arquivos de relatório, como relatórios de falha de cópia em lote do comando cp.

    Padrão: diretório ossutil_output no diretório atual.

    --meta

    Define metadados do objeto. Formato: Cache-Control:no-cache#Content-Encoding:gzip.

    --object

    Especifica o nome do arquivo no comando probe.

    --end-time

    Timestamp UNIX. Se você usar esta opção, objetos modificados pela última vez após o horário especificado serão ignorados.

    --limited-num

    Número máximo de resultados a retornar.

    -L, --language

    Define o idioma para o ossutil. Valores válidos:

    • CH (padrão): Chinês. Se definir o idioma como CH, certifique-se de que a codificação do seu sistema seja UTF-8.

    • EN: Inglês.

    --delete

    Exclui um bucket, objeto ou fragmento.

    -b, --bucket

    Use esta opção apenas quando for excluir um bucket.

    --disable-crc64

    Desativa a validação CRC64. Por padrão, o ossutil ativa a validação CRC64 para transferência de dados.

    --upload

    Testa a conectividade de rede enviando um arquivo local para o bucket de destino.

    --part-size

    Tamanho da parte. Unidade: bytes. Por padrão, o ossutil calcula o tamanho da parte com base no tamanho do arquivo. Intervalo: 1 a 9223372036854775807.

    --timeout

    Tempo limite da URL assinada. Unidade: segundos. Padrão: 60. Intervalo: 0 a 9223372036854775807.

    --checkpoint-dir

    Diretório para dados de checkpoint de upload/download retomável. Em caso de falha, o ossutil cria um diretório .ossutil_checkpoint que é excluído após o sucesso da operação. Certifique-se de que o diretório especificado possa ser excluído.

    --url

    URL do arquivo.

    --marker

    Lista buckets, objetos ou partes cujos nomes são alfabeticamente posteriores ao marcador especificado.

    -f, --force

    Força a operação sem solicitação de confirmação.

    --snapshot-path

    Diretório para dados de snapshot usados em uploads e downloads incrementais.

    • --snapshot-path acelera transferências incrementais de grandes conjuntos de arquivos quando nenhum outro usuário modificou os objetos OSS correspondentes entre as operações. Não suportado para operações de cópia.

    • --snapshot-path registra o lastModifiedTime dos arquivos transferidos com sucesso e ignora arquivos inalterados nas execuções subsequentes. Se outros usuários puderem modificar objetos OSS, use --update em vez disso.

    • Os dados de snapshot não são excluídos automaticamente. Limpe o caminho do snapshot quando não for mais necessário.

    • Esta opção adiciona sobrecarga de I/O. Para pequenos conjuntos de arquivos ou objetos compartilhados, use --update em vez disso.

    • --update e --snapshot-path podem ser combinados. O ossutil verifica o snapshot primeiro e, em seguida, recorre ao --update.

    --start-time

    Timestamp UNIX. Se você usar esta opção, objetos modificados pela última vez antes do horário especificado serão ignorados.

    --storage-class

    Classe de armazenamento. Valores válidos:

    • Standard (padrão): Para dados acessados frequentemente.

    • IA: Acesso Infrequente. Para dados acessados uma ou duas vezes por mês. Armazenamento mínimo: 30 dias. Tamanho mínimo faturável: 64 KB. Acesso em tempo real com taxas de recuperação de dados.

    • Archive: Arquivamento de dados de longo prazo. Armazenamento mínimo: 60 dias. Tamanho mínimo faturável: 64 KB. Requer restauração (~1 minuto) antes do acesso. Taxas de recuperação de dados se aplicam.

    • ColdArchive: Dados extremamente frios que exigem armazenamento de longo prazo. Armazenamento mínimo: 180 dias. Tamanho mínimo faturável: 64 KB. Requer restauração antes do acesso; o tempo varia conforme o tamanho dos dados e o modo de restauração. Taxas de recuperação de dados se aplicam.

    -t, --sts-token

    Token STS para acesso com credenciais temporárias. Necessário apenas com credenciais STS e substitui a configuração do arquivo de configuração. Temporary access credentials.

    --parallel

    Número de tarefas simultâneas para operações de arquivo único. Intervalo: 1 a 10000. Padrão: determinado pelo tipo de operação e tamanho do arquivo.

    --partition-download

    Especifica uma partição para downloads paralelos. Formato: partition_number:total_partitions. Por exemplo, 1:5 baixa a partição 1 de 5. Os números das partições são baseados em 1. Várias instâncias do ossutil podem baixar partições diferentes em paralelo.

    --bucketname

    Nome do bucket.

    --encoding-type

    Codifica a chave do objeto em URL após oss://bucket_name. Valor válido: url. Se omitido, a chave não é codificada.

    --origin

    Valor do cabeçalho de solicitação HTTP Origin, usado para identificar solicitações de origem cruzada.

    --acr-method

    Valor do cabeçalho de solicitação HTTP Access-Control-Request-Method. Os valores válidos são GET, PUT, POST, DELETE e HEAD.

    --acr-headers

    Valor de Access-Control-Request-Headers para solicitações de preflight CORS. Separe vários cabeçalhos com vírgulas e coloque entre aspas duplas, por exemplo, --acr-headers "header1,header2,header3".

    --upload-id-marker

    Lista partes cujos IDs de upload são alfabeticamente posteriores ao marcador especificado.

    -h, --help

    Exibe informações de ajuda.

    --trafic-limit

    Limite de velocidade HTTP para o comando sign. Unidade: bit/s.

    Padrão: 0 (sem limite).

    Intervalo: 819200 a 838860800 (100 KB/s a 100 MB/s).

    --local-host

    Endereço IP local para acesso ao OSS no comando cp.

    --enable-symlink-dir

    Envia subdiretórios vinculados (ignorados por padrão). Use o probe command para detectar links simbólicos circulares.

    --only-current-dir

    Processa apenas arquivos no diretório atual, ignorando subdiretórios.

    --disable-dir-object

    Ignora a criação de objetos de diretório durante o upload. A estrutura de diretórios permanece visível no console, mas desaparece quando todos os arquivos dentro dela são excluídos.

    --probe-item

    Alvo do teste. Valores válidos:

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

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

    • cycle-symlink: Verifica se existem arquivos ou diretórios de link em loop infinito no diretório de arquivos local.

    --redundancy-type

    Tipo de redundância de dados do bucket. Valores válidos:

    • LRS (padrão): O armazenamento localmente redundante (LRS) armazena seus dados redundantemente em diferentes dispositivos de armazenamento na mesma zona. Garante durabilidade e disponibilidade dos dados mesmo se dois dispositivos de armazenamento forem danificados simultaneamente.

    • ZRS: O armazenamento redundante por zona (ZRS) usa um mecanismo de redundância de dados multizona para armazenar seus dados redundantemente em várias zonas na mesma região. Garante a disponibilidade dos dados mesmo se uma zona ficar indisponível.

    --disable-encode-slash

    Não codifica a barra (/) na URL.

    --disable-all-symlink

    Ignora todos os subarquivos de link simbólico e subdiretórios de link simbólico durante o upload.

    --tagging

    Define tags de objeto durante o upload ou cópia. Formato: "abc=1&bcd=2&...".

    --disable-ignore-error

    Termina imediatamente em caso de erro, em vez de continuar operações em lote.

    --block-size

    Unidade para tamanhos de objetos na saída. Valores válidos: KB, MB, GB ou TB. Padrão: bytes.

    Importante

    Esta opção está disponível apenas no ossutil 1.7.3 e posterior.

    As opções --include e --exclude

    Aplicação de regras para múltiplas opções

    As regras podem conter várias condições de inclusão e exclusão, avaliadas da esquerda para a direita. Por exemplo, dado um arquivo chamado test.txt:

    • Regra 1: --include "*test*" --exclude "*.txt" . A regra --include "*test*" corresponde a test.txt. Em seguida, a regra --exclude "*.txt" é aplicada. Como o nome do arquivo test.txt contém .txt, o arquivo é excluído. Portanto, o resultado final é que test.txt é excluído.

    • Regra 2: --exclude "*.txt" --include "*test*". A regra --exclude "*.txt" exclui test.txt. Em seguida, a regra --include "*test*" é aplicada. Como o nome do arquivo contém test, test.txt é incluído. O resultado final é que test.txt é incluído.

    • Regra 3: --include "*test*" --exclude "*.txt" --include "te?t.txt" . Quando a regra corresponde a --include "*test*", test.txt é incluído. Quando a regra continua a corresponder a --exclude "*.txt", test.txt é excluído porque seu nome contém .txt. Quando a regra finalmente corresponde a --include "te?t.txt", test.txt é incluído. O resultado final é que test.txt é incluído.

    Formatos suportados

    • Caractere curinga asterisco (*): Corresponde a qualquer sequência de caracteres. Por exemplo, *.txt corresponde a todos os arquivos no formato TXT.

    • Caractere curinga ponto de interrogação (?): Corresponde a qualquer caractere único. Por exemplo, abc?.jpg corresponde a todos os arquivos JPG cujos nomes são abc seguidos por qualquer caractere único, como abc1.jpg.

    • [sequência]: Corresponde a qualquer caractere na sequência. Por exemplo, abc[1-5].jpg corresponde a arquivos de abc1.jpg a abc5.jpg.

    • [!sequência]: Corresponde a qualquer caractere que não esteja na sequência. Por exemplo, abc[!0-7].jpg corresponde a arquivos diferentes de abc0.jpg a abc7.jpg.

    Limites

    Formatos de diretório não são suportados nas condições. Por exemplo, se você executar ossutil cp oss://examplebucket/destfolder/ localfolder/ --include dir/, o erro --include or --exclude does not support format containing dir info será relatado.