Method: projects.locations.backupCollections.list

Muestra una lista de todas las colecciones de copias de seguridad que pertenecen a un proyecto de consumidor en la ubicación especificada (región) o en todas las ubicaciones.

Si locationId se especifica como - (comodín), se consultan todas las regiones disponibles para el proyecto y se agregan los resultados.

Solicitud HTTP

GET https://memorystore.googleapis.com/v1alpha/{parent=projects/*/locations/*}/backupCollections

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 backupCollection con el formato projects/{projectId}/locations/{locationId}, en el que locationId hace referencia a una región de Google Cloud.

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. La cantidad máxima de elementos que se mostrarán.

Si no se especifica, el servicio usará un valor predeterminado de 1000. Sin importar el valor de pageSize, la respuesta puede incluir una lista parcial, y un emisor solo debe confiar en el nextPageToken de la respuesta para determinar si quedan más clústeres para consultar.
pageToken

string

Opcional. El valor de nextPageToken que se muestra de una solicitud [backupCollections.list] anterior, si existe.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta para [backupCollections.list].

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

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

object (BackupCollection)

Es una lista de backupCollections en el proyecto.

Si el locationId en el campo superior de la solicitud es “-”, se consultan todas las regiones disponibles para el proyecto y los resultados agregados. Si en una consulta agregada una ubicación no está disponible, se incluye una entrada de marcador de posición backupCollection en la respuesta con el campo name establecido en un valor del formulario projects/{projectId}/locations/{locationId}/backupCollections/, el campo status establecido en ERROR y el campo statusMessage establecido en "location not available for backupCollections.list".
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 en las que no se pudo acceder.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Permisos de IAM

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

  • memorystore.backupCollections.list

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