Method: projects.locations.backupPlans.backups.list

Lista os backups de um determinado BackupPlan.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O BackupPlan que contém os backups a serem listados. Formato: projects/*/locations/*/backupPlans/*

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • gkebackup.backups.list

Parâmetros de consulta

Parâmetros
pageSize

integer

O número pretendido de resultados a serem retornados em uma única resposta. Se não for especificado, um valor padrão será escolhido pelo serviço. A resposta pode incluir uma lista parcial. O autor da chamada precisa confiar apenas no nextPageToken da resposta para determinar se há mais instâncias a serem consultadas.
pageToken

string

O valor de nextPageToken recebido de uma chamada anterior de backups.list. Forneça isso para recuperar a página seguinte em uma lista de resultados com várias páginas. Ao paginar, todos os outros parâmetros fornecidos para backups.list precisam corresponder à chamada que forneceu o token da página.
filter

string

Expressão de correspondência de campo usada para filtrar os resultados.
orderBy

string

Campo pelo qual ordenar os resultados.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para backups.list.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "backups": [
    {
      object (Backup)
    }
  ],
  "nextPageToken": string
}
Campos
backups[]

object (Backup)

A lista de backups que correspondem aos critérios fornecidos.
nextPageToken

string

Um token que pode ser enviado como pageToken em uma chamada backups.list seguinte para recuperar a próxima página de resultados. Se o campo for omitido ou estiver vazio, não haverá mais resultados para retornar.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.