How do I extend the retention period of objects in a bucket? - Object Storage Service

Notes d'utilisation

Pour prolonger la période de rétention des objets dans un compartiment, vous devez disposer de l'autorisation oss:ExtendBucketWorm. Pour plus d'informations, consultez la section Grant a custom policy.
Par défaut, une politique basée sur le temps passe à l'état InProgress après sa création pour un compartiment. Elle reste dans cet état pendant 24 heures. Durant cette période, la politique de rétention protège les données du compartiment.
- 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 compartiment et les utilisateurs autorisés peuvent la supprimer. Si la politique est verrouillée, elle ne peut pas être supprimée et seule la période de rétention spécifiée peut être prolongée.
- 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 compartiment contient des objets sous protection, vous ne pouvez pas supprimer le compartiment ni sa politique de rétention. La suppression d'un compartiment entraîne également la suppression de sa politique de rétention. Seul le propriétaire du compartiment peut supprimer un compartiment vide.

Syntaxe de la commande

 ossutil api extend-bucket-worm --bucket value --worm-id value --extend-worm-configuration value [flags]

Paramètre

Type

Description

--bucket

string

Nom du compartiment.

--extend-worm-configuration

string

Conteneur stockant les configurations de la politique de rétention.

--worm-id

string

ID de la politique de rétention.

--extend-worm-configuration

L'option --extend-worm-configuration prend en charge les formats XML et JSON. Si la valeur de l'option contient le préfixe « file:// », ossutil lit les configurations à partir du fichier spécifié.

Format XML :

<ExtendWormConfiguration>
  <RetentionPeriodInDays>integer</RetentionPeriodInDays>
</ExtendWormConfiguration>

Format JSON :
```
{
  "RetentionPeriodInDays": integer
}
```

Remarque

Pour plus d'informations, consultez la section Command-line options.

Exemples

Prolongez à 366 jours la période de rétention des objets protégés par la politique de rétention « 123 ».

Utilisez un fichier de configuration XML (extend-worm-configuration.xml dans cet exemple)

<?xml version="1.0" encoding="UTF-8"?>
<ExtendWormConfiguration>
  <RetentionPeriodInDays>366</RetentionPeriodInDays>
</ExtendWormConfiguration>

Exemple de commande :

ossutil api extend-bucket-worm --bucket examplebucket --worm-id 123 --extend-worm-configuration file://extend-worm-configuration.xml

Utilisez un fichier de configuration JSON (extend-worm-configuration.json dans cet exemple)

{
        "RetentionPeriodInDays": "366"
}

Exemple de commande :

ossutil api extend-bucket-worm --bucket examplebucket --worm-id 123 --extend-worm-configuration file://extend-worm-configuration.json

Utilisez des paramètres JSON directement dans la ligne de commande

ossutil api extend-bucket-worm --bucket examplebucket --worm-id 123 --extend-worm-configuration " "{\"RetentionPeriodInDays\":\"366\"}""