Documentation Oracle Cloud Infrastructure

Création d'une règle de conservation Object Storage

Créez une règle de conservation pour un bucket Object Storage.

Important

Le verrouillage d'une règle de conservation est une opération irréversible. Même les administrateurs de location ou le support technique Oracle ne peuvent pas supprimer une règle verrouillée. Le verrouillage d'une règle s'effectue au bout d'un délai obligatoire de 14 jours. Ce délai vous permet de tester en profondeur, de modifier ou de supprimer la règle ou son verrouillage avant qu'elle ne soit définitivement verrouillée.

Une règle est active au moment de la création. Le verrouillage contrôle uniquement si la règle elle-même peut être modifiée. Une fois qu'une règle est verrouillée, seules les augmentations de durée sont autorisées. Les modifications d'objet sont bloquées et la règle ne peut être supprimée que par la suppression du bucket. Vous ne pouvez supprimer un bucket que s'il est vide.

Nous vous recommandons de configurer des avis pour vous-même pendant 7 jours et 3 jours avant la fin de la période de 14 jours pour supprimer la règle si vous n'êtes pas sûr de l'utiliser.

    1. Sur la page de liste Buckets, sélectionnez le bucket Object Storage à utiliser. Si vous avez besoin d'aide pour rechercher la page de liste ou le bucket Object Storage, reportez-vous à Liste des buckets.
    2. Sur la page de détails, sélectionnez Règles de conservation.
    3. Sélectionnez Créer une règle.
    4. Saisissez les informations suivantes:

      • Nom : entrez un nom pour la règle. Le système génère un nom de règle qui reflète l'année, le mois, le jour et l'heure en cours, par exemple, retention-rule-2020229-1002. Si vous modifiez ce nom, utilisez des lettres, des chiffres, des tirets, des traits de soulignement et des points.

      • Type de conservation : sélectionnez le type de règle de conservation à créer :

        • Les règles liées au temps ont une durée définie par l'utilisateur. Les modifications d'objet sont bloquées pendant la durée indiquée. La durée est appliquée à chaque objet et dépend de l'horodatage Dernière modification de celui-ci. Entrez les valeurs des paramètres de durée de conservation qui s'affichent.

        • Les règles indéfinies n'ont ni durée ni délai d'expiration. Les modifications d'objet sont bloquées tant que la règle indéfinie n'est pas supprimée.

      • Durée de conservation : (règles de type Limite de temps uniquement) entrez des valeurs pour le montant de temps de durée de conservation et l'unité de temps de unité de temps de conservation en jours ou années.

      • Activer le verrouillage de la règle de conservation : (facultatif) cochez la case pour verrouiller la règle. Lorsqu'une règle est verrouillée, seule une augmentation de la durée de conservation est autorisée. Vous pouvez supprimer la règle uniquement en supprimant le bucket. Un bucket doit être vide pour être supprimé.

    5. Sélectionnez Créer.

    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 et time-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.

    Pour obtenir la liste complète des paramètres et des valeurs des commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'interface de ligne de commande.

  • Exécutez l'opération CreateRetentionRule afin de créer une règle de conservation pour un bucket.