Method: projects.locations.instances.list

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

Solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Elemento superior del que se van a enumerar las instancias. Formato: projects/{project}/locations/{location}

Los parámetros de consulta

Parámetros
pageSize

integer

Opcional. Tamaño de la página solicitado. El servidor puede devolver menos elementos de los solicitados. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.

pageToken

string

Opcional. Un token con el que se identifica la página de resultados que el servidor debería devolver.

filter

string

Opcional. Expresión para filtrar los resultados.

orderBy

string

Opcional. Ordenar los resultados según un orden definido. Valores admitidos: "name" y "createTime".

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta de [instances.list][].

Si la solicitud se realiza correctamente, el cuerpo de la respuesta proporciona datos con la siguiente estructura:

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

object (Instance)

Si la {location} solicitada era "-", la respuesta contiene una lista de instancias de todas las ubicaciones. Las instancias de ubicaciones a las que no se pueda acceder se omitirán.

nextPageToken

string

Token que se puede enviar como pageToken para obtener la siguiente página. Si se omite este campo, no hay páginas posteriores.

unreachable[]

string

Ubicaciones a las que no se ha podido acceder.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Permisos de IAM

Requiere el siguiente permiso de gestión de identidades y accesos en el recurso parent:

  • memorystore.instances.list

Para obtener más información, consulta la documentación de gestión de identidades y accesos.