Création d'une règle de conservation Object Storage
Créez une règle de conservation pour un bucket Object Storage.
La règle est affichée dans la liste Règles de conservation.
Utilisez la commande oci os retention-rule create et les paramètres requis afin de créer une règle de conservation pour un bucket :
oci os retention-rule create --bucket-name bucket_name [OPTIONS]
Par exemple :
oci os retention-rule create --display-name LegalHold { "data": { "duration": null, "etag": "7f51ef6c-3fca-48f7-9060-c129911c1a50", "id": "5772c87f-6723-4ecc-b44c-bef86643be92", "time-created": "2020-03-25T14:53:20.792000+00:00", "time-modified": "2020-03-25T14:53:20.792000+00:00", "time-rule-locked": null }, "etag": "7f51ef6c-3fca-48f7-9060-c129911c1a50" }
Donner un nom d'affichage à la règle de conservation
Incluez le paramètre
display-name
afin d'attribuer un nom spécifié par l'utilisateur à la règle de conservation. Les noms peuvent être utiles pour identifier les règles de conservation. Par exemple :oci os retention-rule create --bucket-name MyBucket --display-name LegalHold { "data": { "display-name": "LegalHold", "duration": null, "etag": "7f51ef6c-3fca-48f7-9060-c129911c1a50", "id": "5772c87f-6723-4ecc-b44c-bef86643be92", "time-created": "2020-03-25T14:53:20.792000+00:00", "time-modified": "2020-03-25T14:53:20.792000+00:00", "time-rule-locked": null }, "etag": "7f51ef6c-3fca-48f7-9060-c129911c1a50" }
Création d'une règle de conservation liée au temps
Incluez les paramètres
time-amount
ettime-unit
pour définir une période en jours ou en années pour la durée d'application de la règle de conservation. Par exemple :oci os retention-rule create --bucket-name MyBucket --time-amount 5 --time-unit days { "data": { "duration": { "time-amount": 5, "time-unit": "DAYS" }, "etag": "efb9178f-4213-49f7-878d-7bbe57decc0b", "id": "89f4ca0c-4ad9-4fa5-8005-95e7741c531c", "time-created": "2020-03-25T15:08:01.601000+00:00", "time-modified": "2020-03-25T15:08:01.601000+00:00", "time-rule-locked": null }, "etag": "efb9178f-4213-49f7-878d-7bbe57decc0b" }
Si vous n'indiquez pas de quantité et d'unité de temps, il n'y a pas de limite de temps et les objets du bucket sont conservés indéfiniment.
Verrouillage de la règle de conservation
Incluez le paramètre
time-rule-locked
et un horodatage de date après lequel cette règle est verrouillée. Vous pouvez uniquement la supprimer en supprimant le bucket. Par exemple :oci os retention-rule create --bucket-name MyBucket --time-rule-locked 2017-09-15T20:30:00.123Z { "data": { "etag": "efb9178f-4213-49f7-878d-7bbe57decc0b", "id": "89f4ca0c-4ad9-4fa5-8005-95e7741c531c", "time-created": "2020-03-25T15:08:01.601000+00:00", "time-modified": "2020-03-25T15:08:01.601000+00:00", "time-rule-locked": 2017-09-15T20:30:00.123Z }, "etag": "efb9178f-4213-49f7-878d-7bbe57decc0b" }
Reportez-vous à oci os retention-rule create pour connaître les formats d'horodatage de date pris en charge que vous pouvez utiliser avec ce paramètre.
Une fois qu'une règle est verrouillée, seules les augmentations de durée sont autorisées et aucune autre propriété ne peut être modifiée. Vous ne pouvez pas mettre à jour cette propriété pour les règles dont l'état est verrouillé. Le fait de le spécifier lorsqu'aucune durée n'est spécifiée est considéré comme une erreur.
Afin d'obtenir la liste complète des paramètres et des valeurs pour les commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'CLI.
Exécutez l'opération CreateRetentionRule afin de créer une règle de conservation pour un bucket.