Object Storage Service:InitiateBucketWorm

Observações de uso

• O Object Storage Service (OSS) oferece suporte ao recurso Write Once Read Many (WORM), que impede a exclusão ou modificação de dados. Defina uma política de retenção baseada em tempo para um bucket com período de 1 dia a 70 anos.

• Se a política de retenção baseada em tempo não for bloqueada em até 24 horas após a criação, ela se tornará inválida automaticamente. Após o bloqueio da política, faça upload e leitura de objetos no bucket. No entanto, não exclua os objetos nem a política até que o período de retenção expire. Para mais informações sobre políticas de retenção, consulte Políticas de retenção.

• Configure versionamento e uma política de retenção no mesmo bucket. O bucket deve ter o versionamento ativado.

• As políticas de retenção no nível do bucket (BucketWorm) e no nível do objeto (ObjectWorm) são mutuamente exclusivas. Ative apenas um tipo de política de retenção por bucket.

Elementos da solicitação

SDKs

Esta API está disponível nos seguintes SDKs:

• Java

• Python V2

• Go V2

• Node.js

• C++

• PHP V2

ossutil

Para obter informações sobre o comando correspondente do ossutil, consulte initiate-bucket-worm.

Exemplos

• Exemplo de solicitação

  POST /?worm HTTP/1.1
  Date: Thu, 17 Apr 2025 11:18:32 GMT
  Content-Length: 556
  Content-Type: application/xml
  Host: BucketName.oss.aliyuncs.com
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  
  <InitiateWormConfiguration>
    <RetentionPeriodInDays>365</RetentionPeriodInDays>
  </InitiateWormConfiguration>

• Exemplo de resposta

  HTTP/1.1 200 OK
  x-oss-request-id: 5374A2880232A65C2300****
  x-oss-worm-id: 1666E2CFB2B3418****
  Date: Thu, 15 May 2014 11:18:32 GMT