Object Storage Service:set-props (Definir propriedades de objetos)

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: Leitura e gravação públicas.

• default: herda do bucket.

--bigfile-threshold

SizeSuffix

Limiar de tamanho de objeto para upload, download ou cópia multipart. Objetos maiores que o limiar usam cópia multipart. Valor padrão: 100 MiB. Sufixos suportados: B, K, M, G, T e P.

--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 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 source a partir de um arquivo. Linhas vazias ou comentadas são ignoradas.

--files-from-raw

stringArray

Lê uma lista de nomes de arquivos de source a partir 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.

--list-objects

/

Usa 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 da 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 da linha de comando e mantém o restante.

--metadata-exclude

stringArray

Regras para excluir metadados de objetos.

--metadata-filter

stringArray

Regras para filtrar metadados de objetos.

--metadata-filter-from

stringArray

Lê regras de filtragem de metadados de objetos de um arquivo de regras.

--metadata-include

stringArray

Regras para incluir metadados de objetos.

--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.

--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.

--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.

--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 o tamanho da parte com base no tamanho do objeto. Partes maiores reduzem o número de requisições UploadPartCopy. Intervalo válido: 100 KiB a 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, o comando aplica-se apenas ao objeto especificado pelo caminho.

--request-payer

string

Método de pagamento da requisição. Defina este parâmetro se você usar o modo pay-by-requester. 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: Standard.

• IA: Infrequent Access.

• Archive: Archive Storage.

• ColdArchive: Cold Archive.

• DeepColdArchive: Deep Cold Archive.

--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 da 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 da 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 a partir de um arquivo. Este parâmetro é obrigatório quando o formato do arquivo de lista é inventory.