Tous les produits
Search
Centre de documentation

Object Storage Service:ExtendBucketWorm

Dernière mise à jour :Aug 18, 2026

Prolonge la période de rétention des objets d'un bucket dont la politique de rétention est verrouillée.

Remarque

Si l'ID de politique de rétention spécifié n'existe pas, OSS renvoie le code d'état HTTP 404.

Notes d'utilisation

Par défaut, une politique de rétention basée sur le temps passe à l'état InProgress après sa création pour un bucket. Cet état reste valide pendant 24 heures. Durant cette période, la politique de rétention protège les données du bucket.

  • Dans les 24 heures suivant l'activation de la politique de rétention : si la politique n'est pas verrouillée, le propriétaire du bucket et les utilisateurs autorisés peuvent la supprimer. Si la politique est verrouillée, il est impossible de réduire la période de protection ou de supprimer la politique. Vous pouvez uniquement prolonger la période de protection.

  • 24 heures après l'activation de la politique de rétention : si la politique n'est pas verrouillée, elle devient invalide.

Si un bucket contient des objets encore sous période de protection, vous ne pouvez pas supprimer le bucket ni sa politique de rétention. La suppression d'un bucket entraîne également celle de sa politique de rétention. Seul le propriétaire du bucket peut supprimer un bucket vide.

Éléments de la requête

Élément

Type

Obligatoire

Exemple

Description

ExtendWormConfiguration

Conteneur

Oui

S/O

L'élément racine.

Nœuds enfants : RetentionPeriodInDays

wormId

Chaîne

Oui

1666E2CFB2B3418****

ID de la politique de rétention, généré automatiquement lors de l'appel à l'opération InitiateBucketWorm.

RetentionPeriodInDays

Entier positif

Oui

366

Nombre de jours de rétention des objets.

Valeurs valides : 1 à 25550.

Exemples

  • Exemple de requête

    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>
  • Exemple de réponse

    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

SDK OSS

Appelez l'opération ExtendBucketWorm à l'aide des SDK OSS pour les langages de programmation suivants :

ossutil

Pour plus d'informations sur la commande ossutil correspondant à l'opération ExtendBucketWorm, consultez extend-bucket-worm.