Cette page contient des exemples de requêtes sur divers cas d'utilisation de la recherche de ressources.
Répertorier les ressources Google Cloud de votre organisation
Répertoriez les ressources Google Cloud dans votre organisation sous la forme de tuples (ASSET_TYPE, NAME, PROJECT_ID, LABELS).
gcloud asset search-all-resources \
--scope=organizations/123456 \
--page-size=50 \
--format='table(assetType.basename(), name.basename(), name.scope(projects).segment(0):label=PROJECT_ID, labels)'
Vous pouvez remplacer --scope par projects/12345678 ou folders/1234567 pour effectuer une recherche dans un projet ou un dossier au lieu d'une organisation.
Vous pouvez ajouter des restrictions --query pour obtenir des résultats de recherche de ressources plus spécifiques.
Vous pouvez ajouter des restrictions --asset-types pour obtenir des types de ressources plus spécifiques.
Vous pouvez ajouter --read-mask pour spécifier les champs à renvoyer dans les résultats.
Vous pouvez supprimer --flatten et --format si vous ne souhaitez pas formater les résultats.
Vous pouvez utiliser csv au lieu de table pour afficher les résultats au format CSV.
Vous pouvez supprimer .basename() de l'expression --format pour renvoyer le nom complet de chaque champ.
Vous pouvez ajouter --limit pour obtenir uniquement un sous-ensemble des résultats de recherche. Sans cette option, l'utilisateur passe automatiquement en revue tous les résultats de la recherche.
Répertorier les instances Compute Engine dans votre projet
gcloud asset search-all-resources \
--scope=projects/12345678 \
--asset-types='compute.googleapis.com/Instance'
Vous pouvez remplacer --scope par organizations/123456 ou folders/1234567 pour répertorier toutes les ressources de votre organisation ou de votre dossier au lieu d'un projet.
Vous pouvez ajouter des restrictions --query pour obtenir des résultats de recherche de ressources plus spécifiques.
Lister les instances Compute Engine avec un tagKey spécifié
Cet exemple montre comment répertorier les instances Compute Engine auxquelles sont associés directement des tags avec TagKey.namespacedName contenant env.
gcloud asset search-all-resources \
--query='tagKeys:env' \
--scope=organizations/123456 \
--asset-types='compute.googleapis.com/Instance' \
--page-size=50 \
--format='table(name, assetType, tagKeys, tagValues, tagValueIds)'
Lister les instances Compute Engine avec un tagValue spécifié
Cet exemple montre comment répertorier les instances Compute Engine auxquelles sont associés directement des tags où TagValue est utilisé.namespacedName contient prod ou sea, et le nom de l'instance ne contient pas instance1.
gcloud asset search-all-resources \
--query='tagValues:(prod OR sea) (NOT name:instance1)' \
--scope=organizations/123456 \
--asset-types='compute.googleapis.com/Instance' \
--page-size=50 \
--format='table(name, assetType, tagKeys, tagValues, tagValueIds)'
Répertorier les instances Compute Engine portant le libellé env
gcloud asset search-all-resources \
--query='labels.env:*' \
--scope=organizations/123456 \
--asset-types='compute.googleapis.com/Instance' \
--page-size=50 \
--format='table(name, assetType, labels)'
Répertorier les instances Compute Engine inactives
gcloud asset search-all-resources \
--query='NOT state:active' \
--scope=organizations/123456 \
--asset-types='compute.googleapis.com/Instance' \
--page-size=50 \
--format='table(name, assetType, state)'
Répertorier les instances Compute Engine situées aux États-Unis
gcloud asset search-all-resources \
--query='location:us-*' \
--scope=organizations/123456 \
--asset-types='compute.googleapis.com/Instance' \
--page-size=50 \
--format='table(name, assetType, location)'
Lister les instances Compute Engine avec leur description
Répertorier les instances Compute Engine avec la description instance-prod,mais pas instance-prod-1, INSTANCE-PROD, etc.
gcloud asset search-all-resources \
--query='description=instance-prod' \
--scope=organizations/123456 \
--asset-types='compute.googleapis.com/Instance' \
--page-size=50 \
--format='table(name, assetType, location)'
Comptez toutes les ressources Google Cloud par type et par emplacement
gcloud asset search-all-resources \
--scope=organizations/123456 \
--page-size=500 \
--format='csv(assetType,location)' \
| sed 1d | sort | uniq -c
Répertorier les instances Compute Engine qui sont à l'état SUSPENDED
gcloud asset search-all-resources \
--query='state=SUSPENDED' \
--scope=organizations/123456 \
--asset-types='compute.googleapis.com/Instance' \
--page-size=50 \
--format='table(name, assetType, location)'
Répertoriez les ressources Google Cloud qui ont des relations avec instance-group-1 dans le nom de la ressource associée.
gcloud asset search-all-resources \
--query='relationships:instance-group-1' \
--scope=organizations/123456 \
--page-size=50 \
--format='table(name, assetType, relationships)'
Répertorier les instances Compute Engine ayant des relations de type INSTANCE_TO_INSTANCEGROUP
gcloud asset search-all-resources \
--query='relationships:INSTANCE_TO_INSTANCEGROUP' \
--scope=organizations/123456 \
--page-size=50 \
--format='table(name, assetType, relationships)'
Répertoriez les instances Compute Engine qui ont des relations avec instance-group-1 dans le nom de ressource du groupe d'instances Compute Engine, pour le type de relation INSTANCE_TO_INSTANCEGROUP.
gcloud asset search-all-resources \
--query='relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1' \
--scope=organizations/123456 \
--page-size=50 \
--format='table(name, assetType, relationships)'
Répertoriez les instances Compute Engine créées après 2021-01-01 00:00:00 UTC.
gcloud asset search-all-resources \
--query='createTime>1609459200' \
--scope=organizations/123456 \
--asset-types='compute.googleapis.com/Instance' \
--page-size=50 \
--format='table(name, assetType, location)'
Répertorier les instances Compute Engine créées après 2021-01-01 00:00:00 UTC avec une chaîne temporelle
gcloud asset search-all-resources \
--query='createTime>"2021-01-01T00:00:00"' \
--scope=organizations/123456 \
--asset-types='compute.googleapis.com/Instance' \
--page-size=50 \
--format='table(name, assetType, location)'
Répertorier les instances Compute Engine en cours d'exécution et renvoyer une représentation JSON des ressources
gcloud asset search-all-resources \
--query='state=RUNNING' \
--scope=organizations/123456 \
--asset-types='compute.googleapis.com/Instance' \
--page-size=50 \
--read-mask='name,assetType,location,versionedResources' \
--format='table(name, assetType, location, versionedResources)'