Gérer les cycles de vie des objets

Cette page explique comment activer la gestion du cycle de vie des objets et présente des exemples de règles de cycle de vie. Pour obtenir une description de cette fonctionnalité, y compris des actions et conditions autorisées, consultez la page Gestion du cycle de vie des objets.

Configurer la gestion du cycle de vie sur un bucket

Activer la gestion du cycle de vie

Pour activer la gestion du cycle de vie d'un bucket, procédez comme suit :

Console

  1. Ouvrez le navigateur Cloud Storage dans la console Google Cloud Platform.
    Ouvrir le navigateur Cloud Storage
  2. Dans la liste de buckets, recherchez le bucket à activer, puis cliquez sur Aucun dans la colonne Cycle de vie.

    La page des règles de cycle de vie s'affiche.

  3. Cliquez sur Ajouter une règle.

  4. Dans la page qui s'affiche, spécifiez une configuration.

    1. Sélectionnez la ou les conditions dans lesquelles une action est effectuée.

    2. Cliquez sur Continuer.

    3. Sélectionnez l'action à effectuer lorsqu'un objet remplit les conditions.

    4. Cliquez sur Continuer.

    5. Cliquez sur Enregistrer.

gsutil

  1. Créez un fichier .json contenant les règles de configuration du cycle de vie que vous souhaitez appliquer (voir les exemples ci-dessous).

  2. Exécutez la commande lifecycle set pour appliquer la configuration, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :

    gsutil lifecycle set [LIFECYCLE_CONFIG_FILE] gs://[BUCKET_NAME]

API REST

API JSON

  1. Obtenez un jeton d'accès d'autorisation sur la page OAuth 2.0 Playground. Configurez Playground de façon à utiliser vos propres identifiants OAuth.
  2. Créez un fichier .json contenant les règles de configuration du cycle de vie que vous souhaitez appliquer (voir les exemples ci-dessous).
  3. Exécutez cURL pour appeler l'API JSON avec une requête PATCH Bucket, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :
    curl -X PATCH --data-binary @[LIFECYCLE_CONFIG_FILE].json \
    -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    -H "Content-Type: application/json" \
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]?fields=lifecycle"

API XML

  1. Obtenez un jeton d'accès d'autorisation sur la page OAuth 2.0 Playground. Configurez Playground de façon à utiliser vos propres identifiants OAuth.
  2. Créez un corps de requête contenant les règles de configuration du cycle de vie que vous souhaitez appliquer (voir les exemples ci-dessous).
  3. Exécutez cURL pour appeler l'API XML avec une requête PUT Bucket, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :
    curl -X PUT --data-binary @[XML_FILE].xml \
    -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    "https://[BUCKET_NAME].storage.googleapis.com/?lifecycle"

Désactiver la gestion du cycle de vie

Pour désactiver la gestion du cycle de vie d'un bucket, procédez comme suit :

Console

  1. Ouvrez le navigateur Cloud Storage dans la console Google Cloud Platform.
    Ouvrir le navigateur Cloud Storage
  2. Dans la liste de buckets, recherchez le bucket que vous souhaitez désactiver, puis cliquez sur Activé dans la colonne Cycle de vie.

    La page des règles de cycle de vie s'affiche.

  3. Cliquez sur Supprimer tout.

  4. Dans la fenêtre de confirmation qui apparaît, cliquez sur Supprimer.

gsutil

  1. Créez un fichier .json contenant une configuration de cycle de vie vide :

    {}
  2. Exécutez la commande lifecycle set, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :

    gsutil lifecycle set [LIFECYCLE_CONFIG_FILE] gs://[BUCKET_NAME]

API REST

API JSON

  1. Obtenez un jeton d'accès d'autorisation sur la page OAuth 2.0 Playground. Configurez Playground de façon à utiliser vos propres identifiants OAuth.
  2. Créez un fichier .json contenant une configuration de cycle de vie vide :
    {}
  3. Exécutez cURL pour appeler l'API JSON avec une requête PATCH Bucket, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :
    curl -X PATCH --data-binary @[LIFECYCLE_CONFIG_FILE].json \
    -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    -H "Content-Type: application/json" \
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]?fields=lifecycle"

