Tous les produits
Search
Centre de documentation

:ModifyAdvancedBackupPolicy

Dernière mise à jour :Aug 28, 2026

Modifie la stratégie de sauvegarde avancée.

Description de l'opération

La sauvegarde par redondance géographique s'applique uniquement aux instances de jeu de réplicas sur disque cloud et aux instances de cluster fragmenté sur disque cloud.

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

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

DBInstanceId

string

Oui

L'identifiant de l'instance.

dds-2zeb2d64cb46xxxx

PreferredBackupTime

string

Non

L'heure à laquelle effectuer la sauvegarde. L'heure est au format HH:mmZ-HH:mmZ (UTC).

Remarque

La plage horaire est limitée à 1 heure.

09:00Z-10:00Z

SnapshotBackupType

string

Non

Le type de sauvegarde par instantané. Valeurs valides :

  • Flash : Sauvegarde en quelques secondes.

  • Standard : Sauvegarde standard (valeur par défaut).

Standard

BackupRetentionPolicyOnClusterDeletion

integer

Oui

La stratégie de rétention des données de sauvegarde.

  • 0 : Tous les jeux de sauvegarde de l'instance sont immédiatement supprimés lorsque l'instance est libérée.

  • 1 : Le dernier jeu de sauvegarde est conservé avec une rétention à long terme (LTR) lorsque l'instance est libérée.

  • 2 : Tous les jeux de sauvegarde sont conservés avec une rétention à long terme (LTR) lorsque l'instance est libérée.

0

AdvancedBackupDataPolicies

array<object>

Non

La liste des stratégies de sauvegarde.

object

Non

PolicyId

string

Non

L'identifiant de la stratégie de sauvegarde.

Important Ce paramètre est requis lorsque ActionType n'est pas défini sur CREATE.

xxxxxx

ActionType

string

Oui

Le type d'action. Valeurs valides :

  • CREATE : Créer.

  • UPDATE : Mettre à jour.

  • DELETE : Supprimer. Dans ce cas, seul PolicyId est requis pour les autres paramètres.

CREATE

RetentionType

string

Non

Le type de période de rétention du jeu de sauvegarde.

  • never : Rétention à long terme (LTR).

  • delay : Rétention pour un nombre fixe de jours.
    Important Ce paramètre est requis lorsque ActionType n'est pas défini sur DELETE.

delay

RetentionPeriod

integer

Non

Le nombre de jours de rétention du plan de sauvegarde.

  • Sauvegarde dans la même région : de 7 à 7 300 jours.

  • Sauvegarde par redondance géographique : de 3 à 1 825 jours.
    Important Ce paramètre est requis lorsque RetentionType est défini sur delay.

7

BackupPolicy

string

Non

Le type de planification de la stratégie avancée. Valeurs valides :

  • dayOfWeek : planifié par semaine.

  • dayOfMonth : planifié par mois.

  • dayOfYear : planifié par année.

  • backupInterval : planifié à intervalles fixes (sauvegarde haute fréquence).

Remarque
  • Plusieurs stratégies de sauvegarde haute fréquence ne sont pas prises en charge.

  • Plusieurs stratégies de sauvegarde par redondance géographique ne sont pas prises en charge, et les stratégies de sauvegarde par redondance géographique prennent uniquement en charge dayOfWeek.

Important Ce paramètre est requis lorsque ActionType n'est pas défini sur DELETE.

dayOfWeek

PreferredBackupPeriod

string

Non

Le cycle de sauvegarde.

  • Si BackupPolicy est défini sur dayOfWeek : 1, 2, 3, 4, 5, 6, 7 indique du lundi au dimanche. Au moins 2 sauvegardes par semaine sont requises.

  • Si BackupPolicy est défini sur dayOfMonth : 1, 3, -1 indique le 1er, le 3e et le dernier jour de chaque mois. -1 indique le dernier jour de chaque mois.

  • Si BackupPolicy est défini sur dayOfYear : 01-07 indique le 7 janvier. Un seul jour peut être sélectionné.

  • Si BackupPolicy est défini sur backupInterval : sélectionnez l'une des valeurs suivantes en minutes. Pour les instances de cluster fragmenté, les valeurs valides sont 30, 60, 120, 180, 240, 360, 480 et 720. Pour les instances de jeu de réplicas, les valeurs valides sont 15, 30, 60, 120, 180, 240, 360, 480 et 720.

