Method: projects.locations.instances.list

Enumera instancias en una ubicación determinada.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio Es el nombre del recurso de la ubicación de la instancia con el formato projects/{projectId}/locations/{locationId}, en el que locationId hace referencia a una región de GCP.

Parámetros de consulta

Parámetros
pageSize

integer

La cantidad máxima de elementos que se mostrarán.

Si no se especifica, el servicio usará un valor predeterminado de 1000. Sin importar el valor de pageSize, la respuesta puede incluir una lista parcial, y un emisor solo debe confiar en el nextPageToken de la respuesta para determinar si quedan más instancias para consultar.
pageToken

string

El valor de nextPageToken que se muestra de una solicitud de lista anterior, si existe.
filter

string

Filtro de lista. Por ejemplo, especifica "name != my-instance" para excluir todas las instancias de Memcached con el nombre my-instance.
orderBy

string

Ordena resultados. Los valores admitidos son “name”, “name desc” o “” (sin orden).

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

La respuesta para instances.list.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "instances": [
    {
      object (Instance)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
instances[]

object (Instance)

Es una lista de instancias de Memcached en el proyecto en la ubicación especificada o en todas las ubicaciones.

Si el locationId en el campo superior de la solicitud es “-”, se consultan todas las regiones disponibles para el proyecto y los resultados agregados.
nextPageToken

string

Token para recuperar la página siguiente de resultados o vaciar si no hay más resultados en la lista.
unreachable[]

string

Ubicaciones en las que no se pudo acceder.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.