Todos os produtos
Search
Central de documentação

Object Storage Service:ExtendBucketWorm

Última atualização: Jun 23, 2026

Estende o período de retenção de objetos em um bucket cuja política de retenção está bloqueada.

null

Se o ID da política de retenção especificado não existir, o oss retornará o código de status HTTP 404.

Notas de uso

Por padrão, uma política de retenção baseada em tempo assume o estado InProgress após a sua criação para um bucket. Esse estado permanece válido por 24 horas. Durante esse período, a política de retenção protege os dados no bucket.

  • Na janela de 24 horas após a ativação da política de retenção: se a política não estiver bloqueada, o proprietário do bucket e os usuários autorizados podem exclua. Se a política estiver bloqueada, não é possível reduzir o período de proteção nem exclua a política. É possível apenas prolongar o período de proteção.

  • Após 24 horas da ativação da política de retenção: se a política não estiver bloqueada, ela se tornará inválida.

Se um bucket contiver objetos dentro do período de proteção, não exclua o bucket nem sua política de retenção. Ao exclua um bucket, o sistema também exclua a política de retenção associada a ele. O proprietário do bucket só pode exclua quando o bucket estiver vazio.

Elementos da requisição

Elemento

Tipo

Obrigatório

Exemplo

Descrição

ExtendWormConfiguration

Container

Sim

N/A

O elemento raiz.

Nós filhos: RetentionPeriodInDays

wormId

String

Sim

1666E2CFB2B3418****

O ID da política de retenção, que o sistema gera automaticamente quando você chama a operação InitiateBucketWorm.

RetentionPeriodInDays

Inteiro positivo

Sim

366

O número de dias para reter os objetos.

Valores válidos: 1 a 25550.

Exemplos

  • Exemplos de requisições

    POST /?wormId=1666E2CFB2B3418****&wormExtend HTTP/1.1
    Date: Thu, 17 Apr 2025 11:18:32 GMT
    Host: BucketName.oss.aliyuncs.com
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e 
    
    <ExtendWormConfiguration>
      <RetentionPeriodInDays>366</RetentionPeriodInDays>
    </ExtendWormConfiguration>
  • Exemplos de respostas

    HTTP/1.1 200 OK
    Server: AliyunOSS
    Date: Thu, 15 May 2014 11:18:32 GMT
    Content-Length: 0
    Connection: keep-alive
    x-oss-request-id: 5C06A3B67B8B5A3DA422299D
    x-oss-server-time: 122

SDKs do oss

Você pode chamar a operação ExtendBucketWorm usando os SDKs do oss para as seguintes linguagens de programação:

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação ExtendBucketWorm, consulte extend-bucket-worm.