Todos os produtos
Search
Central de documentação

Object Storage Service:set-props (Definir propriedades do objeto)

Última atualização: Jul 03, 2026

O comando set-props define as propriedades do objeto, incluindo permissões de acesso, classes de armazenamento, metadados e tags.

Precauções

O comando set-props chama diferentes operações de API dependendo da propriedade modificada. Verifique se você tem as permissões necessárias. Por exemplo, chamar a operação de API PutObjectAcl exige a permissão oss:PutObjectAcl. As operações de API específicas chamadas são:

  1. Para modificar apenas a lista de controle de acesso (ACL) do objeto: O comando chama a operação de API PutObjectAcl.

  2. Para modificar apenas as tags do objeto: O comando chama a operação de API PutObjectTagging. Se a instrução de modificação de tag envolver a atualização de tags existentes, como uma adição incremental, o sistema primeiro chama a operação de API GetObjectTagging para recuperar as tags originais.

  3. Para modificar a classe de armazenamento ou os metadados do objeto: Esta operação reescreve o objeto. O comando chama a operação de API CopyObject ou utiliza o fluxo de cópia multipartida (InitiateMultipartUpload -> UploadPartCopy -> CompleteMultipartUpload).

  4. Para modificar várias propriedades simultaneamente: O comando seleciona a combinação mais eficiente de operações de API. Exemplos:

    • Para modificar tanto as permissões quanto as tags do objeto: O comando chama PutObjectAcl e PutObjectTagging.

    • Para modificar tanto as permissões quanto a classe de armazenamento do objeto: O comando chama diretamente a operação de API CopyObject ou as operações de API de cópia multipartida (InitiateMultipartUpload -> UploadPartCopy -> CompleteMultipartUpload) para atualizar as permissões e a classe de armazenamento ao mesmo tempo.

Formato do comando

ossutil set-props oss://bucket[/prefix] [flags]

Parâmetro

Tipo

Descrição

--acl

string

Lista de controle de acesso (ACL) do objeto. Valores válidos:

  • private: privado.

  • public-read: leitura pública.

  • public-read-write: Acesso público de leitura e gravação.

  • default: herda do bucket.

--bigfile-threshold

int

Limiar para ativar upload, download ou cópia multipartida para arquivos grandes. O valor padrão é 104857600 bytes.

--cache-control

string

Especifica o comportamento de cache da página web ao baixar o objeto.

--content-disposition

string

Define como o objeto é exibido.

--content-encoding

string

Indica o formato de codificação do objeto.

--content-type

string

Tipo de conteúdo do objeto.

-d, --dirs

/

Retorna os arquivos e subdiretórios no diretório atual. Não exibe recursivamente todos os arquivos em todos os subdiretórios.

--encoding-type

string

Tipo de codificação do nome do objeto de entrada ou do nome do arquivo. Valor válido: url.

--end-with

string

Ordena os objetos alfabeticamente e retorna aqueles anteriores ou iguais ao valor especificado.

--exclude

stringArray

Regras para excluir caminhos ou nomes de arquivos.

--exclude-from

stringArray

Lê regras de exclusão de um arquivo de regras.

--expires

string

Define o tempo absoluto de expiração para o conteúdo em cache.

--files-from

stringArray

Lê uma lista de nomes de arquivos de origem de um arquivo. Linhas vazias ou comentadas são ignoradas.

--files-from-raw

stringArray

Lê uma lista de nomes de arquivos de origem de um arquivo.

--filter

stringArray

Regras para filtrar caminhos ou nomes de arquivos.

--filter-from

stringArray

Lê regras de filtragem de um arquivo de regras.

-f, --force

/

Força a operação sem solicitar confirmação.

--include

stringArray

Regras para incluir caminhos ou nomes de arquivos.

--include-from

stringArray

Lê regras de inclusão de um arquivo de regras.

-j, --job

int

Número de tarefas concorrentes. O valor padrão é 3.

Importante

Este parâmetro só tem efeito quando você especifica o parâmetro -f, --update, --size-only ou --ignore-existing.

--list-objects

/

Utiliza a operação de API ListObjects para listar objetos.

--max-size

SizeSuffix

Tamanho máximo de um arquivo a ser transferido. A unidade padrão é byte. É possível usar um sufixo: B, K, M, G, T ou P. 1 K (KiB) = 1024 B.

--metadata

strings

Especifica os metadados do usuário do objeto no formato chave=valor.

Exemplo: --metadata test=value,test1=value1.

--metadata-directive

string

Instrução para modificar metadados. Valores válidos:

  • replace: Mantém apenas os metadados especificados nas opções de linha de comando.

  • update: Faz a união dos metadados da linha de comando com os metadados do objeto.

  • purge: Limpa todos os metadados.

  • delete: Exclui os metadados especificados nas opções de linha de comando e mantém o restante.

--metadata-exclude

stringArray

Regras para excluir metadados do objeto.

--metadata-filter

stringArray

Regras para filtrar metadados do objeto.

--metadata-filter-from

