Todos os produtos
Search
Central de documentação

Object Storage Service:GetBucketWorm

Última atualização: Jul 03, 2026

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

Nota

Se a política de retenção especificada pelo ID na solicitação não existir, o OSS retornará 404.

Notas de uso

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 de um bucket, ainda é possível ler ou enviar objetos para ele. No entanto, nem os objetos nem a política de retenção podem ser excluídos durante o período de vigência. A exclusão dos objetos só é permitida após o término desse período.

Cabeçalhos da solicitação

Uma solicitação GetBucketWorm contém apenas cabeçalhos comuns de solicitação. Para mais informações, consulte Cabeçalhos comuns de solicitação.

Cabeçalhos da resposta

A resposta a uma solicitação GetBucketWorm contém apenas cabeçalhos comuns de resposta. Para mais informações, consulte Cabeçalhos comuns de resposta.

Elementos da resposta

Elemento

Tipo

Descrição

WormConfiguration

Container

Nó raiz.

Nós filhos: WormId, State, RetentionPeriodInDays e CreationDate.

WormId

String

ID da política de retenção.

State

String

Status da política de retenção.

Valores válidos:

  • InProgress: a política de retenção foi criada, mas ainda não está bloqueada. Por padrão, uma nova política entra no estado InProgress após a criação e permanece válida por 24 horas.

  • Locked: a política de retenção está bloqueada.

RetentionPeriodInDays

Inteiro positivo

Número de dias de retenção dos objetos.

CreationDate

String

Data e hora de criação da política de retenção.

Exemplos

  • Exemplo de solicitação

    GET /? worm HTTP/1.1
    Date: Fri, 16 Oct 2020 11:18:32 GMT
    Host: BucketName.oss.aliyuncs.com
    Authorization: SignatureValue
  • Exemplo de resposta

    HTTP/1.1 200 OK
    x-oss-request-id: 5374A2880232A65C2300****
    Date: Fri, 16 Oct 2020 11:18:32 GMT
    Content-Type: application/xml
    Content-Length: length
    <WormConfiguration>
      <WormId>1666E2CFB2B3418****</WormId>
      <State>Locked</State>
      <RetentionPeriodInDays>1</RetentionPeriodInDays>
      <CreationDate>2020-10-15T15:50:32</CreationDate>
    </WormConfiguration>

SDKs do OSS

Os seguintes SDKs do OSS oferecem suporte à operação GetBucketWorm:

ossutil

Para obter o comando do ossutil correspondente à operação GetBucketWorm, consulte get-bucket-worm.