Récupère la politique de conservation configurée pour un bucket donné.
Si la politique de conservation identifiée par l'ID fourni dans la requête n'existe pas, OSS renvoie une erreur 404.
Notes d'utilisation
OSS prend en charge la stratégie WORM (Write Once Read Many), qui interdit la suppression ou l'écrasement des objets pendant une période définie. Vous pouvez configurer une politique de conservation temporelle pour un bucket, avec une durée allant d'un jour à 70 ans.
Une fois la politique de conservation d'un bucket verrouillée, vous pouvez lire ou charger des objets depuis ce bucket. Toutefois, il est impossible de supprimer les objets ou la politique de conservation avant l'expiration de la période de conservation. La suppression des objets n'est autorisée qu'après l'écoulement de cette période.
En-têtes de requête
Une requête GetBucketWorm ne contient que des en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes de requête communs.
En-têtes de réponse
La réponse à une requête GetBucketWorm ne contient que des en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes de réponse communs.
Éléments de réponse
|
Élément |
Type |
Description |
|
WormConfiguration |
Conteneur |
Nœud racine. Nœuds enfants : WormId, State, RetentionPeriodInDays et CreationDate |
|
WormId |
Chaîne |
ID de la politique de conservation. |
|
State |
Chaîne |
État de la politique de conservation. Valeurs valides :
|
|
RetentionPeriodInDays |
Entier positif |
Nombre de jours de conservation des objets. |
|
CreationDate |
Chaîne |
Date et heure de création de la politique de conservation. |
Exemples
-
Exemple de requête
GET /? worm HTTP/1.1 Date: Fri, 16 Oct 2020 11:18:32 GMT Host: BucketName.oss.aliyuncs.com Authorization: SignatureValue -
Exemple de réponse
HTTP/1.1 200 OK x-oss-request-id: 5374A2880232A65C2300**** Date: Fri, 16 Oct 2020 11:18:32 GMT Content-Type: application/xml Content-Length: length <WormConfiguration> <WormId>1666E2CFB2B3418****</WormId> <State>Locked</State> <RetentionPeriodInDays>1</RetentionPeriodInDays> <CreationDate>2020-10-15T15:50:32</CreationDate> </WormConfiguration>
SDK OSS
Les SDK OSS suivants prennent en charge l'opération GetBucketWorm :
ossutil
Pour la commande ossutil correspondant à l'opération GetBucketWorm, consultez la section get-bucket-worm.