Method: projects.locations.instances.list

Muestra las instancias de una ubicación determinada.

Solicitud HTTP

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

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

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Nombre de recurso de la ubicación de la instancia con el formato projects/{projectId}/locations/{locationId}, donde locationId hace referencia a una región de GCP.

Los parámetros de consulta

Parámetros
pageSize

integer

Número máximo de elementos que se devolverán.

Si no se especifica, el servicio usará el valor predeterminado 1000. Independientemente del valor de pageSize, la respuesta puede incluir una lista parcial, por lo que el llamante solo debe usar el valor de nextPageToken de la respuesta para determinar si quedan más instancias que consultar.
pageToken

string

El valor nextPageToken devuelto por una solicitud List anterior, si la hay.
filter

string

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

string

Ordenar los resultados. Los valores posibles son "name", "name desc" o "" (sin ordenar).

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta a instances.list.

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

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

object (Instance)

Lista de instancias de Memcached del proyecto en la ubicación especificada o en todas las ubicaciones.

Si el valor de locationId del campo superior de la solicitud es "-", se consultarán todas las regiones disponibles para el proyecto y se agregarán los resultados.
nextPageToken

string

Token para obtener la siguiente página de resultados. Si no hay más resultados en la lista, se devuelve un valor vacío.
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

Para obtener más información, consulta el Authentication Overview.