Object Storage Service:worm (retention policy)

Remarques d'utilisation

• Autorisations requises : oss:InitiateBucketWorm pour créer, oss:CompleteBucketWorm pour verrouiller, oss:ExtendBucketWorm pour étendre, oss:GetBucketWorm pour interroger et oss:AbortBucketWorm pour supprimer une politique de rétention. Attacher une stratégie personnalisée à un utilisateur RAM.

• Pour ossutil 1.6.16 et versions ultérieures, utilisez directement ossutil comme commande. Pour les versions antérieures à la 1.6.16, utilisez le nom binaire correspondant à votre système d'exploitation. Pour plus d'informations, consultez la section Référence des commandes ossutil.

• La rubrique Politiques de rétention décrit le cycle de vie WORM.

Créer et verrouiller une politique de rétention

Créez une politique de rétention pour un bucket et verrouillez-la.

1. Créer une politique de rétention

   • Syntaxe de la commande

     ossutil worm init oss://BucketName days

     Paramètres :

     Parameter	Description
     BucketName	Le nom du bucket cible.
     days	La période de rétention en jours. Les objets du bucket ne peuvent pas être modifiés ni supprimés pendant cette période. Unité : jour Valeurs valides : 1 à 25550

   • Exemples

     Créez une politique de rétention pour le bucket examplebucket avec une période de rétention de 180 jours.

     ossutil worm init oss://examplebucket 180

     Exemple de sortie :

     init success,worm id is 581D8A7FFA064C80827CAB4076A93A78

2. Verrouiller la politique de rétention

   • Syntaxe de la commande

     ossutil worm complete oss://BucketName WormId

     Paramètres :

     Parameter	Description
     BucketName	Le nom du bucket cible.
     WormId	L'ID renvoyé lors de la création de la politique de rétention.

   • Exemples

     Verrouillez la politique de rétention pour le bucket examplebucket.

     ossutil worm complete oss://examplebucket 581D8A7FFA064C80827CAB4076A93A78

     Exemple de sortie :

     0.073810(s) elapsed

Étendre la période de rétention

Une fois la politique de rétention verrouillée, les objets ne peuvent pas être modifiés ni supprimés avant l'expiration de la période de rétention. Vous pouvez étendre cette période si nécessaire.

• Syntaxe de la commande

  ossutil worm extend oss://BucketName days WormId

• Exemples

  Étendez la période de rétention de examplebucket à 360 jours.

  ossutil worm extend oss://examplebucket 360 581D8A7FFA064C80827CAB4076A93A78

  Exemple de sortie :

  0.067810(s) elapsed

Interroger une politique de rétention

Récupérez la configuration de la politique de rétention d'un bucket.

• Syntaxe de la commande

  ossutil worm get oss://BucketName

• Exemples

  Interrogez la politique de rétention du bucket examplebucket.

  ossutil worm get oss://examplebucket

  Exemple de sortie :

  <WormConfiguration>
        <WormId>581D8A7FFA064C80827CAB4076A93A78</WormId>
        <State>Locked</State>
        <RetentionPeriodInDays>360</RetentionPeriodInDays>
        <CreationDate>2021-01-19T03:36:53.000Z</CreationDate>
    </WormConfiguration>

Supprimer une politique de rétention

Supprimez une politique de rétention avant qu'elle ne soit verrouillée.

• Syntaxe de la commande

  ossutil worm abort oss://BucketName

• Exemples

  Supprimez la politique de rétention du bucket examplebucket.

  ossutil worm abort oss://examplebucket

  Exemple de sortie :

  0.067810(s) elapsed

Options courantes

Pour accéder à un bucket situé dans une autre région, utilisez -e pour spécifier l'endpoint. Pour accéder à un bucket appartenant à un autre compte Alibaba Cloud, utilisez -i pour l'AccessKey ID et -k pour l'AccessKey Secret.

ossutil worm init oss://test -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Options courantes.