Tous les produits
Search
Centre de documentation

:CreateHanaRestore

Dernière mise à jour :Aug 07, 2026

Crée une tâche de restauration pour une base de données SAP HANA.

Description de l'opération

Si vous appelez cette opération pour restaurer une base de données, la base de données est restaurée à un état spécifié. Procédez avec prudence. Pour plus d'informations, consultez Restaurer des bases de données sur une instance SAP HANA.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

hbr:CreateHanaRestore

create

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

VaultId

string

Non

L'identifiant du coffre de sauvegarde.

v-000************yqr

ClusterId

string

Oui

L'identifiant de l'instance SAP HANA que vous souhaitez restaurer.

cl-000fbrs5******ka9w

DatabaseName

string

Oui

Le nom de la base de données que vous souhaitez restaurer.

TS2

BackupId

integer

Non

L'identifiant de la sauvegarde.

1645628400235

Mode

string

Oui

Le mode de récupération. Valeurs valides :

  • RECOVERY_TO_MOST_RECENT : restaure la base de données à l'état disponible le plus récent pour lequel la base de données a été sauvegardée.

  • RECOVERY_TO_POINT_IN_TIME : restaure la base de données à un point dans le temps spécifié.

  • RECOVERY_TO_SPECIFIC_BACKUP : restaure la base de données à une sauvegarde spécifiée.

  • RECOVERY_TO_LOG_POSITION : restaure la base de données à une position de journal spécifiée.

RECOVERY_TO_POINT_IN_TIME

RecoveryPointInTime

integer

Non

Le point dans le temps auquel vous souhaitez restaurer la base de données. Ce paramètre n'est valide que si vous définissez le paramètre Mode sur RECOVERY_TO_POINT_IN_TIME. HBR restaure la base de données à un état le plus proche possible du point dans le temps spécifié.

1635315505

LogPosition

integer

Non

La position de journal à laquelle vous souhaitez restaurer la base de données. Ce paramètre n'est valide que si vous définissez le paramètre Mode sur RECOVERY_TO_LOG_POSITION.

0

VolumeId

integer

Non

L'identifiant du volume que vous souhaitez restaurer. Ce paramètre n'est valide que si vous définissez le paramètre Mode sur RECOVERY_TO_LOG_POSITION.

0

UseCatalog

boolean

Non

Indique si une sauvegarde de catalogue doit être utilisée pour restaurer la base de données. Ce paramètre n'est requis que si vous définissez le paramètre Mode sur RECOVERY_TO_SPECIFIC_BACKUP. Si vous désactivez l'option Utiliser le catalogue, vous devez spécifier le préfixe d'un fichier de sauvegarde. Cloud Backup recherche ensuite le fichier de sauvegarde en fonction du préfixe spécifié et restaure le fichier de sauvegarde.

false

BackupPrefix

string

Oui

Le préfixe de sauvegarde.

COMPLETE_DATA_BACKUP_2022_05_02_15_39

SystemCopy

boolean

Non

Indique si la base de données doit être restaurée sur une instance différente.

false

Source

string

Non

Le nom du système source. Ce paramètre spécifie le nom de la base de données source que vous souhaitez restaurer. Vous devez définir le paramètre au format <Nom de la base de données source>@SID.

HNP@HNP

SourceClusterId

string

Non

L'identifiant de l'instance SAP HANA source.

cl-000ii8tzv******xm0t

ClearLog

boolean

Non

Indique si toutes les entrées de journal doivent être supprimées de la zone de journal après la restauration des entrées de journal. Valeurs valides : true et false. Si vous définissez la valeur sur false, toutes les entrées de journal sont supprimées de la zone de journal après la restauration des entrées de journal.

false

CheckAccess

boolean

Non

Indique si la sauvegarde différentielle et la sauvegarde de journal doivent être validées. Valeurs valides : true et false. Si vous définissez la valeur sur true, HBR vérifie si la sauvegarde différentielle et la sauvegarde de journal requises sont disponibles avant le démarrage de la tâche de restauration. Si la sauvegarde différentielle ou la sauvegarde de journal n'est pas disponible, HBR ne démarre pas la tâche de restauration.

false

UseDelta

boolean

Non

Indique si une sauvegarde différentielle ou une sauvegarde incrémentielle doit être utilisée pour restaurer la base de données. Valeurs valides : true et false. Si vous souhaitez utiliser une sauvegarde différentielle ou une sauvegarde incrémentielle pour restaurer la base de données, définissez la valeur sur true. Si vous définissez la valeur sur false, HBR utilise une sauvegarde de journal pour restaurer la base de données.

true

SidAdmin

string

Non

Le compte administrateur SID créé par SAP HANA.

DB

MasterClientId

string

Non

L'identifiant du client sur lequel réside le nœud principal de SAP HANA.

c-000ii8tzv**********

Éléments de réponse

Élément

Type

Description

Exemple

object

Code

string

Le code d'état HTTP. Le code d'état 200 indique que l'appel a réussi.

200

Message

string

Le message renvoyé. Si l'appel réussit, la valeur « successful » est renvoyée. Si l'appel échoue, un message d'erreur est renvoyé.

successful

RequestId

string

L'identifiant de la requête.

EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F

Success

boolean

Indique si l'appel a réussi. Valeurs valides :

  • true : l'appel a réussi.

  • false : l'appel échoue.

true

RestoreId

string

L'identifiant de la tâche de restauration.

hr-000fb9bz190p1rse6jwv

Exemples

JSON format

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

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.