Important Ce paramètre est requis lorsque ActionType n'est pas défini sur DELETE. Les stratégies de sauvegarde par redondance géographique prennent uniquement en charge dayOfWeek.

1,4,6

SrcRegion

string

Non

La région où réside l'instance.

Important Ce paramètre est requis lorsque ActionType n'est pas défini sur DELETE.

cn-guangzhou

SrcType

string

Non

Le type source de la stratégie de sauvegarde.

  • db : sauvegarde dans la même région.

  • level1 : sauvegarde interrégionale.
    Important Ce paramètre est requis lorsque ActionType n'est pas défini sur DELETE.

db

DestRegion

string

Non

La région de destination de la stratégie de sauvegarde.

Important Ce paramètre est requis lorsque ActionType n'est pas défini sur DELETE.

cn-guangzhou

DestType

string

Non

Le type de destination de la stratégie de sauvegarde.

  • level1 : sauvegarde dans la même région.

  • level2Cross : sauvegarde interrégionale.
    Important Ce paramètre est requis lorsque ActionType n'est pas défini sur DELETE.

level1

PreserveOneEachHour

boolean

Non

Indique si la sauvegarde clairsemée horaire doit être activée.

  • true : Lorsque la fréquence de sauvegarde est à la minute, tous les instantanés dans l'heure suivant l'heure actuelle sont conservés. Pour les instantanés datant de plus d'une heure mais de moins de 24 heures par rapport à l'heure actuelle, seul le premier instantané après chaque heure est conservé.

  • false : Tous les instantanés dans la période de rétention de sauvegarde haute fréquence sont conservés.

False

AdvancedBackupLogPolicies

array<object>

Non

La liste des stratégies de sauvegarde des journaux.

object

Non

EnableLogBackup

integer

Oui

Indique si la sauvegarde des journaux doit être activée.

  • 1 : Activée.

  • 0 : Désactivée.

Remarque
  • La sauvegarde des journaux doit être activée pour les instances de cluster fragmenté.

  • La sauvegarde des journaux interrégionale nécessite que la sauvegarde des journaux dans la même région soit d'abord activée.

1

RetentionType

string

Non

Le type de période de rétention de la sauvegarde des journaux.

  • never : Rétention à long terme (LTR).

  • delay : Rétention pour un nombre fixe de jours.

delay

RetentionPeriod

integer

Non

Le nombre de jours de rétention des sauvegardes de journaux. Ce paramètre prend effet lorsque RetentionType est défini sur delay.

  • Sauvegarde dans la même région : de 7 à 7 300 jours.

  • Sauvegarde par redondance géographique : de 3 à 1 825 jours. La valeur doit être inférieure à la période de rétention de sauvegarde de la stratégie de sauvegarde par redondance géographique.

7

SrcRegion

string

Non

La région où réside l'instance source.

cn-hangzhou

SrcType

string

Non

Le type source de la stratégie de sauvegarde des journaux.

  • db : sauvegarde dans la même région.

  • level1 : sauvegarde interrégionale.

db

DestRegion

string

Non

La région où réside la sauvegarde des journaux par redondance géographique.

Remarque

Ce paramètre est requis pour la sauvegarde par redondance géographique.

cn-huhehaote

DestType

string

Non

Le type de destination de la stratégie de sauvegarde des journaux.

  • level1 : sauvegarde dans la même région.

  • level2Cross : sauvegarde interrégionale.

level1

PolicyId

string

Non

L'identifiant de la stratégie de sauvegarde des journaux. Ce paramètre existe uniquement pour les stratégies de sauvegarde des journaux interrégionales et est requis.

xxxx

ActionType

string

Oui

Le type d'action.

  • CREATE : Créer.

  • UPDATE : Mettre à jour.
    Important Ce paramètre s'applique uniquement à la sauvegarde par redondance géographique. Pour supprimer la sauvegarde par redondance géographique, utilisez UPDATE avec EnableLogBackup défini sur 0.

CREATE

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

L'identifiant de la requête.

2F42BB4E-461F-5B55-A37C-53B1141C****

Exemples

JSON format

{
  "RequestId": "2F42BB4E-461F-5B55-A37C-53B1141C****"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidPreferredBackupPeriod.Malformed Specified parameter PreferredBackupPeriod is not valid.
400 InvalidPreferredBackupTime.Malformed Specified parameter PreferredBackupTime is not valid.

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

Notes de version

Consultez Notes de version pour la liste complète.