- Solicitud HTTP
- Parámetros de ruta
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
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 |
Obligatorio Es el nombre del recurso de la ubicación de la instancia con el formato |
Parámetros de consulta
Parámetros | |
---|---|
pageSize |
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 |
El valor nextPageToken que se muestra de una solicitud de lista previa, si existe. |
filter |
Filtro de lista. Por ejemplo, para excluir todas las instancias de Memcached con el nombre como my-instance, especifique “name != my-instance”. |
orderBy |
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 ( |
Campos | |
---|---|
resources[] |
Una lista de instancias de Memcached en el proyecto en la ubicación especificada o en todas las ubicaciones. Si el |
nextPageToken |
Token para recuperar la página siguiente de resultados o vaciar si no hay más resultados en la lista. |
unreachable[] |
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.