Répertorie toutes les ressources d'un déploiement donné. Essayer maintenant
Requête
Requête HTTP
GET https://www.googleapis.com/deploymentmanager/v2/projects/project/global/deployments/deployment/resources
Paramètres
Nom du paramètre | Valeur | Description |
---|---|---|
Paramètres de chemin d'accès | ||
deployment |
string |
Nom du déploiement pour cette requête. |
project |
string |
ID du projet pour cette requête. |
Paramètres de requête facultatifs | ||
filter |
string |
Expression de filtre qui filtre les ressources répertoriées dans la réponse. L'expression doit spécifier le nom du champ, un opérateur de comparaison et la valeur que vous souhaitez utiliser pour le filtrage. La valeur doit être une chaîne, un nombre ou une valeur booléenne. L'opérateur de comparaison doit être = , != , > ou < .
Par exemple, si vous filtrez des instances Compute Engine, vous pouvez exclure les instances nommées example-instance en spécifiant name != example-instance .
Vous pouvez également filtrer les champs imbriqués. Par exemple, vous pouvez spécifier scheduling.automaticRestart = false pour n'inclure les instances que si elles ne sont pas planifiées pour redémarrer automatiquement. Vous pouvez utiliser le filtrage sur les champs imbriqués pour filtrer en fonction des libellés de ressources.
Pour filtrer sur plusieurs expressions, indiquez chaque expression séparée entre parenthèses. Par exemple, (scheduling.automaticRestart = true)
(cpuPlatform = "Intel Skylake") .
Par défaut, chaque expression est une expression AND . Toutefois, vous pouvez inclure explicitement des expressions AND et OR .
Par exemple, (cpuPlatform = "Intel Skylake") OR
(cpuPlatform = "Intel Broadwell") AND
(scheduling.automaticRestart = true) .
|
maxResults |
unsigned integer |
Nombre maximal de résultats par page à renvoyer.
Si le nombre de résultats disponibles est supérieur à maxResults , Compute Engine renvoie un nextPageToken qui peut être utilisé pour obtenir la page de résultats suivante dans les requêtes de liste ultérieures. Les valeurs acceptées sont comprises entre 0 et 500 , inclus. (Par défaut: 500 )
|
orderBy |
string |
Trie les résultats de la liste dans un certain ordre. Par défaut, les résultats sont renvoyés dans l'ordre alphanumérique en fonction du nom de la ressource.
Vous pouvez également trier les résultats par ordre décroissant en fonction du code temporel de création à l'aide de orderBy="creationTimestamp desc" . Cela permet de trier les résultats en fonction du champ creationTimestamp dans l'ordre chronologique inverse (le résultat le plus récent en premier). Utilisez-le pour trier les ressources telles que les opérations afin que l'opération la plus récente soit renvoyée en premier.
Pour le moment, seul le tri par name ou creationTimestamp desc est pris en charge.
|
pageToken |
string |
Spécifie un jeton de page à utiliser. Définissez pageToken sur la valeur nextPageToken renvoyée par une requête de liste précédente pour obtenir la page de résultats suivante.
|
Autorisation
Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation
Champ d'application |
---|
https://www.googleapis.com/auth/ndev.cloudman.readonly |
https://www.googleapis.com/auth/cloud-platform |
https://www.googleapis.com/auth/ndev.cloudman |
https://www.googleapis.com/auth/cloud-platform.read-only |
Corps de la requête
Ne spécifiez pas de corps de requête pour cette méthode.
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
{ "resources": [ resources Resource ], "nextPageToken": string }
Nom de propriété | Valeur | Description | Remarques |
---|---|---|---|
resources[] |
list |
Ressources contenues dans cette réponse de liste. | |
nextPageToken |
string |
Jeton utilisé pour poursuivre une requête de liste tronquée. |
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse. Vous pouvez également essayer l'explorateur autonome.