Tous les produits
Search
Centre de documentation

:ModifyAutoSnapshotPolicyEx

Dernière mise à jour :Aug 18, 2026

Modifie une politique de snapshot automatique. La modification prend effet immédiatement sur les disques auxquels la politique est appliquée.

Débogage

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

Paramètres de requête

ParamètreTypeObligatoireExempleDescription
ActionStringOuiModifyAutoSnapshotPolicyEx

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

regionIdStringOuicn-hangzhou

ID de région de la politique de snapshot automatique à modifier. Appelez l'opération DescribeRegions pour obtenir la liste des régions.

autoSnapshotPolicyIdStringOuisp-bp12m37ccmxvbmi5****

ID de la politique de snapshot automatique. Appelez l'opération DescribeAutoSnapshotPolicyEx pour consulter les politiques disponibles.

autoSnapshotPolicyNameStringNonSPTestName

Nom de la politique de snapshot automatique. Si ce paramètre est omis, le nom d'origine est conservé.

timePointsStringNon["0", "1"]

Heures de création des snapshots automatiques (UTC+8). Unité : heures. Valeurs valides : 0 à 23 (de 00:00:00 à 23:00:00). Par exemple, 1 correspond à 01:00:00.

Pour planifier plusieurs snapshots par jour, spécifiez plusieurs heures.

  • Jusqu'à 24 heures.
  • Format : tableau JSON, par exemple ["0", "1", ... "23"]. Séparez les valeurs par des virgules (,).
repeatWeekdaysStringNon["1", "7"]

Jours de création des snapshots automatiques. Valeurs valides : 1 à 7 (1 = lundi).

Pour planifier plusieurs snapshots par semaine, spécifiez plusieurs jours.

  • Jusqu'à sept jours.
  • Format : tableau JSON, par exemple ["1", "2" ... "7"]. Séparez les valeurs par des virgules (,).
retentionDaysIntegerNon30

Durée de conservation du snapshot automatique. Unité : jours. Valeurs valides :

  • -1 : Conservation permanente.
  • 1 à 65536 : Conservation pendant le nombre de jours spécifié.

Valeur par défaut : -1.

EnableCrossRegionCopyBooleanNonfalse

Active ou désactive la réplication inter-régions pour le snapshot automatique.

  • true : active la réplication.
  • false : désactive la réplication.
TargetCopyRegionsStringNon["cn-hangzhou"]

Région de destination de la copie du snapshot. Une seule région est autorisée.

CopiedSnapshotsRetentionDaysIntegerNon30

Durée de conservation de la copie du snapshot dans la région de destination. Unité : jours. Valeurs valides :

  • -1 : Conservation permanente.
  • 1 à 65535 : Conservation pendant le nombre de jours spécifié.

Valeur par défaut : -1.

Paramètres de réponse

Paramètre Type Exemple Description
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID de la requête.

Exemples

Exemple de requête

https://ecs.aliyuncs.com/?Action=ModifyAutoSnapshotPolicyEx
&autoSnapshotPolicyId=sp-bp12m37ccmxvbmi5****
&regionId=cn-hangzhou
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<ModifyAutoSnapshotPolicyResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ModifyAutoSnapshotPolicyResponse>

Format JSON

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

{
  "RequestId" : "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

Codes d'erreur

Code d'état HTTP Code d'erreur Message d'erreur Description
403 ParameterInvalid The specified RegionId parameter is invalid. Le paramètre regionId spécifié n'est pas valide.
403 ParameterInvalid The specified RepeatWeekDays parameter is invalid. Le paramètre repeatWeekdays spécifié n'est pas valide.
403 ParameterInvalid The specified TimePoints parameter is invalid. Le paramètre timePoints spécifié n'est pas valide.
403 ParameterInvalid The specified AutoSnapshotPolicyId is invalid. Le paramètre autoSnapshotPolicyId spécifié n'est pas valide.
403 ParameterInvalid The specified RetentionDays parameter is invalid. Le paramètre retentionDays spécifié n'est pas valide.
404 ParameterInvalid The specified automatic snapshot policy does not exist. Le paramètre autoSnapshotPolicyId spécifié n'existe pas.
404 ParameterInvalid The specified automatic snapshot policy does not exist in the region. Le paramètre autoSnapshotPolicyId spécifié n'existe pas dans la région.

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