Object Storage Service:InitiateBucketWorm

Notes d'utilisation

• Object Storage Service (OSS) prend en charge la fonctionnalité Write Once Read Many (WORM). Cette fonctionnalité empêche la suppression ou la modification des données. Vous pouvez définir une politique de rétention temporelle pour un bucket. La période de rétention peut varier de 1 jour à 70 ans.

• Si vous ne verrouillez pas une politique de rétention temporelle dans les 24 heures suivant sa création, elle devient automatiquement invalide. Une fois la politique de rétention verrouillée, vous pouvez télécharger des objets vers le bucket et les lire. Toutefois, vous ne pouvez pas supprimer les objets ni la politique de rétention avant l'expiration de la période de rétention. Pour plus d'informations sur les politiques de rétention, consultez Politiques de rétention.

• Vous pouvez configurer le versioning et une politique de rétention pour le même bucket. Le versioning doit être activé sur le bucket.

• Les politiques de rétention au niveau du bucket (BucketWorm) et les politiques de rétention au niveau de l'objet (ObjectWorm) s'excluent mutuellement. Vous ne pouvez activer qu'un seul type de politique de rétention pour un bucket.

Éléments de la requête

SDK

Les SDK suivants sont disponibles pour cette API :

• Java

• Python V2

• Go V2

• Node.js

• C++

• PHP V2

ossutil

Pour obtenir des informations sur la commande ossutil correspondante, consultez initiate-bucket-worm.

Exemples

• Exemple de requête

  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>

• Exemple de réponse

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