Tous les produits
Search

Ce produit

    :UpdateBackupPlan

    Centre de documentation

    :UpdateBackupPlan

    Dernière mise à jour :Aug 07, 2026

    Met à jour un plan de sauvegarde.

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

    update

    *All Resource

    *

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    PlanId

    string

    Oui

    L'identifiant du plan de sauvegarde.

    plan-20211***735
    PlanName

    string

    Non

    Le nom du plan de sauvegarde.

    planname
    Schedule

    string

    Non

    La stratégie de sauvegarde. Utilisez le format I|{startTime}|{interval}. Cela indique qu'une tâche de sauvegarde s'exécute à intervalles réguliers. {startTime} correspond à l'heure de début de la sauvegarde. {interval} correspond au temps entre les tâches. HBR n'exécute pas les tâches de sauvegarde en retard. Si la tâche de sauvegarde précédente n'est pas terminée, la suivante ne démarre pas. Par exemple, I|1631685600|P1D signifie que la sauvegarde s'exécute une fois par jour, à partir de 14:00:00 le 15 septembre 2021.

    • startTime : L'heure de début de la sauvegarde. Il s'agit d'un horodatage UNIX en secondes.

    • interval : L'intervalle de temps. Utilisez la norme ISO 8601. Par exemple, PT1H spécifie un intervalle d'une heure. P1D spécifie un intervalle d'un jour.

    I|1602673264|P1D
    Retention

    integer

    Non

    Le nombre de jours de conservation des sauvegardes. La valeur minimale est 1.

    7
    Prefix

    string

    Non

    Ce paramètre est requis uniquement lorsque SourceType est défini sur OSS. Ce paramètre spécifie le préfixe des objets à sauvegarder. Après avoir spécifié un préfixe, seuls les objets correspondant à ce préfixe sont sauvegardés.

    oss-prefix
    VaultId

    string

    Non

    L'identifiant du référentiel de sauvegarde.

    v-0006******q
    Detail

    object

    Non

    Les détails de la sauvegarde de l'instance ECS. Il s'agit d'une chaîne JSON.

    • snapshotGroup : Indique s'il faut utiliser un groupe cohérent au niveau des instantanés. Cette fonctionnalité n'est disponible que lorsque tous les disques de l'instance sont des disques SSD améliorés (ESSD).

    • appConsistent : Indique s'il faut activer la cohérence des applications. Vous devez également configurer les paramètres preScriptPath et postScriptPath.

    • preScriptPath : Le chemin d'accès au script de pré-gel.

    • postScriptPath : Le chemin d'accès au script de post-dégel.

    {"EnableFsFreeze":true,"appConsistent":false,"postScriptPath":"","preScriptPath":"","snapshotGroup":true,"timeoutInSeconds":60}
    SourceType

    string

    Non

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

    • ECS_FILE : Sauvegarde les fichiers ECS.

    • OSS : Sauvegarde Alibaba Cloud OSS.

    • NAS : Sauvegarde Alibaba Cloud NAS.

    • OTS : Sauvegarde Alibaba Cloud Tablestore.

    • UDM_ECS : Sauvegarde une instance ECS entière.

    ECS_FILE
    SpeedLimit

    string

    Non

    Ce paramètre est requis uniquement lorsque SourceType est défini sur ECS_FILE. Ce paramètre spécifie la mise en forme du trafic pour les sauvegardes. La mise en forme du trafic vous aide à contrôler le trafic de sauvegarde pendant les heures de pointe afin d'éviter d'affecter vos services. Le format est {start}|{end}|{bandwidth}. Vous pouvez spécifier plusieurs règles de mise en forme du trafic. Séparez-les par des barres verticales (|). Les plages horaires des règles ne peuvent pas se chevaucher.

    • start : L'heure de début.

    • end : L'heure de fin.

    • bandwidth : La vitesse maximale. Unité : Ko/s.

    0:24:5120
    Include

    string

    Non

    Ce paramètre est requis uniquement lorsque SourceType est défini sur ECS_FILE. Ce paramètre spécifie les chemins d'accès aux fichiers à sauvegarder. Tous les fichiers situés dans les chemins d'accès spécifiés sont sauvegardés. La valeur peut comporter jusqu'à 255 caractères.

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

    string

    Non

    Ce paramètre est requis uniquement lorsque SourceType est défini sur ECS_FILE. Ce paramètre spécifie les chemins d'accès aux fichiers à exclure de la sauvegarde. Tous les fichiers situés dans les chemins d'accès spécifiés ne sont pas sauvegardés. La valeur peut comporter jusqu'à 255 caractères.

    ["/var", "/proc"]
    Options

    string

    Non

    Ce paramètre est requis uniquement lorsque SourceType est défini sur ECS_FILE. Ce paramètre indique s'il faut utiliser le Volume Shadow Copy Service (VSS) pour définir le chemin de sauvegarde.

    • Cette fonctionnalité n'est disponible que pour les instances ECS Windows.

    • Si des modifications de données se produisent dans la source de sauvegarde, définissez ce paramètre sur ["UseVSS":true] pour garantir la cohérence des données.

    • Si vous activez VSS, vous ne pouvez pas sauvegarder plusieurs répertoires de fichiers en même temps.

    {"UseVSS":false}
    UpdatePaths

    boolean

    Non

    Indique s'il faut mettre à jour les chemins de sauvegarde si le paramètre Path est vide.

    • true : Met à jour les chemins de sauvegarde en fonction des chemins spécifiés dans cet appel.

    • false : Ne met pas à jour les chemins de sauvegarde. Les chemins de sauvegarde configurés lors de la création du plan de sauvegarde sont utilisés.

    false
    Path

    array

    Non

    Les chemins de sauvegarde.

    string

    Non

    Le chemin de sauvegarde. La valeur peut comporter jusqu'à 65 536 caractères. Les règles suivantes s'appliquent :

    • Si vous n'utilisez pas de caractères génériques (*), vous pouvez saisir jusqu'à 20 chemins.

    • Si vous utilisez des caractères génériques (*), vous ne pouvez saisir qu'un seul chemin. Les caractères génériques tels que /*/* sont pris en charge.

    • Chaque chemin doit être un chemin absolu.

    • Si vous utilisez VSS, vous ne pouvez pas spécifier plusieurs chemins, des chemins UNC, des caractères génériques ou des fichiers exclus.

    • Si vous utilisez un chemin UNC, vous ne pouvez pas utiliser VSS, des caractères génériques ou des fichiers exclus. Si la source de sauvegarde contient un chemin UNC, les listes de contrôle d'accès (ACL) Windows ne sont pas sauvegardées.

    ["/home"]
    Rule

    array<object>

    Non

    Les règles du plan de sauvegarde.

    object

    Non

    DestinationRetention

    integer

    Non

    Le nombre de jours de conservation de la sauvegarde géo-redondante.

    7
    Schedule

    string

    Non

    La stratégie de sauvegarde. Utilisez le format I|{startTime}|{interval}. Cela indique qu'une tâche de sauvegarde s'exécute à intervalles réguliers. {startTime} correspond à l'heure de début de la sauvegarde. {interval} correspond au temps entre les tâches. HBR n'exécute pas les tâches de sauvegarde en retard. Si la tâche de sauvegarde précédente n'est pas terminée, la suivante ne démarre pas. Par exemple, I|1631685600|P1D signifie que la sauvegarde s'exécute une fois par jour, à partir de 14:00:00 le 15 septembre 2021.

    startTime : L'heure de début de la sauvegarde. Il s'agit d'un horodatage UNIX en secondes. interval : L'intervalle de temps. Utilisez la norme ISO 8601. Par exemple, PT1H spécifie un intervalle d'une heure. P1D spécifie un intervalle d'un jour.

    I|1631685600|P1D
    Disabled

    boolean

    Non

    Indique s'il faut désactiver la stratégie.

    false
    Retention

    integer

    Non

    Le nombre de jours de conservation des sauvegardes. La valeur minimale est 1.

    7
    DoCopy

    boolean

    Non

    Indique s'il faut activer la réplication géo-redondante.

    false
    DestinationRegionId

    string

    Non

    L'identifiant de la région de destination pour la sauvegarde géo-redondante.

    cn-shanghai
    RuleName

    string

    Non

    Le nom de la stratégie.

    rule-test-name
    BackupType

    string

    Non

    Le type de sauvegarde. Définissez la valeur sur COMPLETE. Cela indique une sauvegarde complète.

    COMPLETE
    OtsDetail OtsDetail

    Non

    Les détails de l'instance Tablestore.

    KeepLatestSnapshots

    integer

    Non

    Indique s'il faut conserver définitivement la dernière version de sauvegarde.

    • 0 : Non

    • 1 : Oui

    1
    ChangeListPath

    string

    Non

    La configuration de la liste de synchronisation incrémentielle des fichiers. (Ce paramètre est requis uniquement pour la synchronisation de fichiers.)

    {"dataSourceId": "ds-123456789", "path": "/changelist"}
    Edition

    string

    Non

    L'édition. Valeurs valides : BASIC et STANDARD. Valeur par défaut : STANDARD.

    STANDARD

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    Code

    string

    Le code de retour. Une valeur de 200 indique que la requête a réussi.

    200
    Message

    string

    Le message renvoyé. Si la requête réussit, successful est renvoyé. Si la requête échoue, un message d'erreur est renvoyé.

    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

    Exemples

    JSON format

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

    Codes d'erreur

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

    Notes de version

    Consultez Notes de version pour la liste complète.