Tags et libellés

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette page décrit les tags et les libellés que vous pouvez définir sur des ressources Cloud Storage.

Présentation

Les tags Google Cloud et les libellés de buckets Cloud Storage sont deux manières d'organiser vos ressources Cloud Storage.

Les tags et les libellés fonctionnent indépendamment les uns des autres. Vous pouvez utiliser les deux sur le même bucket.

Tags

Les tags sont des paires clé/valeur que vous pouvez appliquer à vos ressources pour un contrôle d'accès précis.

Les tags sont créés au niveau de l'organisation et gérés via le gestionnaire de ressources, qui est utilisé dans Google Cloud. Une fois que vous avez associé un tag à un bucket Cloud Storage, vous pouvez l'utiliser avec des conditions IAM pour accorder l'accès aux ressources Cloud Storage, ou avec des règles d'administration pour appliquer des contraintes sur les ressources Cloud Storage.

Bien que les tags soient gérés via Resource Manager, vous devez disposer des autorisations IAM Cloud Storage suivantes pour afficher et définir des tags sur des buckets Cloud Storage :

  • storage.buckets.listTagBindings
  • storage.buckets.createTagBinding
  • storage.buckets.deleteTagBinding

Ces autorisations peuvent être héritées via des rôles IAM tels que resourcemanager.tagUser et storage.admin.

Gardez à l'esprit les restrictions suivantes concernant la version bêta :

  • Les tags ne peuvent être associés à un bucket qu'une fois celui-ci créé.

  • Les tags ne sont pas acceptés dans les buckets situés dans les régions us-east2, us-east3 et us-south1.

  • Les tags sont ignorés par la contrainte de partage restreint de domaine. Par exemple, supposons que vous utilisiez la contrainte pour spécifier que seuls les utilisateurs de exampledomain.com peuvent être ajoutés à la stratégie IAM d'un bucket si un tag est associé au bucket. Toutefois, même lorsqu'un tag est associé au bucket, il est toujours possible d'ajouter des utilisateurs extérieurs à exampledomain.com à la stratégie IAM du bucket.

  • Dans de rares cas, des latences élevées peuvent survenir lors de la lecture ou de la modification des tags associés aux buckets.

Il est impossible d'appliquer des tags aux objets Cloud Storage.

Exemples d'association de tags à des buckets Cloud Storage

Une fois que vous avez créé et défini un tag, vous pouvez l'associer à votre bucket Cloud Storage.

Imaginez le scénario suivant :

  • La valeur du tag comporte le nom d'espace de noms 815471563813/color/blue.
  • Votre bucket est nommé my-bucket.
  • Votre bucket se trouve à l'emplacement us-central1.

La commande gcloud suivante associe le tag à my-bucket :

gcloud alpha resource-manager tags bindings create \
--tag-value=815471563813/color/blue \
--parent=//storage.googleapis.com/projects/_/buckets/my-bucket
--location=us-central1

La commande gcloud suivante dissocie le tag de my-bucket :

gcloud alpha resource-manager tags bindings delete \
--tag-value=815471563813/color/blue \
--parent=//storage.googleapis.com/projects/_/buckets/my-bucket \
--location=us-central1

La commande gcloud suivante répertorie tous les tags directement associés à my-bucket, à l'exception des tags hérités par my-bucket :

gcloud alpha resource-manager tags bindings list \
    --parent=//storage.googleapis.com/projects/_/buckets/my-bucket \
    --location=us-central1

Pour obtenir des instructions plus détaillées, consultez la section Associer des tags aux ressources.

Détail du prix

Les tags sur les buckets Cloud Storage font l'objet d'une remise de 100 % jusqu'au 15 septembre 2022. À compter du 15 septembre 2022, les tags des buckets Cloud Storage seront soumis à des tarifs.

Étiquettes de buckets

Les libellés de bucket vous permettent de créer des paires clé/valeur arbitraires stockées dans les métadonnées du bucket. Vous pouvez utiliser des libellés pour organiser vos buckets ainsi que d'autres ressources Google Cloud, telles que des instances de machines virtuelles et des disques persistants. Par exemple, supposons que vous souhaitiez qu'une clé nommée team ait les valeurs alpha, beta et delta, que vous utiliserez pour indiquer à quelle équipe sont associées certaines ressources Google Cloud. Pour ce faire, vous pouvez appliquer les libellés team:alpha, team:beta et team:delta aux ressources souhaitées.

Tenez compte des points suivants lorsque vous utilisez des libellés de buckets :

  • Les clés et les valeurs ne peuvent pas dépasser 63 caractères chacune.
  • Les clés et les valeurs ne peuvent contenir que des lettres minuscules, des caractères numériques, des traits de soulignement et des tirets. Les caractères internationaux sont acceptés.
  • Les clés des libellés doivent commencer par une lettre minuscule, et les caractères internationaux sont autorisés.
  • Les libellés ne peuvent pas être vides.
  • Chaque bucket peut être associé à un maximum de 64 libellés.
  • Comme les métadonnées de bucket, les libellés de bucket ne sont généralement pas associés à des objets individuels ou à des métadonnées d'objet.

Pour obtenir un exemple général d'utilisation des étiquettes pour organiser vos ressources dans le cadre de la facturation, consultez l'article Exemples de requêtes BigQuery sur des données de facturation exportées.

Détail du prix

L'utilisation des libellés de buckets est sans frais.

Étapes suivantes