Organiser les volumes de stockage à l'aide de libellés

Pour vous aider à organiser vos volumes de stockage, vous pouvez utiliser des libellés. Les libellés sont des paires clé/valeur que vous pouvez associer à chaque volume de stockage, puis filtrer les volumes de stockage en fonction de leurs libellés. Vous pouvez par exemple exploiter les libellés pour regrouper des volumes de stockage par finalité, par environnement, par emplacement, par service, etc. Les libellés sont facultatifs.

Ajouter ou mettre à jour des libellés pour les volumes de stockage

Vous pouvez ajouter ou mettre à jour des libellés pour les volumes de stockage existants.

Console

  1. Accédez à la page Compute Engine > solution Bare Metal > Volumes.

  2. Pour le volume de stockage que vous souhaitez libeller, cliquez sur .

  3. Cliquez sur Modifier les libellés.

  4. Sur la page Éditeur de libellés :

    1. Cliquez sur Ajouter un libellé et ajoutez la paire clé/valeur.
    2. Pour mettre à jour des libellés, sélectionnez les libellés existants et modifiez leurs valeurs.
    3. Cliquez sur Envoyer.

  5. Une fois de retour sur la page Volumes, actualisez la page pour afficher vos modifications.

gcloud

Pour ajouter ou mettre à jour des libellés pour un volume de stockage, utilisez la commande gcloud bms volumes update avec l'option --update-labels.

L'exemple de commande suivant ajoute les libellés environment = dev et location = branch :

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

Si vous fournissez une nouvelle valeur pour un libellé qui existe déjà, le système met à jour le libellé existant avec la nouvelle valeur. Si vous fournissez un nouveau libellé, le système l'ajoute à la liste des libellés.

API

Pour ajouter ou mettre à jour des libellés pour un volume de stockage, saisissez l'ID de votre projet, votre région, le nom du volume et une liste de libellés dans la commande curl suivante. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant attribue un libellé environment = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Supprimer des libellés des volumes de stockage

Vous pouvez supprimer des libellés des volumes de stockage.

Console

  1. Accédez à la page Compute Engine > solution Bare Metal > Volumes.

  2. Pour un volume de stockage dont vous souhaitez supprimer les libellés, cliquez sur .

  3. Cliquez sur Modifier les libellés.

  4. Sur la page Éditeur de libellés :

    1. Pour supprimer un libellé, cliquez sur .
    2. Cliquez sur Envoyer.

  5. Une fois de retour sur la page Volumes, actualisez la page pour afficher vos modifications.

gcloud

Pour supprimer des libellés d'un volume de stockage, utilisez la commande gcloud bms volumes update avec les options suivantes :

  • --remove-labels : supprime le libellé spécifié.
  • --clear-labels : supprime tous les libellés.

L'exemple de commande suivant supprime le libellé department d'un volume de stockage :

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

L'exemple de commande suivant supprime tous les libellés d'un volume de stockage :

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

Pour supprimer des libellés d'un volume de stockage, saisissez l'ID de votre projet, votre région et le nom de votre volume de stockage dans la commande curl suivante. Fournissez une liste vide de libellés pour supprimer tous les libellés, ou fournissez une liste de libellés à conserver (en omettant les libellés à supprimer). Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant supprime tous les libellés, à l'exception de environment = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Filtrer les volumes de stockage à l'aide de libellés

Vous pouvez rechercher des volumes de stockage et filtrer les résultats à l'aide de libellés.

Console

  1. Accédez à la page Compute Engine > solution Bare Metal > Volumes.

  2. Cliquez sur la barre Filtre au-dessus de la liste des volumes de stockage.

  3. Dans la liste Propriétés, sélectionnez Libellés.

  4. Saisissez la clé, la valeur ou la paire clé/valeur de votre libellé.

    Par exemple, pour n'afficher que les volumes de stockage associés au libellé env:dev, vous pouvez saisir l'un des éléments suivants :

    • Saisissez la clé : env
    • Saisissez la valeur : dev
    • Saisissez la paire clé/valeur : env:dev

  5. Pour appliquer le filtre de libellé, cliquez n'importe où en dehors de la barre de filtre.

gcloud

Pour filtrer les volumes de stockage à l'aide de libellés, utilisez la commande gcloud bms volumes list avec l'option --filter.

La valeur de --filter option doit être au format labels.KEY=VALUE. Par exemple, si vous souhaitez effectuer un filtrage à l'aide d'un libellé assorti de la clé env et de la valeur dev, exécutez la commande suivante :

gcloud bms volumes list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

Pour en savoir plus sur la syntaxe du filtrage dans gcloud CLI, consultez la gcloud topic filters documentation.

API

Pour filtrer les volumes de stockage à l'aide de libellés, saisissez l'ID de votre projet et votre région, ainsi que filter=labels et un libellé de paire clé/valeur. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant limite le résultat pour rechercher les volumes de stockage avec l'étiquette de paire clé/valeur environment = test.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes"?filter=labels.environment=test