Todos os produtos
Search
Central de documentação

Object Storage Service:ossutil 1.0

Última atualização: Oct 31, 2026

O ossutil permite gerenciar dados do OSS por CLI no Windows, no Linux e no macOS.

Atualização para o ossutil 2.0

Recomendamos o ossutil 2.0. Para saber como instalar e usar o ossutil rapidamente, consulte Instale o ossutil.

Principais recursos do ossutil 2.0

  • Nova sintaxe de comandos: compatível com comandos de vários níveis, incluindo comandos no nível da API (ossutil api put-bucket-acl) e de alto nível (ossutil config).

  • Configuração simplificada: especifique apenas o AccessKey ID, o AccessKey secret e o ID da região para a configuração básica. Use o parâmetro --profile para gerenciar vários arquivos de configuração.

  • Filtragem avançada: filtre por caminho, tamanho de arquivo, hora da última modificação e metadados de objeto em comandos em lote, como ls, cp e rm.

  • Saída flexível: defina o formato de saída como JSON, YAML ou XML com --output-format. Use --output-query para filtrar campos de saída.

  • Segurança aprimorada: passe parâmetros confidenciais por variáveis de ambiente para evitar a exposição de chaves na linha de comando. Use --dry-run para verificar comandos antes da execução.

Instalação do ossutil

Para mais informações sobre como baixar e instalar o ossutil, consulte Instale o ossutil.

Configuração do ossutil

Para mais informações sobre como configurar o ossutil, consulte Configure o ossutil.

Comandos comuns

A tabela a seguir lista os comandos comuns do ossutil.

Comando

Descrição

access-monitor

Especifica o estado de rastreamento de acesso de um bucket.

appendfromfile

Acrescenta conteúdo a objetos do tipo appendable existentes.

bucket-cname

Consulta as configurações de CNAME de um bucket.

bucket-encryption

Gerencie as configurações de criptografia do bucket.

bucket-policy

Controla as configurações de política do bucket.

bucket-tagging

Administra as configurações de tags do bucket.

bucket-versioning

Adiciona ou consulta as configurações de versionamento de bucket.

cat

Exporta o conteúdo do objeto para o ossutil.

config

Crie um arquivo de configuração para armazenar informações de acesso ao OSS.

cors (cross-origin resource sharing)

Controla as configurações de CORS para um bucket.

cors-options

Testa se um bucket permite uma solicitação de origem cruzada especificada.

cp

Faça upload, baixe ou copie objetos.

create-symlink (Crie link simbólico)

Gera um link simbólico.

du

Verifique o uso de armazenamento de um bucket, objeto ou diretório especificado.

getallpartsize

Obtém os tamanhos das partes de uploads multipart incompletos em um bucket.

hash

Calcula o hash CRC-64 ou MD5 de um arquivo local.

help

Exibe informações de help para um comando.

inventory

Administra as configurações de inventário do bucket.

lifecycle

Controla as configurações de ciclo de vida do bucket.

listpart

Lista as partes de um upload multipart incompleto para um objeto.

logging

Administra as configurações de log do bucket.

lrb

Exibe os buckets localizados em uma região ou em várias regiões.

ls

Relaciona buckets, objetos ou partes.

mb

Crie um bucket.

mkdir (crie um diretório)

Adiciona um diretório a um bucket.

object-tagging

Controla as configurações de tags de objetos.

probe

Monitora o acesso ao OSS e soluciona problemas de upload e download.

read-symlink (read symbolic links)

Lê a descrição de um link simbólico.

referer

Administra as configurações de proteção contra hotlink do bucket.

replication

Controla as configurações de Replicação entre Regiões (CRR) para um bucket.

request-payment

Administra as configurações de pagamento pelo solicitante para um bucket.

resource-group

Controla as configurações de grupo de recursos do bucket.

Restore files

Restaura um objeto do estado congelado para o estado legível.

revert-versioning

Recupera um objeto excluído para a sua versão mais recente.

rm

Exclui buckets, objetos ou partes.

set-acl (Defina ou modifique ACLs)

Defina a lista de controle de acesso (ACL) para um bucket ou um objeto.

set-meta (Gerencie metadados de objeto)

Defina os metadados de um objeto carregado.

sign (generate a signed URL)

Gera uma URL assinada para um objeto a ser compartilhada com terceiros.

stat (Visualize informações de bucket e objeto)

Retorna a descrição de um bucket ou objeto.

style

Estabelece os estilos de imagem.

sync

Sincroniza arquivos locais com o OSS, objetos do OSS com discos locais ou objetos entre caminhos do OSS.

update

Atualize a versão do ossutil.

website

Administra a hospedagem de site estático, o redirecionamento e as configurações de back-to-origin de um bucket.

worm (retention policy)

Obtém as políticas de retenção de um bucket.

Opções de exibição

Para mais informações sobre as opções de linha de comando, consulte Visualize as opções.

Perguntas frequentes

Para mais informações, consulte FAQ.