CreateHanaRestore - Cloud Backup: Central de Documentação do Alibaba Cloud

Cria um trabalho de restauração para um banco de dados SAP HANA.

Descrição da operação

Chama a operação CreateHanaRestore para restaurar um banco de dados especificado para um estado especificado. Prossiga com cautela. Para mais informações, consulte Restaurar o SAP HANA.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

hbr:CreateHanaRestore

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
VaultId	string	Não	O ID do cofre de backup.	v-000************yqr
ClusterId	string	Sim	O ID da instância SAP HANA a ser recuperada.	cl-000fbrs5******ka9w
DatabaseName	string	Sim	O nome do banco de dados a ser restaurado.	TS2
BackupId	integer	Não	O ID do backup.	1645628400235
Mode	string	Sim	O modo de restauração. Valores válidos: RECOVERY_TO_MOST_RECENT: Hora mais recente. Restaura o banco de dados para o estado disponível mais recente com base nos backups. RECOVERY_TO_POINT_IN_TIME: Hora específica. Restaura o banco de dados para um ponto específico no tempo. RECOVERY_TO_SPECIFIC_BACKUP: Backup específico. Restaura o banco de dados para um backup de banco de dados específico. RECOVERY_TO_LOG_POSITION: Posição do log. Restaura o banco de dados para uma posição de log específica.	RECOVERY_TO_POINT_IN_TIME
RecoveryPointInTime	integer	Não	O ponto no tempo para o qual você deseja restaurar o banco de dados. Este parâmetro é válido apenas quando o parâmetro Mode está definido como RECOVERY_TO_POINT_IN_TIME. O sistema restaura o banco de dados para o estado mais próximo deste ponto no tempo.	1635315505
LogPosition	integer	Não	A posição do log. Este parâmetro é válido apenas quando o parâmetro Mode está definido como RECOVERY_TO_LOG_POSITION.	0
VolumeId	integer	Não	O ID do volume a ser restaurado. Este parâmetro é válido apenas quando o parâmetro Mode está definido como RECOVERY_TO_LOG_POSITION.	0
UseCatalog	boolean	Não	Especifica se deve pesquisar backups no catálogo. Este parâmetro é válido apenas quando o parâmetro Mode está definido como RECOVERY_TO_SPECIFIC_BACKUP. Se você não usar o catálogo, deverá especificar um prefixo de backup, e o Cloud Backup restaurará o banco de dados com base no prefixo de backup.	false
BackupPrefix	string	Sim	O prefixo do backup.	COMPLETE_DATA_BACKUP_2022_05_02_15_39
SystemCopy	boolean	Não	Especifica se deve realizar uma restauração entre instâncias.	false
Source	string	Não	O nome do sistema de origem. Este parâmetro especifica o nome do banco de dados de origem a ser restaurado, no formato `nome do banco de dados de origem@SID`.	HNP@HNP
SourceClusterId	string	Não	O ID da instância SAP HANA de origem.	cl-000ii8tzv******xm0t
ClearLog	boolean	Não	Especifica se deve inicializar a área de log. Se você não quiser restaurar os segmentos de log que residem na área de log, defina este parâmetro como false. Após a conclusão do trabalho de restauração, as entradas de log são excluídas da área de log.	false
CheckAccess	boolean	Não	Especifica se deve verificar a disponibilidade de backups diferenciais e de log. Se você ativar esta opção, o sistema verificará se os backups diferenciais e de log necessários estão disponíveis no início do trabalho de restauração. Se um backup diferencial ou de log estiver ausente, o trabalho de restauração será interrompido antes que quaisquer dados sejam alterados.	false
UseDelta	boolean	Não	Especifica se deve usar backups diferenciais. Selecione esta opção se desejar realizar uma restauração usando backups diferenciais ou incrementais. Se você optar por realizar uma restauração sem usar backups diferenciais ou incrementais, os backups de log serão usados para a restauração.	true
SidAdmin	string	Não	A conta SidAdmin, que é uma conta de sistema criada pelo SAP HANA.	DB
MasterClientId	string	Não	O ID do cliente do nó mestre do HANA.	c-000ii8tzv**********

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	string	O código de retorno. Um valor 200 indica sucesso.	200
Message	string	A mensagem de retorno. O valor successful é retornado se a chamada for bem-sucedida, e uma mensagem de erro é retornada se a chamada falhar.	successful
RequestId	string	O ID da solicitação.	EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F
Success	boolean	Indica se a solicitação foi bem-sucedida. Valores válidos: true: Bem-sucedida. false: Falhou.	true
RestoreId	string	O ID do trabalho de restauração.	hr-000fb9bz190p1rse6jwv

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F",
  "Success": true,
  "RestoreId": "hr-000fb9bz190p1rse6jwv"
}

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.