Method: projects.locations.instances.list

Enumera instancias en una ubicación y un proyecto determinados.

Solicitud HTTP


GET https://memorystore.googleapis.com/v1beta/{parent=projects/*/locations/*}/instances

Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el recurso principal del que se enumerarán las instancias. Formato: projects/{project}/locations/{location}

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.

pageToken

string

Opcional. Un token que identifica una página de resultados que el servidor debe devolver.

filter

string

Es opcional. Es la expresión para filtrar los resultados.

orderBy

string

Es opcional. Ordena los resultados según un orden definido. Valores admitidos: "name", "createTime".

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de 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)

Si la {ubicación} solicitada era "-", la respuesta contiene una lista de instancias de todas las ubicaciones. Se omitirán las instancias en ubicaciones inaccesibles.

nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/memorystore.read-write
  • https://www.googleapis.com/auth/memorystore.read-only

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • memorystore.instances.list

Para obtener más información, consulta la documentación de IAM.