Tous les produits
Search

Ce produit

    :CreateRestoreJob

    Centre de documentation

    :CreateRestoreJob

    Dernière mise à jour :Aug 07, 2026

    Crée une tâche de restauration.

    Description de l'opération

    • Crée une tâche de restauration en fonction de l'instantané sélectionné et de la destination de restauration.

    • Le type de source de données et le type de source de données de destination de restauration doivent être identiques.

    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:CreateRestoreJob

    create

    *All Resource

    *

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    RestoreType

    string

    Oui

    Le type de source de données de la destination de restauration. Valeurs valides :

    • ECS_FILE : restaure vers un fichier ECS.

    • OSS : restaure vers Alibaba Cloud OSS.

    • NAS : restaure vers Alibaba Cloud NAS.

    • COMMON_FILE_SYSTEM : restaure vers CPFS.

    • OTS_TABLE : restaure vers Alibaba Cloud OTS.

    • UDM_ECS_ROLLBACK : restaure vers une instance ECS Alibaba Cloud (migration par copie intégrale).

    ECS_FILE
    VaultId

    string

    Non

    L'identifiant du coffre de sauvegarde auquel appartient l'instantané de sauvegarde.

    v-*********************
    SnapshotId

    string

    Non

    L'identifiant de l'instantané de sauvegarde.

    s-********************
    SnapshotHash

    string

    Non

    La valeur de hachage de l'instantané de sauvegarde.

    f2fe...
    SourceType

    string

    Oui

    Le type de source de données. Valeurs valides :

    • ECS_FILE : restaure des fichiers ECS.

    • OSS : restaure Alibaba Cloud OSS.

    • NAS : restaure Alibaba Cloud NAS.

    • COMMON_FILE_SYSTEM : restaure vers CPFS.

    • OTS_TABLE : restaure vers Alibaba Cloud OTS.

    • UDM_ECS : restaure vers une instance ECS Alibaba Cloud (migration par copie intégrale).

    ECS_FILE
    Options

    string

    Non

    Les paramètres de la tâche de restauration.

    {\"includes\":[],\"excludes\":[],\"conflictPolicy\":\"OVERWRITE_EXISTING\"}
    TargetFileSystemId

    string

    Non

    Ce paramètre n'est valide que lorsque RestoreType est défini sur NAS. L'identifiant du système de fichiers de la destination de restauration.

    005494
    TargetCreateTime

    integer

    Non

    Ce paramètre n'est valide que lorsque RestoreType est défini sur NAS. L'heure de création du système de fichiers de destination. Cette valeur est un horodatage UNIX. Unité : secondes.

    1554347313
    TargetPath

    string

    Non

    Ce paramètre n'est valide que lorsque RestoreType est défini sur ECS_FILE. Le chemin d'accès au fichier de la destination de restauration.

    C:\
    TargetBucket

    string

    Non

    Ce paramètre n'est valide que lorsque RestoreType est défini sur OSS. Le nom du compartiment OSS de destination.

    hbr-backup-oss
    TargetPrefix

    string

    Non

    Ce paramètre n'est valide que lorsque RestoreType est défini sur OSS. Le préfixe d'objet de la destination de restauration.

    hbr
    UdmDetail

    object

    Non

    Ce paramètre n'est valide que lorsque SourceType est défini sur UDM_ECS. Les détails de la sauvegarde par migration par copie intégrale. Ce paramètre est une chaîne JSON. Les détails varient en fonction de la valeur de RestoreType :

    • UDM_ECS_DISK : clone de disque cloud ECS.

      • targetInstanceId : type chaîne, requis. Identifiant de l'instance ECS cible à laquelle le disque cloud cloné est attaché.

      • diskCategory : type chaîne, requis. Le type du disque cloud cible.

      • diskPerformanceLevel : type chaîne. Si diskCategory est défini sur essd, ce paramètre spécifie le niveau de performance (PL) du disque cloud. Valeurs valides : PL0, PL1, PL2 et PL3. Valeur par défaut : PL1.

    • UDM_ECS_DISK_ROLLBACK : restauration de disque cloud ECS.

      • sourceInstanceId : type chaîne, requis. Identifiant de l'instance ECS source.

      • foreceRestore : type booléen. Valeur par défaut : false. Indique si la restauration doit être forcée. Si foreceRestore est défini sur true, la tâche de restauration restaure tout de même le disque cloud même si le disque cloud sauvegardé a été détaché de l'instance ECS d'origine ou attaché à une nouvelle instance ECS. Procédez avec prudence.

      • bootAfterRestore : type booléen. Valeur par défaut : false. Indique si l'instance ECS doit être démarrée après la restauration.

    • UDM_ECS : clone par copie intégrale ECS.

      • bootAfterRestore : type booléen. Valeur par défaut : false. Indique si l'instance ECS doit être démarrée après la restauration.

      • diskCategory : type chaîne, requis. Le type du disque cloud cible.

      • diskPerformanceLevel : type chaîne. Si diskCategory est défini sur essd, ce paramètre spécifie le niveau de performance (PL) du disque cloud. Valeurs valides : PL0, PL1, PL2 et PL3. Valeur par défaut : PL1.

      • instanceType : type chaîne, requis. Le type d'instance de l'instance ECS cible.

      • restoredNetwork : type chaîne, requis. L'identifiant du vSwitch de l'instance ECS cible.

      • securityGroup : type chaîne, requis. L'identifiant du groupe de sécurité de l'instance ECS cible.

      • restoredName : type chaîne, requis. Le nom de l'instance de l'instance ECS cible.

      • restoredHostName : type chaîne, requis. Le nom d'hôte de l'instance ECS cible.

      • allocatePublicIp : type booléen. Valeur par défaut : false. Indique si une adresse IP publique doit être attribuée à l'instance ECS cible.

      • privateIpAddress : type chaîne. L'adresse IP interne de l'instance ECS cible. Si ce paramètre n'est pas spécifié, le protocole DHCP est utilisé pour attribuer une adresse IP de manière aléatoire.

    • UDM_ECS_ROLLBACK : restauration par copie intégrale ECS.

      • sourceInstanceId : type chaîne, requis. Identifiant de l'instance ECS source.

      • forceRestore : type booléen. Valeur par défaut : false. Indique si la restauration doit être forcée. Si foreceRestore est défini sur true, la tâche de restauration restaure tout de même le disque cloud même si le disque cloud sauvegardé a été détaché de l'instance ECS d'origine ou attaché à une nouvelle instance ECS. Procédez avec prudence.

      • bootAfterRestore : type booléen. Valeur par défaut : false. Indique si l'instance ECS doit être démarrée après la restauration.

    {\"sourceInstanceId\":\"i-uf62te6pm3iwsyxyz66q\",\"bootAfterRestore\":false}
    UdmRegionId

    string

    Non

    Ce paramètre n'est valide que lorsque SourceType est défini sur UDM_ECS. La région de destination pour la restauration.

    cn-shanghai
    TargetInstanceId

    string

    Non

    Ce paramètre n'est valide que lorsque RestoreType est défini sur ECS_FILE. L'identifiant de l'instance ECS de la destination de restauration.

    i-*********************
    Include

    string

    Non

    Le chemin d'accès à restaurer. Tous les fichiers sous ce chemin d'accès sont restaurés. Longueur maximale : 255 caractères.

    ["/home/alice/*.pdf", "/home/bob/*.txt"]
    Exclude

    string

    Non

    Le chemin d'accès à exclure de la restauration. Tous les fichiers sous ce chemin d'accès ne sont pas restaurés. Longueur maximale : 255 caractères.

    ["/var", "/proc"]
    TargetContainer

    string

    Non

    Les détails du conteneur cible pour la restauration.

    {\"host\":\"k8s-node1\",\"hostPrefix\":\"/var/lib/kubelet/pods/4acb31fe-8577-40ff-bc8c-eccabd835f73/volumes/kubernetes.io~csi/pvc-b050b00e-ef17-4792-aab1-1642355cf1f4/mount\",\"pvPath\":\"/\"}
    InitiatedByAck

    boolean

    Non

    Indique si l'opération est invoquée par Container Service. Valeur par défaut : false.

    false
    TargetContainerClusterId

    string

    Non

    L'identifiant du cluster de conteneurs cible pour la restauration.

    cc-000amjsc7o1h9506oob7
    TargetInstanceName

    string

    Non

    Le nom de l'instance Tablestore cible pour la restauration.

    instancename
    TargetTableName

    string

    Non

    Le nom de la table de données cible dans Tablestore pour la restauration.

    tablename
    TargetTime

    integer

    Non

    Le point dans le temps auquel les données Tablestore sont restaurées. Cette valeur est un horodatage UNIX. Unité : secondes.

    1642496881
    OtsDetail OtsTableRestoreDetail

    Non

    Les détails de l'instance Tablestore.

    CrossAccountType

    string

    Non

    Le type de sauvegarde inter-comptes. Valeurs valides :

    • SELF_ACCOUNT : sauvegarde au sein du compte actuel.

    • CROSS_ACCOUNT : sauvegarde inter-comptes.

    SELF_ACCOUNT
    CrossAccountUserId

    integer

    Non

    L'identifiant du compte source pour la sauvegarde inter-comptes gérée par le compte actuel.

    158975xxxxx4625
    CrossAccountRoleName

    string

    Non

    Le nom du rôle RAM créé dans le compte source pour la sauvegarde inter-comptes gérée par le compte actuel.

    BackupRole
    FailbackDetail

    object

    Non

    Les détails de la restauration vers l'hôte local.

    {"cpu":4,"extra":"{\"restoreVMNamePrefix\":\"627-\",\"dataCenterName\":\"SDDC-Datacenter\",\"dataStoreId\":\"datastore-50\",\"folderId\":\"group-v49\",\"resourcePoolId\":\"resgroup-46\",\"locationName\":\"vcenter.pc-uf600a******1.acvs.aliyuncs.com/SDDC-Datacenter/Workloads\",\"computeResourceName\":\"SDDC-Datacenter/Default_c-uf600a******\",\"dataStoreName\":\"Default_c-uf600a******/WorkloadDatastore\",\"networkMoReference\":\"DistributedVirtualPortgroup:dvportgroup-1001\",\"useHotAdd\":false}","instanceId":"i-2vc******z","memoryInMB":8192,"serverId":"0fdc0c86-eb92-4e05-91ab-eeaf9fb6ad01","uefiBoot":false}
    Edition

    string

    Non

    L'édition de la fonctionnalité Cloud Backup. Valeurs valides :

    • STANDARD : Édition Standard. Il s'agit de la valeur par défaut.

    • BASIC : Édition Essentielle. Actuellement, seule l'Édition Essentielle de sauvegarde de fichiers ECS est prise en charge.

    STANDARD

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    Code

    string

    Le code de réponse. La valeur 200 indique un succès.

    200
    Message

    string

    Le message de réponse. La valeur "successful" est renvoyée en cas de succès. Un message d'erreur est renvoyé en cas d'échec.

    successful
    RequestId

    string

    L'identifiant de la requête.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    Success

    boolean

    Indique si la requête a réussi.

    • true : la requête a réussi.

    • false : la requête a échoué.

    true
    RestoreId

    string

    L'identifiant de la tâche de restauration.

    r-*********************

    Exemples

    JSON format

    {
  "Code": "200",
  "Message": "successful",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Success": true,
  "RestoreId": "r-*********************"
}

    Codes d'erreur

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

    Notes de version

    Consultez Notes de version pour la liste complète.