Todos os produtos
Search
Central de documentação

Object Storage Service:ossutil 1.0

Última atualização: Jul 03, 2026

O ossutil permite gerenciar dados do OSS por linha de comando no Windows, Linux e macOS.

Atualize para o ossutil 2.0

Recomendamos o ossutil 2.0. Para instalar e usar rapidamente o ossutil, consulte Instalar o ossutil.

Principais recursos do ossutil 2.0

  • Nova sintaxe de comandos: suporta comandos multinível, incluindo comandos no nível da API (ossutil api put-bucket-acl) e comandos 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 do arquivo, hora da última modificação e metadados do 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: transmita parâmetros sensíveis 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.

Instale o ossutil

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

Configure o ossutil

Para obter mais informações sobre como configurar o ossutil, consulte Configurar 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

Adiciona conteúdo a objetos anexáveis existentes.

bucket-cname

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

bucket-encryption(服务端加密)

Gerencie as configurações de criptografia do bucket.

bucket-policy

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

bucket-tagging

Gerencie as configurações de tags do bucket.

bucket-versioning

Adiciona ou consulta as configurações de versionamento do 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)

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

cors-options

Testa se um bucket permite uma solicitação cross-origin específica.

cp

Faz upload, baixe ou cópia de objetos.

create-symlink (Create symbolic link)

Crie um link simbólico.

du

Consulta o uso de armazenamento de um bucket, objeto ou diretório específico.

getallpartsize

Consulta 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

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

lifecycle

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

listpart

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

logging

Gerencie as configurações de log do bucket.

lrb

Lista os buckets localizados em uma ou mais regiões.

ls

Lista buckets, objetos ou partes.

mb

Crie um bucket.

mkdir (create a directory)

Crie um diretório em um bucket.

object-tagging

Gerencie as configurações de tags de objetos.

probe

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

read-symlink (read symbolic links)

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

referer

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

replication

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

request-payment

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

resource-group

Gerencie 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 sua versão mais recente.

rm

Exclui buckets, objetos ou partes.

set-acl (Set or modify ACLs)

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

set-meta (Manage object metadata)

Configure os metadados de um objeto carregado.

sign (generate a signed URL)

Gera uma URL assinada para um objeto a fim de compartilhar com terceiros.

stat (View bucket and object information)

Obtém a descrição de um bucket ou objeto.

style

Configure 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

Gerencie hospedagem de site estático, redirecionamento e configurações de back-to-origin para um bucket.

worm (retention policy)

Consulta as políticas de retenção de um bucket.

Visualize opções

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

Perguntas frequentes

Para obter mais informações, consulte Perguntas frequentes.