Tous les produits
Search
Centre de documentation

:CreatePolicyV2

Dernière mise à jour :Aug 21, 2026

Crée une stratégie.

Description de l'opération

Une stratégie de sauvegarde enregistre les informations requises pour la sauvegarde. Après l'exécution d'une stratégie de sauvegarde, une tâche de sauvegarde est générée pour enregistrer la progression et le résultat de la sauvegarde. Si la tâche de sauvegarde réussit, un instantané de sauvegarde est généré. Vous pouvez utiliser l'instantané de sauvegarde pour créer une tâche de restauration.

  • Une stratégie de sauvegarde prend en charge plusieurs types de sources de données, notamment la sauvegarde NAS, la sauvegarde OSS, la sauvegarde d'instances ECS, ECS File Backup Essential Edition, la sauvegarde de fichiers locaux, la sauvegarde Tablestore et la sauvegarde CPFS.

  • Une stratégie de sauvegarde ne prend en charge qu'une seule stratégie de cycle de sauvegarde avec un intervalle fixe.

  • Une stratégie de sauvegarde ne peut sauvegarder des données que dans un seul coffre 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

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

PolicyName

string

Non

Le nom de la stratégie.

Sauvegarde locale quotidienne + redondance géographique

PolicyType

string

Non

Le type de stratégie. Valeurs valides :

  • STANDARD : stratégie de sauvegarde générale. Prend en charge la sauvegarde de sources de données autres que les instances ECS.

  • UDM_ECS_ONLY : stratégie de sauvegarde d'instances ECS. Prend en charge uniquement la sauvegarde d'instances ECS.

Si vous ne spécifiez pas le type de stratégie, Cloud Backup définit automatiquement le type de stratégie en fonction de la spécification d'un coffre de sauvegarde dans les règles de stratégie :

  • Un coffre de sauvegarde est spécifié dans les règles de stratégie : STANDARD

  • Aucun coffre de sauvegarde n'est spécifié dans les règles de stratégie : UDM_ECS_ONLY

STANDARD

PolicyDescription

string

Non

La description de la stratégie.

Sauvegarde une fois par jour à 10h00, avec sauvegarde interrégionale vers Shanghai

Rules

array<object>

Non

La liste des règles de stratégie.

array<object>

Non

La règle de stratégie.

RuleType

string

Oui

Le type de règle. Chaque stratégie doit comporter au moins une règle BACKUP et exactement une règle TRANSITION. Valeurs valides :

  • BACKUP : règle de sauvegarde.

  • TRANSITION : règle de cycle de vie.

  • REPLICATION : règle de réplication.

  • TAG : règle d'association de ressources basée sur les balises.

Valeurs valides :

  • TRANSITION :

    Règle de cycle de vie.

  • BACKUP :

    Règle de sauvegarde.

  • REPLICATION :

    Règle de réplication.

  • SECURITY :

    Règle de sécurité.

  • TAG :

    Règle d'association de ressources basée sur les balises.

BACKUP

Schedule

string

Non

Ce paramètre est requis uniquement lorsque RuleType est défini sur BACKUP. Les paramètres de planification de la sauvegarde. Formats pris en charge :

  • I|{startTime}|{interval} : spécifie qu'une tâche de sauvegarde est exécutée à l'intervalle spécifié à partir de {startTime}. Par exemple, I|1631685600|P1D spécifie qu'une tâche de sauvegarde est exécutée une fois par jour à partir du 2021-09-15 14:00:00.

    • startTime : l'heure de début de la sauvegarde. Cette valeur est un horodatage UNIX. Unité : secondes.

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

  • C|{startTime}|{crontab} : spécifie qu'une tâche de sauvegarde est exécutée en fonction de l'expression {crontab} à partir de {startTime}. Par exemple, C|1631685600|0 0 2 ? * 3,5,7 spécifie qu'une tâche de sauvegarde est exécutée à 02:00:00 tous les mardis, jeudis et samedis à partir du 2021-09-15 14:00:00.

    • startTime : l'heure de début de la sauvegarde. Cette valeur est un horodatage UNIX. Unité : secondes.

    • crontab : l'expression crontab. Par exemple, 0 0 2 ? * 3,5,7 spécifie tous les mardis, jeudis et samedis à 02:00:00.

Les tâches de sauvegarde manquées ne sont pas compensées. Si la tâche de sauvegarde précédente n'est pas terminée, la tâche de sauvegarde suivante n'est pas déclenchée.

I|1648647166|P1D

BackupType

string

Non

Ce paramètre est requis uniquement lorsque RuleType est défini sur BACKUP. Le type de sauvegarde. Définissez la valeur sur COMPLETE, ce qui spécifie une sauvegarde complète.

Valeurs valides :

  • ARCHIVE_BY_SEARCH :

    Archive basée sur les résultats de recherche.

  • COMPLETE :

    Sauvegarde complète.

  • LOG :

    Sauvegarde du journal.

  • ARCHIVE :

    archive.

  • DIFFERENTIAL :

    Sauvegarde différentielle.

  • INDEX :

    index.

  • INCREMENTAL :

    Sauvegarde incrémentielle.