API XML

  1. Obtenez un jeton d'accès d'autorisation sur la page OAuth 2.0 Playground. Configurez Playground de façon à utiliser vos propres identifiants OAuth.
  2. Créez un corps de requête contenant une configuration de cycle de vie vide :
    <?xml version="1.0" encoding="UTF-8" ?>
    <LifecycleConfiguration/>
  3. Exécutez cURL pour appeler l'API XML avec une requête PUT Bucket, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :
    curl -X PUT --data-binary @[XML_FILE].xml \
    -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    "https://[BUCKET_NAME].storage.googleapis.com/?lifecycle"

Vérifier la configuration du cycle de vie

Pour vérifier la configuration du cycle de vie définie sur un bucket, procédez comme suit :

Console

  1. Ouvrez le navigateur Cloud Storage dans la console Google Cloud Platform.
    Ouvrir le navigateur Cloud Storage
  2. Dans la liste de buckets, l'état du cycle de vie de chaque bucket se trouve dans la colonne Cycle de vie.

    Cliquez sur cet état pour ajouter, afficher, modifier et supprimer des règles.

gsutil

  1. Exécutez la commande lifecycle get, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :

    gsutil lifecycle get gs://[BUCKET_NAME]

API REST

API JSON

  1. Obtenez un jeton d'accès d'autorisation sur la page OAuth 2.0 Playground. Configurez Playground de façon à utiliser vos propres identifiants OAuth. .
  2. Exécutez cURL pour appeler l'API JSON avec une requête GET Bucket, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :
    curl -X GET -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]?fields=lifecycle"

API XML

  1. Obtenez un jeton d'accès d'autorisation sur la page OAuth 2.0 Playground. Configurez Playground pour utiliser vos propres identifiants OAuth.
  2. Exécutez cURL pour appeler l'API XML avec une requête GET Bucket, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :
    curl -X GET \
        -H "Authorization: Bearer [OAUTH2_TOKEN]" \
        "https://[BUCKET_NAME].storage.googleapis.com/?lifecycle"

Exemples de configuration du cycle de vie des objets

Les exemples suivants illustrent certaines configurations de cycle de vie qui permettent de supprimer des objets et de modifier la classe de stockage d'objets lorsque les conditions communes sont remplies. Pour obtenir une description détaillée des configurations de cycle de vie, y compris la liste des actions et conditions disponibles, reportez-vous à la section Gestion du cycle de vie des objets.

Supprimer un objet

La configuration de cycle de vie suivante définit deux règles :

  1. Supprimer tous les objets actifs de plus de 30 jours.
  2. Supprimer les objets archivés de plus de 10 jours. Notez que cette règle n'est appliquée qu'aux buckets pour lesquels vous avez, ou aviez précédemment activé la gestion des versions d'objet.

Console

La règle suivante supprime les objets actifs de plus de 30 jours :

Supprimer les objets actifs de plus de 30 jours.

La règle suivante supprime les objets archivés de plus de 10 jours :

Supprimer les objets archivés ayant plus de 3 versions plus récentes.

gsutil

La configuration de cycle de vie ci-dessous peut être appliquée à un bucket en activant la gestion du cycle de vie.

{
"lifecycle": {
  "rule": [
  {
    "action": {"type": "Delete"},
    "condition": {
      "age": 30,
      "isLive": true
    }
  },
  {
    "action": {"type": "Delete"},
    "condition": {
      "age": 10,
      "isLive": false
    }
  }
]
}
}

Pour connaître le format généralisé d'un fichier de configuration de cycle de vie, consultez la page représentation des ressources de bucket pour JSON.

API REST

API JSON

La configuration de cycle de vie ci-dessous peut être appliquée à un bucket en activant la gestion du cycle de vie.

{
"lifecycle": {
  "rule": [
  {
    "action": {"type": "Delete"},
    "condition": {
      "age": 30,
      "isLive": true
    }
  },
  {
    "action": {"type": "Delete"},
    "condition": {
      "age": 10,
      "isLive": false
    }
  }
]
}
}

Pour connaître le format généralisé d'un fichier de configuration de cycle de vie, consultez la page représentation des ressources de bucket pour JSON.

API XML

La configuration de cycle de vie ci-dessous peut être appliquée à un bucket en activant la gestion du cycle de vie.

