Tous les produits
Search
Centre de documentation

:DescribeBackupPolicy

Dernière mise à jour :Aug 08, 2026

Cette rubrique explique comment interroger la politique de sauvegarde d'une instance ApsaraDB for MongoDB.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. L'outil génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

DescribeBackupPolicy

Opération à effectuer. Définissez la valeur sur DescribeBackupPolicy.

DBInstanceId

String

Oui

dds-bp16cb162771****

ID de l'instance.

Paramètres de réponse

Paramètre Type Exemple Description
PreferredBackupPeriod String Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday

Jour de la semaine pour la sauvegarde des données. Valeurs valides :

  • Monday
  • Tuesday
  • Wednesday
  • Thursday
  • Friday
  • Saturday
  • Sunday
RequestId String 5A9464CA-F7DC-5434-90B1-DF7F197C****

ID de la requête.

PreferredBackupTime String 09:00Z-10:00Z

Plage horaire de sauvegarde des données. Format : HH:mmZ-HH:mmZ (UTC).

BackupRetentionPeriod String 30

Durée de conservation des sauvegardes (en jours).

EnableBackupLog Integer 1

Indique si la sauvegarde des journaux est activée. Valeur par défaut : 0. Valeurs valides :

  • 0 : désactive la sauvegarde des journaux.
  • 1 : active la sauvegarde des journaux.
LogBackupRetentionPeriod Integer 7

Durée de conservation des sauvegardes de journaux (en jours). Valeurs valides : 7 à 730.

SnapshotBackupType String Standard

Type de sauvegarde par snapshot. Valeur par défaut : Standard. Valeurs valides :

  • Flash : sauvegarde en quelques secondes
  • Standard : sauvegarde standard
BackupInterval Integer -1

Fréquence des sauvegardes haute fréquence. Valeurs valides :

  • -1 : désactive les sauvegardes haute fréquence.
  • 15 : toutes les 15 minutes.
  • 30 : toutes les 30 minutes.
  • 60 : toutes les heures.
  • 120 : toutes les 2 heures.
  • 180 : toutes les 3 heures.
  • 240 : toutes les 4 heures.
  • 360 : toutes les 6 heures.
  • 480 : toutes les 8 heures.
  • 720 : toutes les 12 heures.

Exemples

Exemples de requêtes

http(s)://mongodb.aliyuncs.com/?Action=DescribeBackupPolicy
DBInstanceId=dds-bp16cb162771****
&<Common request parameters>

Exemples de réponses réussies

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeBackupPolicyResponse>
    <PreferredBackupPeriod>Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday</PreferredBackupPeriod>
    <RequestId>5A9464CA-F7DC-5434-90B1-DF7F197C****</RequestId>
    <PreferredBackupTime>09:00Z-10:00Z</PreferredBackupTime>
    <BackupRetentionPeriod>30</BackupRetentionPeriod>
    <EnableBackupLog>1</EnableBackupLog>
    <LogBackupRetentionPeriod>7</LogBackupRetentionPeriod>
    <SnapshotBackupType>Standard</SnapshotBackupType>
    <BackupInterval>-1</BackupInterval>
</DescribeBackupPolicyResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PreferredBackupPeriod" : "Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday",
  "RequestId" : "5A9464CA-F7DC-5434-90B1-DF7F197C****",
  "PreferredBackupTime" : "09:00Z-10:00Z",
  "BackupRetentionPeriod" : 30,
  "EnableBackupLog" : 1,
  "LogBackupRetentionPeriod" : 7,
  "SnapshotBackupType" : "Standard",
  "BackupInterval" : -1
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.