Obtenir le cycle de vie d'un bucket

Pour répertorier la configuration du cycle de vie d'un bucket, envoyez une requête GET limitée à un bucket et utilisez le paramètre de chaîne de requête lifecycle. La configuration du cycle de vie est renvoyée dans un document XML dans le corps de la réponse.

Paramètres de la chaîne de requête

Paramètre Description Requis
lifecycle Il permet d'afficher la configuration du cycle de vie d'un bucket existant. Non

Pour en savoir plus sur les paramètres à inclure lors de la création et de l'utilisation d'URL signées, consultez la section Paramètres des chaînes de requête d'URL signée.

En-têtes de requête

Voir les en-têtes de requêtes courants.

Éléments du corps de la requête

Cette requête n'inclut pas de document XML dans le corps de la requête.

Syntaxe des requêtes

La syntaxe suivante s'applique aux requêtes de bucket GET utilisant le paramètre de chaîne de requête lifecycle.

GET /?lifecycle HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: 0
Authorization: AUTHENTICATION_STRING

En-têtes de réponse

La requête peut renvoyer divers en-têtes de réponse en fonction des en-têtes de requête que vous utilisez.

Éléments du corps de la réponse

Les éléments de corps de réponse suivants ne s'appliquent que si vous utilisez le paramètre de chaîne de requête lifecycle pour afficher la configuration du cycle de vie du bucket.

Élément Description
LifecycleConfiguration Définit les règles de gestion du cycle de vie du bucket, qui contiennent zéro, une ou plusieurs règles (jusqu'à 100). Un élément vide (par exemple, <LifecycleConfiguration/>) signifie que la gestion du cycle de vie n'est pas activée pour le bucket.
Rule Définit une règle de gestion du cycle de vie, composée d'une action et des conditions qui doivent être remplies pour que l'action se produise.
Action Définit l'action à exécuter lorsque les conditions spécifiées sont remplies.
Delete Élément permettant de supprimer des objets du bucket.
SetStorageClass Élément permettant de modifier la classe de stockage des objets du bucket.
Condition Conditions devant être remplies pour que l'action se produise. Chaque règle contient au moins un élément de condition.
Age Élément de condition qui correspond aux objets sur l'âge spécifié (en jours).
CreatedBefore Élément de condition qui correspond aux objets créés avant minuit à la date spécifiée au format UTC. La valeur est une chaîne de date ISO sans fuseau horaire, par exemple 2019-01-15.
CustomTimeBefore Élément de condition qui correspond aux objets dont les métadonnées Custom-Time contiennent une date antérieure à la date définie par cette condition. CustomTimeBefore est une chaîne de date ISO sans fuseau horaire, par exemple 2020-02-25.
DaysSinceCustomTime Élément de condition qui correspond aux objets dont les métadonnées Custom-Time datent de plus de DaysSinceCustomTime jours.
DaysSinceNoncurrentTime Élément de condition pertinent uniquement pour les objets avec versions gérées. Recherche les objets qui sont restés inactifs pendant une période supérieure au nombre de jours spécifié.
IsLive L'élément de condition n'est généralement utilisé qu'avec la gestion des versions d'objets. Lorsque la valeur est false, cette condition est remplie pour toute version obsolète d'un objet. Lorsque la valeur est true, cette condition est remplie pour la version active d'un objet. Si vous n'utilisez pas la gestion des versions d'objets, tous vos objets sont considérés comme actifs et correspondent à IsLive lorsque la valeur de true est définie.
MatchesStorageClass Élément de condition qui correspond aux objets ayant la classe de stockage donnée.
NoncurrentTimeBefore Élément de condition pertinent uniquement pour les objets avec versions gérées. Recherche les objets qui sont obsolètes à une date antérieure à la date spécifiée dans cette condition. NoncurrentTimeBefore est une chaîne de date ISO sans fuseau horaire, par exemple 2020-02-25.
NumberOfNewerVersions Élément de condition pertinent uniquement pour les objets avec versions gérées. Si la valeur est N, la condition est satisfaite lorsqu'il existe au moins N versions (y compris la version en ligne) plus récentes que celle de l'objet.