Method: projects.locations.backupCollections.list

Muestra todas las colecciones de copias de seguridad que pertenecen a un proyecto de consumidor en la ubicación (región) especificada 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/v1/{parent=projects/*/locations/*}/backupCollections

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

Parámetros de ruta

Parámetros
parent

string

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

Los parámetros de consulta

Parámetros
pageSize

integer

Opcional. 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 y el llamador solo debe usar nextPageToken de la respuesta para determinar si quedan más clústeres por consultar.

pageToken

string

Opcional. El valor nextPageToken devuelto por una solicitud [backupCollections.list] anterior, si la hay.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta de [backupCollections.list].

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

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

object (BackupCollection)

Lista de backupCollections del proyecto.

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. Si en una consulta agregada de este tipo no hay ninguna ubicación disponible, se incluye en la respuesta una entrada de backupCollection de marcador de posición con el campo name definido con un valor del formulario projects/{projectId}/locations/{locationId}/backupCollections/, el campo status definido como ERROR y el campo statusMessage definido como "location not available for backupCollections.list".

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

Permisos de IAM

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

  • memorystore.backupCollections.list

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