Method: projects.locations.privateClouds.list

Liste les ressources PrivateCloud d'un projet et d'un emplacement donnés.

Requête HTTP

GET https://vmwareengine.googleapis.com/v1/{parent=projects/*/locations/*}/privateClouds

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de ressource du cloud privé pour lequel interroger les clusters. Les noms de ressources sont des URI sans schéma qui suivent les conventions décrites sur https://cloud.google.com/apis/design/resource_names. Par exemple : projects/my-project/locations/us-central1-a

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • vmwareengine.privateClouds.list

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal de clouds privés à renvoyer sur une page. Le service peut renvoyer un nombre inférieur à cette valeur. La valeur maximale est ramenée à 1 000. La valeur par défaut de ce champ est 500.
pageToken

string

Jeton de page reçu d'un appel privateClouds.list précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à privateClouds.list doivent correspondre à l'appel ayant fourni le jeton de page.
filter

string

Expression de filtre qui correspond aux ressources renvoyées dans la réponse. L'expression doit spécifier le nom du champ, un opérateur de comparaison et la valeur à 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 une liste de clouds privés, vous pouvez exclure ceux nommés example-pc en spécifiant name != "example-pc".

Vous pouvez également filtrer les champs imbriqués. Par exemple, vous pouvez spécifier networkConfig.managementCidr = "192.168.0.0/24" pour n'inclure les clouds privés que s'ils ont une adresse correspondante dans leur configuration réseau.

Pour filtrer sur plusieurs expressions, indiquez chaque expression distincte entre parenthèses. Exemple :

(name = "example-pc")
(createTime > "2021-04-12T08:15:10.40Z")

Par défaut, chaque expression est une expression AND. Toutefois, vous pouvez inclure explicitement les expressions AND et OR. Exemple :

(name = "private-cloud-1") AND
(createTime > "2021-04-12T08:15:10.40Z") OR
(name = "private-cloud-2")
orderBy

string

Trie les résultats de la liste selon un certain ordre. Par défaut, les résultats renvoyés sont triés par name dans l'ordre croissant. Vous pouvez également trier les résultats dans l'ordre décroissant en fonction de la valeur name à l'aide de orderBy="name desc". Pour le moment, seul le tri par name est disponible.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour VmwareEngine.ListPrivateClouds

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "privateClouds": [
    {
      object (PrivateCloud)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Champs
privateClouds[]

object (PrivateCloud)

Liste des clouds privés.
nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.
unreachable[]

string

Emplacements qui n'ont pas pu être atteints lors de l'exécution d'une requête agrégée à l'aide de caractères génériques.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

Pour plus d'informations, consultez la Authentication Overview.