Définir des étiquettes de bucket

Pour ajouter ou modifier des libellés appliqués à un bucket, vous exécutez une requête PUT limitée au bucket souhaité et utilisez le paramètre de chaîne de requête tagging avec un élément <Tagging> dans le corps de la requête.

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

Paramètre Description Requis
tagging Utilisé lors de l'ajout ou de la modification d'étiquettes appliquées à un bucket. Si vous utilisez des libellés, incluez les libellés dans le corps de la requête. 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

Les éléments de corps de requête suivants ne s'appliquent que si vous utilisez le paramètre de chaîne de requête tagging pour définir les étiquettes appliquées au bucket.

Élément Description
Tagging Conteneur de TagSet.
TagSet Conteneur de toutes les étiquettes appliquées au bucket.
Tag Conteneur d'une étiquette individuelle. Un libellé est composé d'une paire key:value.
Key Clé d'un libellé.
Value Valeur d'un libellé.

Syntaxe des requêtes

La syntaxe suivante s'applique aux requêtes de bucket PUT qui utilisent le paramètre de chaîne de requête tagging.

PUT /?tagging HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: REQUEST_BODY_LENGTH
Authorization: AUTHENTICATION_STRING

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
     <Tag>
       <Key>LABEL_KEY</Key>
       <Value>LABEL_VALUE</Value>
     </Tag>
  </TagSet>
</Tagging>

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

La réponse n'inclut pas de document XML dans le corps de la réponse.

Exemple

L'exemple suivant définit une configuration d'étiquette composée de deux étiquettes pour un bucket nommé my-bucket.

Requête

PUT /?tagging HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Thu, 24 Jan 2016 02:34:56 GMT
Content-Length: 196
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
     <Tag>
       <Key>environment</Key>
       <Value>production</Value>
     </Tag>
     <Tag>
       <Key>billing</Key>
       <Value>marketing-department</Value>
     </Tag>
  </TagSet>
</Tagging>

Réponse

HTTP/1.1 200 OK
Date: Thu, 24 Jan 2016 02:34:56 GMT
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Cache-Control: no-cache, no-store, must-revalidate
Content-Length: 0
Content-Type: text/html