Todos os produtos
Search
Central de documentação

Cloud Backup:DescribeHanaBackupsAsync

Última atualização: Jun 28, 2026

Consulta um ou mais backups do SAP HANA que atendem às condições especificadas.

Descrição da operação

Após chamar a operação DescribeHanaBackupsAsync para consultar os backups do SAP HANA que atendem às condições especificadas, chame a operação DescribeTask para consultar o resultado final.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

VaultId

string

Não

O ID do cofre de backup.

v-000270c******pi81

ClusterId

string

Sim

O ID da instância do SAP HANA.

cl-00098******yuqvu

PageNumber

integer

Não

O número da página. As páginas começam na página 1. Valor padrão: 1.

1

PageSize

integer

Não

O número de entradas por página. Valores válidos: 1 a 99. Valor padrão: 10.

10

DatabaseName

string

Não

O nome do banco de dados.

BPD

Mode

string

Não

O modo de recuperação. Valores válidos:

  • RECOVERY_TO_MOST_RECENT: restaura o banco de dados para o estado disponível mais recente para o qual o banco de dados foi submetido a backup.

  • RECOVERY_TO_POINT_IN_TIME: restaura o banco de dados para um ponto no tempo especificado.

  • RECOVERY_TO_SPECIFIC_BACKUP: restaura o banco de dados para um backup especificado.

  • RECOVERY_TO_LOG_POSITION: restaura o banco de dados para uma posição de log especificada.

RECOVERY_TO_SPECIFIC_BACKUP

RecoveryPointInTime

integer

Não

O ponto no tempo para o qual você deseja restaurar o banco de dados. Este parâmetro é válido apenas se você definir o parâmetro Mode como RECOVERY_TO_POINT_IN_TIME. O Cloud Backup restaura o banco de dados para um estado o mais próximo possível do ponto no tempo especificado.

1649851200

LogPosition

integer

Não

A posição de log para a qual você deseja restaurar o banco de dados. Este parâmetro é válido apenas se você definir o parâmetro Mode como RECOVERY_TO_LOG_POSITION.

0

VolumeId

integer

Não

O ID do volume que você deseja restaurar. Este parâmetro é válido apenas se você definir o parâmetro Mode como RECOVERY_TO_LOG_POSITION.

0

SystemCopy

boolean

Não

Especifica se o banco de dados deve ser restaurado para uma instância diferente.

  • true: restaura o banco de dados para uma instância diferente.

  • false: restaura o banco de dados na mesma instância.

true

Source

string

Não

O nome do sistema de origem. Este parâmetro especifica o nome do banco de dados de origem que você deseja restaurar. Você deve definir o parâmetro no formato <Nome do banco de dados de origem>@SID.

P01@HP1

SourceClusterId

string

Não

O ID da instância do SAP HANA de origem.

cl-0000g3m******5cj

IncludeDifferential

boolean

Não

Especifica se os backups diferenciais devem ser incluídos nos resultados da consulta. Valores válidos:

  • true: inclui backups diferenciais.

  • false: exclui backups diferenciais.

false

IncludeIncremental

boolean

Não

Especifica se os backups incrementais devem ser incluídos nos resultados da consulta. Valores válidos:

  • true: inclui backups incrementais.

  • false: exclui backups incrementais.

true

IncludeLog

boolean

Não

Especifica se os backups de log devem ser incluídos nos resultados da consulta. Valores válidos:

  • true: inclui backups de log.

  • false: exclui backups de log.

true

UseBackint

boolean

Não

Especifica se o Backint é usado. Valores válidos:

  • true: o Backint é usado.

  • false: o Backint não é usado.

false

ResourceGroupId

string

Não

O ID do grupo de recursos.

rg-acfmz7mced2ldhy

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Code

string

O código de resposta. O código de status 200 indica que a solicitação foi bem-sucedida.

200

Message

string

A mensagem retornada. Se a solicitação for bem-sucedida, "successful" será retornado. Se a solicitação falhar, uma mensagem de erro será retornada.

successful

RequestId

string

O ID da solicitação.

31F97233-8563-563D-8880-914B00EEA928

TaskId

string

O ID do job assíncrono. Você pode chamar a operação DescribeTask para consultar o resultado da execução de um job assíncrono.

t-0006xmbplrqebt9dhkth

Success

boolean

Indica se a solicitação foi bem-sucedida. Valores válidos:

  • true

  • false

true

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "31F97233-8563-563D-8880-914B00EEA928",
  "TaskId": "t-0006xmbplrqebt9dhkth",
  "Success": true
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.