Method: projects.locations.backupPlans.backups.volumeBackups.list

Enumera los recursos VolumeBackup para una copia de seguridad determinada.

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. La copia de seguridad que contiene los VolumeBackups que se deben enumerar. Formato: projects/*/locations/*/backupPlans/*/backups/*

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

  • gkebackup.volumeBackups.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 volumeBackups.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 volumeBackups.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 volumeBackups.list.

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

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

object (VolumeBackup)

La lista de VolumeBackups que coinciden con los criterios determinados.

nextPageToken

string

Un token que se puede enviar como pageToken en una llamada volumeBackups.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.