Método: projects.locations.instances.list

Lista instâncias em um determinado projeto e local.

Solicitação HTTP

GET https://memcache.googleapis.com/v1beta2/{parent=projects/*/locations/*}/instances

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso do local da instância usando o formulário: projects/{project_id}/locations/{locationId}, em que locationId se refere a uma região do GCP

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de itens para retornar.

Caso não seja especificado, um valor padrão de 1000 será usado pelo serviço. Independentemente do valor pageSize, a resposta pode incluir uma lista parcial, e o autor da chamada precisa confiar apenas no [nextPageToken][CloudMemcache.ListInstancesResponse.next_page_token] para resposta para determinar se há mais instâncias a serem consultadas.
pageToken

string

O valor nextPageToken retornado de uma solicitação de lista anterior, se houver.
filter

string

Filtro de lista. Por exemplo, exclua todas as instâncias do Memcached com o nome como my-instance especificando "name != my-instance".
orderBy

string

Classificar resultados. Os valores aceitos são "name", "name desc" ou " "(unsorted)".

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

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

Resposta para instances.list.

Representação JSON 

{
  "resources": [
    {
      object (Instance)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
resources[]

object (Instance)

Uma lista de instâncias do Memcached no projeto no local especificado ou em todos os locais.

Se o locationId no campo pai da solicitação for "-", todas as regiões disponíveis para o projeto serão consultadas e os resultados, agregados.
nextPageToken

string

Token para recuperar a próxima página de resultados ou vazia se não houver mais resultados na lista.
unreachable[]

string

Locais que não puderam ser alcançados.

Escopos da autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.