Todos os produtos
Search
Central de documentação

Object Storage Service:Consultar a política de retenção configurada para um bucket

Última atualização: Jul 03, 2026

Consulta a política de retenção configurada para um bucket.

Observações de uso

  • Para consultar a política de retenção de um bucket, você precisa da permissão oss:GetBucketWorm. Para mais informações, consulte Conceder uma política personalizada.

  • O OSS oferece suporte à estratégia Write Once Read Many (WORM), que impede a exclusão ou substituição de objetos por um período determinado. Configure uma política de retenção baseada em tempo para um bucket com períodos de um dia a 70 anos.

  • Após o bloqueio da política de retenção do bucket, ainda é possível ler ou fazer upload de objetos. No entanto, não exclua os objetos nem a política de retenção durante o período de vigência. A exclusão dos objetos só é permitida após o término desse período.

Sintaxe do comando

ossutil api get-bucket-worm --bucket value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

Nota

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

Exemplos

  • Consulte a política de retenção configurada para o bucket examplebucket.

    ossutil api get-bucket-worm --bucket examplebucket
  • Obtenha a política de retenção do bucket examplebucket e formate a saída em JSON.

    ossutil api get-bucket-worm --bucket examplebucket --output-format json
  • Recupere a política de retenção do bucket examplebucket com a saída formatada em YAML.

    ossutil api get-bucket-worm --bucket examplebucket --output-format yaml