Method: projects.locations.backupPlans.backups.list

Enumera las copias de seguridad de un BackupPlan determinado.

Solicitud HTTP

GET https://gkebackup.googleapis.com/v1/{parent=projects/*/locations/*/backupPlans/*}/backups

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El BackupPlan que contiene las copias de seguridad que se van a enumerar. Formato: projects/*/locations/*/backupPlans/*

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • gkebackup.backups.list

Parámetros de consulta

Parámetros
pageSize

integer

La cantidad objetivo de resultados que se mostrarán en una sola respuesta. Si no se especifica, el servicio elegirá un valor predeterminado. Ten en cuenta que la respuesta puede incluir una lista parcial y el emisor solo debe confiar en el nextPageToken de la respuesta para determinar si quedan más instancias para consultar.

pageToken

string

El valor de nextPageToken recibido de una llamada backups.list anterior. Proporciona esto para recuperar la página siguiente en una lista de resultados de varias páginas. Cuando ocurre la paginación, todos los demás parámetros proporcionados a backups.list deben coincidir con la llamada que proporcionó el token de la página.

filter

string

Expresión de coincidencia de campo que se usa para filtrar los resultados.

orderBy

string

Campo según el cual se ordenan los resultados.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta para backup.list.

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

Representación JSON
{
  "backups": [
    {
      object (Backup)
    }
  ],
  "nextPageToken": string
}
Campos
backups[]

object (Backup)

La lista de copias de seguridad que coinciden con los criterios especificados.

nextPageToken

string

Un token que se puede enviar como pageToken en una llamada backups.list posterior para recuperar la siguiente página de resultados. Si este campo se omite o está vacío, no hay más resultados para mostrar.

Alcances 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.