COMPLETE

Retention

integer

Non

Ce paramètre est requis uniquement lorsque RuleType est défini sur BACKUP, TRANSITION ou REPLICATION.

  • Si RuleType est défini sur BACKUP : la période de rétention des sauvegardes. La priorité de ce paramètre est inférieure à celle du paramètre Retention de la règle dont RuleType est TRANSITION. Valeur minimale : 1. Valeur maximale : 364635. Unité : jours.

  • Si RuleType est défini sur TRANSITION : la période de rétention des sauvegardes. Valeur minimale : 1. Valeur maximale : 364635. Unité : jours.

  • Si RuleType est défini sur REPLICATION : la période de rétention des sauvegardes interrégionales. Valeur minimale : 1. Valeur maximale : 364635. Unité : jours.

7

ReplicationRegionId

string

Non

Ce paramètre est requis uniquement lorsque RuleType est défini sur REPLICATION. L'identifiant de la région de destination pour la réplication.

cn-shanghai

ArchiveDays

integer

Non

Ce paramètre est requis uniquement lorsque RuleType est défini sur TRANSITION. Le nombre de jours après lesquels une sauvegarde est automatiquement déplacée vers le niveau d'archive. Les sauvegardes doivent être conservées dans le niveau standard pendant au moins 30 jours et dans le niveau d'archive pendant au moins 60 jours. Unité : jours.

90

RetentionRules

array<object>

Non

Ce paramètre est requis uniquement lorsque RuleType est défini sur TRANSITION. Les règles de rétention spéciales.

object

Non

La règle de rétention spéciale.

AdvancedRetentionType

string

Non

Le type de règle de rétention spéciale. Valeurs valides :

  • DAILY : sauvegarde quotidienne.

  • WEEKLY : sauvegarde hebdomadaire.

  • MONTHLY : sauvegarde mensuelle.

  • YEARLY : sauvegarde annuelle.

YEARLY

WhichSnapshot

integer

Non

La sauvegarde à laquelle la règle s'applique. Actuellement, seule la première sauvegarde est prise en charge. Définissez la valeur sur 1.

1

Retention

integer

Non

La période de rétention spéciale de la sauvegarde. Valeur minimale : 1. Unité : jours.

730

VaultId

string

Non

Ce paramètre est requis uniquement lorsque RuleType est défini sur BACKUP. L'identifiant du coffre de sauvegarde.

v-0001************aseg

KeepLatestSnapshots

integer

Non

Indique s'il faut conserver au moins une version de sauvegarde. Valeurs valides :

  • 0 : ne pas conserver.

  • 1 : conserver.

1

Immutable

boolean

Non

Ce paramètre est requis uniquement lorsque PolicyType est défini sur UDM_ECS_ONLY et que RuleType est défini sur SECURITY. Indique si le verrouillage des sauvegardes doit être activé.

true

DataSourceFilters

array<object>

Non

Ce paramètre est requis uniquement lorsque RuleType est défini sur TAG. Les règles de filtrage des sources de données.

object

Non

SourceType

string

Non

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

  • UDM_ECS : sauvegarde d'instance ECS. Ce type de source de données n'est pris en charge que lorsque PolicyType est défini sur UDM_ECS_ONLY.

  • OSS : sauvegarde OSS. Ce type de source de données n'est pris en charge que lorsque PolicyType est défini sur STANDARD.

  • NAS : sauvegarde Alibaba Cloud NAS. Ce type de source de données n'est pris en charge que lorsque PolicyType est défini sur STANDARD.

  • ECS_FILE : ECS File Backup Essential Edition. Ce type de source de données n'est pris en charge que lorsque PolicyType est défini sur STANDARD.

  • OTS : sauvegarde Tablestore. Ce type de source de données n'est pris en charge que lorsque PolicyType est défini sur STANDARD.

UDM_ECS

DataSourceIds deprecated

array

Non

Obsolète.

deprecated

string

Non

Obsolète.

Deprecated

TagFilters

array<object>

Non

Ce paramètre est requis uniquement lorsque RuleType est défini sur TAG. Les règles de filtrage des balises de ressources.

object

Non

Key

string

Non

La clé de la balise.

env

Value

string

Non

La valeur de la balise. Une valeur vide indique n'importe quelle valeur.

prod

Operator

string

Non

La règle de correspondance des balises. Valeurs valides :

  • EQUAL : correspond à la fois à la clé et à la valeur de la balise.

  • NOT : correspond à la clé de la balise mais pas à sa valeur.

EQUAL

Éléments de réponse

Élément

Type

Description

Exemple

object

CreatePolicyResponse.

Success

boolean

Indique si la requête a réussi. Valeurs valides :

  • true

  • false

true

Code

string

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

200

Message

string

Le message renvoyé. La valeur "successful" est renvoyée pour une requête réussie. Un message d'erreur est renvoyé pour une requête ayant échoué.

successful

RequestId

string

L'identifiant de la requête.

EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F

PolicyId

string

L'identifiant de la stratégie.

po-000000zemnuyx2li3y9y

Exemples

JSON format

{
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F",
  "PolicyId": "po-000000zemnuyx2li3y9y"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.