stringArray

Lê regras de filtragem de metadados do objeto de um arquivo de regras.

--metadata-include

stringArray

Regras para incluir metadados do objeto.

--min-age

Duration

Define propriedades apenas para arquivos modificados antes do intervalo de tempo especificado. A unidade padrão é segundo. É possível usar um sufixo de unidade, como 1h para 1 hora.

Nota

--min-age 1h define propriedades apenas para arquivos modificados há 1 hora ou mais.

--max-age

Duration

Define propriedades apenas para arquivos modificados dentro do intervalo de tempo especificado. A unidade padrão é segundo. É possível usar um sufixo de unidade, como 1h para 1 hora.

Nota

--max-age 1h define propriedades apenas para arquivos modificados na última hora.

--min-mtime

Time

Define propriedades apenas para arquivos modificados após o horário especificado. O horário deve estar no formato UTC. Por exemplo, 2006-01-02T15:04:05.

Nota

--min-mtime "2006-01-02T15:04:05" define propriedades apenas para arquivos modificados após as 15:04:05 UTC de 2 de janeiro de 2006.

--max-mtime

Time

Define propriedades apenas para arquivos modificados antes do horário especificado. O horário deve estar no formato UTC. Por exemplo, 2006-01-02T15:04:05.

--min-size

SizeSuffix

Tamanho mínimo de um arquivo a ser transferido. A unidade padrão é byte. É possível usar um sufixo: B, K, M, G, T ou P. 1 K (KiB) = 1024 B.

--no-progress

/

Não exibe a barra de progresso.

--page-size

int

Número máximo de objetos a serem listados em cada página durante o processamento em lote. O valor padrão é 1000. O valor pode variar de 1 a 1000.

--parallel

int

Número de tarefas concorrentes para operações em um único arquivo.

--part-size

SizeSuffix

Tamanho da parte. Por padrão, o ossutil calcula um tamanho de parte apropriado com base no tamanho do arquivo. O valor deve estar entre 100 KiB e 5 GiB.

-r, --recursive

/

Executa a operação recursivamente. Ao especificar esta opção, o comando aplica-se a todos os objetos correspondentes no bucket. Caso contrário, aplica-se apenas ao objeto especificado pelo caminho.

--request-payer

string

Método de pagamento da solicitação. Defina este parâmetro se você usar o modo de pagamento pelo solicitante. Valor válido: requester.

--start-after

string

Ordena os objetos alfabeticamente e retorna aqueles posteriores ao valor especificado.

--storage-class

string

Classe de armazenamento do objeto. Valores válidos:

  • Standard: Padrão.

  • IA: Acesso Pouco Frequente.

  • Archive: Armazenamento de Arquivo.

  • ColdArchive: Arquivo Frio.

  • DeepColdArchive: Arquivo Frio Profundo.

--tagging

strings

Especifica as tags do objeto no formato chave=valor.

Exemplo: --tagging tag1=value1,tag2=value2.

--tagging-directive

string

Instrução para modificar tags. Valores válidos:

  • replace: Mantém apenas as tags especificadas nas opções de linha de comando.

  • update: Faz a união das tags da linha de comando com as tags do objeto.

  • purge: Limpa todas as tags.

  • delete: Exclui as tags especificadas nas opções de linha de comando e mantém o restante.

--version-id

string

ID da versão do objeto.

--list-format

string

Formato do arquivo de lista. Valores válidos: plain, inventory.

--list-manifest-from

string

Lê a descrição do formato do arquivo de lista de um arquivo. Este parâmetro é obrigatório quando o formato do arquivo de lista é inventory.

Para obter mais informações, consulte Opções de linha de comando.

Exemplos

  • Defina as permissões de acesso de um objeto como privado.

    ossutil set-props oss://examplebucket/exampleobject.txt --acl private
  • Defina a classe de armazenamento de um objeto como Archive Storage.

    ossutil set-props oss://examplebucket/exampleobject.txt --storage-class Archive
  • Para objetos com a extensão .txt, altere o content-type para text/plain.

    ossutil set-props oss://bucket/prefix --content-type text/plain --include "*.txt" --metadata-directive update -r
  • Defina as tags de um objeto.

    ossutil set-props oss://examplebucket/exampleobject.txt --tagging tag1=value1 --tagging-directive update
  • Defina propriedades do objeto a partir de um arquivo de lista.

    Nota

    Cada linha no arquivo de lista representa um objeto e usa o formato de caminho do OSS oss://{bucket}/{key}. Por exemplo, o arquivo list.txt contém o seguinte conteúdo:

    oss://examplebucket/key1
    oss://examplebucket/key2
    ossutil set-props list://list.txt 
  • Defina propriedades do objeto a partir de um arquivo de manifesto.

    Nota

    Após executar uma tarefa de inventário, um arquivo csv.gz e um arquivo manifest.json são gerados nos resultados do inventário. Use esses dois arquivos para definir as propriedades do objeto a partir de um arquivo de manifesto.

    ossutil set-props list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json