Method: projects.locations.instances.list

Lista as instâncias numa determinada localização.

Pedido HTTP

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

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso da localização da instância com o formulário: projects/{projectId}/locations/{locationId} onde locationId se refere a uma região da GCP

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de itens a devolver.

Se não for especificado, o serviço usa um valor predefinido de 1000. Independentemente do valor de pageSize, a resposta pode incluir uma lista parcial e um autor da chamada só deve confiar no nextPageToken da resposta para determinar se existem mais instâncias a consultar.

pageToken

string

O valor nextPageToken devolvido de um pedido de lista anterior, se existir.

filter

string

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

orderBy

string

Ordene os resultados. Os valores suportados são "name", "name desc" ou "" (não ordenado).

Corpo do pedido

O corpo do pedido tem de estar vazio.

Corpo da resposta

Resposta de instances.list.

Se for bem-sucedido, o corpo da resposta contém dados com a seguinte estrutura:

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

object (Instance)

Uma lista de instâncias do Memcached no projeto na localização especificada ou em todas as localizações.

Se o locationId no campo principal do pedido for "-", são consultadas todas as regiões disponíveis para o projeto e os resultados são agregados.

nextPageToken

string

Token para obter a página seguinte de resultados ou vazio se não existirem mais resultados na lista.

unreachable[]

string

Localizações às quais não foi possível aceder.

Âmbitos de autorização

Requer o seguinte âmbito do OAuth:

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

Para mais informações, consulte o Authentication Overview.