Method: projects.locations.privateClouds.clusters.list

Lista recursos Cluster em uma determinada nuvem privada.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso da nuvem privada para consultar clusters. Os nomes de recursos são URIs sem esquema que seguem as convenções em https://cloud.google.com/apis/design/resource_names. Por exemplo: projects/my-project/locations/us-central1-a/privateClouds/my-cloud

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • vmwareengine.clusters.list

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de clusters a serem retornados em uma página. O serviço pode retornar um valor inferior a este. O valor máximo é convertido para 1.000. O valor padrão desse campo é 500.
pageToken

string

Um token de página recebido de uma chamada clusters.list anterior. Forneça isso para recuperar a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos para clusters.list precisam corresponder à chamada que forneceu o token da página.
filter

string

Para filtrar várias expressões, coloque cada uma entre parênteses. Exemplo:

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

Por padrão, cada expressão é uma expressão AND. No entanto, é possível incluir expressões AND e OR explicitamente. Exemplo:

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

string

Classifica os resultados da lista em uma determinada ordem. Por padrão, os resultados retornados são ordenados por name em ordem crescente. Também é possível classificar os resultados em ordem decrescente com base no valor name usando orderBy="name desc". No momento, só é possível ordenar por name.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para VmwareEngine.ListClusters.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "clusters": [
    {
      object (Cluster)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
clusters[]

object (Cluster)

Uma lista de clusters de nuvem privada.
nextPageToken

string

Um token, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.
unreachable[]

string

Locais que não puderam ser alcançados ao fazer uma consulta agregada usando caracteres curinga.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.