Documentation Oracle Cloud Infrastructure

Création d'une règle de conservation des données 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 l'administrateur de location ou le support technique Oracle ne peut pas supprimer une règle verrouillée. Il existe un délai de 14 jours obligatoire avant qu'une règle ne soit verrouillée. Ce délai vous permet de tester, de mettre à jour 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 permet uniquement de contrôler 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 trouver la page de liste ou le bucket, reportez-vous à Liste des buckets.
    2. Sur la page de détails, sélectionnez Stratégies et recherchez la section Règles de conservation.
    3. Sélectionnez Créer une règle.
    4. Entrez 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 règle de Conservation : sélectionnez le type de règle de Conservation à créer :

        • Les règles liées au moment 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 individuellement et dépend de l'horodatage de la dernière modification de l'objet. 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 temporelle uniquement) entrez des valeurs pour la durée Durée de conservation et l'unité de temps Unité de durée de conservation en jours ou en 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 la conservation est autorisée. Cette règle peut être supprimée uniquement par la suppression du bucket. Un bucket doit être vide pour être supprimé.

    5. Sélectionnez Créer une règle.
    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"
}

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

    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.

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