Estende o período de retenção de objetos em um bucket cuja política de retenção está bloqueada.
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.