Método: projects.locations.instances.list

Muestra una lista de instancias en una ubicación y un proyecto determinados.

Solicitud HTTP

GET https://memcache.googleapis.com/v1beta2/{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/{project_id}/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 1,000. Sin importar el valor pageSize, la respuesta puede incluir una lista parcial y el emisor solo debe confiar en el [nextPageToken][CloudMemcache.ListInstancesResponse.next_page_token] de la respuesta para determinar si quedan más instancias pendientes.
pageToken

string

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

string

Filtro de lista. Por ejemplo, para excluir todas las instancias de Memcached con el nombre como my-instance, especifique “name != 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

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

La respuesta para instances.list.

Representación JSON 

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

object (Instance)

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 a las que no se pudo acceder.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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