<?xml version="1.0" encoding="UTF-8" ?>
<LifecycleConfiguration>
    <Rule>
        <Action>
            <Delete/>
        </Action>
        <Condition>
            <IsLive>true</IsLive>
            <Age>30</Age>
        </Condition>
    </Rule>
    <Rule>
        <Action>
            <Delete/>
        </Action>
        <Condition>
            <IsLive>false</IsLive>
            <Age>10</Age>
        </Condition>
    </Rule>
</LifecycleConfiguration>

Pour connaître le format généralisé d'un fichier de configuration de cycle de vie, consultez la section relative au format de configuration de cycle de vie pour l'API XML.

Modifier la classe de stockage d'un objet

La configuration de cycle de vie suivante définit deux règles :

  1. Changer la classe de stockage d'un objet pour Stockage Nearline si son âge est supérieur à 365 jours (un an) et si sa classe de stockage actuelle est définie sur Stockage multirégional, Stockage standard ou Stockage DRA.
  2. Changer la classe de stockage d'un objet pour Stockage Coldline si son âge est supérieur à 1 095 jours (trois ans) et si sa classe de stockage actuelle est définie sur Stockage Nearline.

Console

La règle suivante transfère les objets dans un stockage Nearline après 365 jours :

Définir les objets sur un stockage Nearline après 365 jours.

La règle suivante transfère les objets dans un stockage Coldline après 1 095 jours :

Définir des objets sur un stockage Coldline après 1 095 jours.

gsutil

La configuration de cycle de vie ci-dessous peut être appliquée à un bucket en activant la gestion du cycle de vie.

{
"lifecycle": {
  "rule": [
  {
    "action": {
      "type": "SetStorageClass",
      "storageClass": "NEARLINE"
    },
    "condition": {
      "age": 365,
      "matchesStorageClass": ["MULTI_REGIONAL", "STANDARD", "DURABLE_REDUCED_AVAILABILITY"]
    }
  },
  {
    "action": {
      "type": "SetStorageClass",
      "storageClass": "COLDLINE"
    },
    "condition": {
      "age": 1095,
      "matchesStorageClass": ["NEARLINE"]
    }
  }
]
}
}

Pour connaître le format généralisé d'un fichier de configuration de cycle de vie, consultez la page représentation des ressources de bucket pour JSON.

API REST

API JSON

La configuration de cycle de vie ci-dessous peut être appliquée à un bucket en activant la gestion du cycle de vie.

{
"lifecycle": {
  "rule": [
  {
    "action": {
      "type": "SetStorageClass",
      "storageClass": "NEARLINE"
    },
    "condition": {
      "age": 365,
      "matchesStorageClass": ["MULTI_REGIONAL", "STANDARD", "DURABLE_REDUCED_AVAILABILITY"]
    }
  },
  {
    "action": {
      "type": "SetStorageClass",
      "storageClass": "COLDLINE"
    },
    "condition": {
      "age": 1095,
      "matchesStorageClass": ["NEARLINE"]
    }
  }
]
}
}

Pour connaître le format généralisé d'un fichier de configuration de cycle de vie, consultez la page représentation des ressources de bucket pour JSON.

API XML

La configuration de cycle de vie ci-dessous peut être appliquée à un bucket en activant la gestion du cycle de vie.

<?xml version="1.0" encoding="UTF-8" ?>
<LifecycleConfiguration>
    <Rule>
        <Action>
            <SetStorageClass>NEARLINE</SetStorageClass>
        </Action>
        <Condition>
            <Age>365</Age>
            <MatchesStorageClass>MULTI_REGIONAL</MatchesStorageClass>
            <MatchesStorageClass>STANDARD</MatchesStorageClass>
            <MatchesStorageClass>DURABLE_REDUCED_AVAILABILITY</MatchesStorageClass>
        </Condition>
    </Rule>
    <Rule>
        <Action>
            <SetStorageClass>COLDLINE</SetStorageClass>
        </Action>
        <Condition>
            <Age>1095</Age>
            <MatchesStorageClass>NEARLINE</MatchesStorageClass>
        </Condition>
    </Rule>
</LifecycleConfiguration>

Pour connaître le format généralisé d'un fichier de configuration de cycle de vie, consultez la section relative au format de configuration de cycle de vie pour l'API XML.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Besoin d'aide ? Consultez notre page d'assistance.