Method: projects.locations.backupCollections.list

Enumera todas las colecciones de copias de seguridad que posee un proyecto consumidor en la ubicación (región) especificada o en todas las ubicaciones.

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

Solicitud HTTP

GET https://redis.googleapis.com/v1/{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 1,000. 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

Es la 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 de este tipo no hay una ubicación disponible, se incluye en la respuesta una entrada de backupCollection de marcador de posición con el campo name establecido en un valor del formulario projects/{projectId}/locations/{locationId}/backupCollections/- y 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 a las que no se pudo llegar.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

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