Resources: list

Autorisation requise

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.