Method: projects.locations.privateClouds.clusters.list

Elenca le risorse Cluster in un cloud privato specifico.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome della risorsa del cloud privato per cui eseguire query per i cluster. I nomi delle risorse sono URI senza schema che seguono le convenzioni riportate in https://cloud.google.com/apis/design/resource_names. Ad esempio: projects/my-project/locations/us-central1-a/privateClouds/my-cloud

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • vmwareengine.clusters.list

Parametri di query

Parametri
pageSize

integer

Il numero massimo di cluster da restituire in una pagina. Il servizio potrebbe restituire un numero inferiore a questo valore. Il valore massimo viene forzato a 1000. Il valore predefinito di questo campo è 500.
pageToken

string

Un token di pagina, ricevuto da una precedente chiamata clusters.list. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a clusters.list devono corrispondere alla chiamata che ha fornito il token di pagina.
filter

string

Per filtrare in base a più espressioni, fornisci ogni espressione separata tra parentesi. Ad esempio:

(name = "example-cluster")
(nodeCount = "3")

Per impostazione predefinita, ogni espressione è un'espressione AND. Tuttavia, puoi includere esplicitamente le espressioni AND e OR. Ad esempio:

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

string

Ordina i risultati dell'elenco in un determinato ordine. Per impostazione predefinita, i risultati restituiti sono ordinati in base a name in ordine crescente. Puoi anche ordinare i risultati in ordine decrescente in base al valore name utilizzando orderBy="name desc". Al momento è supportato solo l'ordinamento per name.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per VmwareEngine.ListClusters

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "clusters": [
    {
      object (Cluster)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campi
clusters[]

object (Cluster)

Un elenco di cluster cloud privato.
nextPageToken

string

Un token, che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
unreachable[]

string

Località non raggiungibili durante l'esecuzione di una query aggregata utilizzando caratteri jolly.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la Authentication Overview.