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é lorsque l'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 lequel 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

  • 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 partagent le même nom.

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

    • Rien ne garantit que les numéros de génération augmentent pour des versions successives, la seule certitude étant que chaque nouvelle version possède un numéro de génération unique.

    • Il n'y a pas de lien entre les numéros de génération de buckets non associé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 du bucket. 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 vers le guide Remarques
Listes de contrôle d'accès (LCA) Créer et gérer des LCA Recommandées 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 par le demandeur
Configuration CORS (Cross-Origin Resource Sharing) Configurer et afficher les configurations CORS
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 par défaut1 Utiliser la propriété d'obligation de conservation basée sur des événements 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 les cycles 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 Modifiable uniquement 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, il 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
Emplacement du bucket Relocaliser des buckets Avant de déplacer un bucket, consultez la page Présentation de la relocalisation de buckets.

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