Prolonge la période de rétention des objets d'un bucket dont la politique de rétention est verrouillée.
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.