Métadonnées des buckets

Obtenir des métadonnées

Obtenir la taille de bucket

Cette page traite des champs de métadonnées stockés avec des buckets dans Cloud Storage.

Introduction

Les buckets Cloud Storage sont associés à des métadonnées. Les métadonnées identifient les propriétés du bucket et spécifient la manière dont celui-ci doit être géré lorsqu'on y accède.

Les métadonnées sont stockées sous forme de paires key: value, où la value peut prendre différentes formes, y compris des chaînes, des tables ou même des paires key:value imbriquées. Par exemple, le nom du bucket est une chaîne, tandis qu'une configuration de gestion du cycle de vie des objets du bucket est un tableau de règles dans lesquelles chaque règle contient plusieurs paires key: value enfants.

La mutabilité des métadonnées varie :

  • Certaines ne peuvent être que consultées.

  • Certaines ne peuvent être définies que lors de la création du bucket, et ne peuvent pas être modifiées ni supprimées.

  • Certaines peuvent être ajoutées et modifiées, mais pas supprimées.

  • Certaines peuvent être ajoutées, modifiées et supprimées à tout moment.

Métadonnées non modifiables

Les métadonnées suivantes sont définies lors de la création du bucket, et ne peuvent être ni modifiées, ni supprimées :

  • Nom du bucket

  • Emplacement du bucket

  • Le projet dont le bucket fait partie

  • Numéro de génération

    • Le numéro de génération d'un bucket identifie de manière unique la version du bucket, même si plusieurs versions d'un bucket portent le même nom.

    • La valeur de génération d'un bucket ne change jamais.

    • Notez que rien ne garantit que les numéros de génération augmentent pour les versions successives, mais uniquement que chaque nouvelle version possède un numéro de génération unique.

    • Il n'existe aucun lien entre les numéros de génération de buckets non liés.

  • Numéro de métagénération

    • Le numéro de métagénération d'un bucket identifie de manière unique l'état des métadonnées de celui-ci. Le numéro de métagénération est 1 au moment de la création du bucket et augmente chaque fois que vous modifiez les métadonnées du bucket.

Métadonnées modifiables

Les métadonnées de bucket modifiables sont des métadonnées dont vous pouvez généralement modifier les valeurs à tout moment. Dans certains cas, par exemple lorsque le bucket est soumis à une contrainte de règle d'administration, il existe des restrictions concernant la modification de certaines valeurs de métadonnées.

Présentation des métadonnées Lien du guide Remarques
Listes de contrôle d'accès (LCA) Créer et gérer des LCA Recommandée uniquement pour les utilisateurs de XML.
LCA par défaut Définir les LCA des objets par défaut
Stratégies IAM (Identity and Access Management)1 Utiliser des autorisations IAM
Facturation (paiement par le demandeur) Utiliser les paiements du demandeur
Configuration du partage de ressources entre origines (CORS) Configurer et afficher les configurations CORS
Default storage class (Classe de stockage par défaut) Modifier la classe de stockage par défaut Définie lors de la création du bucket et peut être modifiée, mais pas supprimée.
Clé de chiffrement Cloud KMS par défaut Utiliser les clés Cloud KMS par défaut
Obligations de conservation basées sur des événements activées par défaut1 Utiliser la propriété de préservation à titre conservatoire basée sur des événements activée par défaut
Protection contre l'accès public1 Utiliser la protection contre l'accès public
Accès uniforme au niveau du bucket1 Utiliser l'accès uniforme au niveau du bucket Uniquement modifiable pendant les 90 jours suivant l'activation de l'accès uniforme au niveau du bucket dans un bucket.
Stratégie de configuration du cycle de vie Gérer le cycle de vie des objets
Classe automatique Utiliser la classe automatique
Réplication turbo1 Gérer la réplication turbo
Journaux d'utilisation et journaux de stockage Configuration des journaux d'utilisation
Verrou de bucket2 Utiliser et verrouiller des règles de conservation Cette propriété n'est modifiable que si vous ne verrouillez pas les règles de conservation.
Verrou de conservation des objets Activer et utiliser des configurations de conservation des objets Une fois activé pour un bucket, ne peut plus être désactivé.
Configuration de la gestion des versions des objets Utiliser la gestion des versions d'objets
Étiquettes de buckets Utiliser les étiquettes de buckets
Durée de conservation de la suppression réversible Utiliser la suppression réversible
Configuration du site Web Attribuer des pages spécialisées pour les sites Web statiques

1 Ces métadonnées ne peuvent pas être affichées ni gérées à l'aide de l'API XML.

2 L'API XML permet de définir ces métadonnées lors de la création du bucket, mais pas de les afficher ni de les gérer.

Étapes suivantes