CreateAutoSnapshotPolicy - Elastic Compute Service - Centre de documentation Alibaba Cloud

Crée une stratégie d'instantanés automatiques dans une région spécifiée. Vous pouvez spécifier le cycle de répétition, la période de rétention et les paramètres de sauvegarde interrégionale pour les instantanés automatiques afin de sauvegarder les données sur les disques système ou les disques de données.

Description de l'opération

Avant d'appeler cette opération, consultez Créer une stratégie d'instantanés automatiques.

Lorsque vous appelez cette opération, prenez note des éléments suivants :

Vous pouvez créer un maximum de 100 stratégies d'instantanés automatiques par région pour un compte Alibaba Cloud. Lorsque le nombre d'instantanés automatiques pour un disque atteint la limite de quota, le système supprime l'instantané automatique le plus ancien créé par la stratégie d'instantanés automatiques lorsqu'une nouvelle tâche de création d'instantané est lancée.
Le système n'exécute pas les stratégies d'instantanés automatiques lorsqu'une instance ECS a une tâche d'arrêt ou de redémarrage en attente.
Si la réplication interrégionale d'instantanés est activée et qu'aucun paramètre de chiffrement n'est configuré, les instantanés chiffrés sont chiffrés à l'aide de la clé de service de la région de destination par défaut. Pour plus d'informations sur la réplication interrégionale d'instantanés, consultez Copier un instantané.

Après avoir créé une stratégie d'instantanés automatiques, appelez ApplyAutoSnapshotPolicy pour appliquer la stratégie aux disques cibles. Pour modifier une stratégie d'instantanés automatiques, appelez ModifyAutoSnapshotPolicyEx.

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.

ecs:CreateAutoSnapshotPolicy

create

*AutoSnapshotPolicy.

acs:ecs:{#regionId}:{#accountId}:snapshotpolicy/*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
regionId	string	Oui	L'identifiant de la région de la stratégie d'instantanés automatiques. Vous pouvez appeler DescribeRegions pour obtenir la liste la plus récente des régions.	cn-hangzhou
autoSnapshotPolicyName	string	Non	Le nom de la stratégie d'instantanés automatiques. Le nom doit comporter de 2 à 128 caractères. Il doit commencer par une lettre et ne doit pas commencer par http:// ou https://. Le nom peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-). Valeur par défaut : null.	TestName
timePoints	string	Oui	Les heures auxquelles les instantanés automatiques sont créés. L'heure est affichée en UTC+8. Unité : heures. Valeurs valides : 0 à 23, qui représentent 00:00 à 23:00 (soit 24 heures au total). Par exemple, 1 correspond à 01:00. Description du format : La valeur du paramètre doit être un tableau JSON. Par exemple, ["1"] indique que les instantanés automatiques sont créés à 01:00. Pour créer plusieurs instantanés automatiques dans une journée, spécifiez plusieurs heures séparées par des virgules (,). Vous pouvez spécifier jusqu'à 24 heures. Par exemple, ["1","3","5"] indique que les instantanés automatiques sont créés à 01:00, 03:00 et 05:00. Remarque Si un disque contient une grande quantité de données et que le temps nécessaire pour créer un seul instantané automatique dépasse l'intervalle entre deux heures, l'heure suivante est ignorée. Par exemple, vous définissez 09:00, 10:00, 11:00 et 12:00 comme heures de création des instantanés automatiques. Étant donné que le disque contient une grande quantité de données, la création de l'instantané commence à 09:00 et se termine à 10:20, ce qui prend 80 minutes. Le système ignore l'heure de 10:00 et crée l'instantané automatique suivant à 11:00.	["0", "1", … "23"]
repeatWeekdays	string	Oui	Les jours de la semaine auxquels les instantanés automatiques sont créés. Unité : jours. Le cycle est hebdomadaire. Valeurs valides : 1 à 7. Par exemple, 1 correspond à lundi. Description du format : La valeur du paramètre doit être un tableau JSON. Par exemple, ["1"] indique que les instantanés automatiques sont créés tous les lundis. Pour créer plusieurs instantanés automatiques dans une semaine, spécifiez plusieurs jours séparés par des virgules (,). Vous pouvez spécifier jusqu'à 7 jours. Par exemple, ["1","3","5"] indique que les instantanés automatiques sont créés tous les lundis, mercredis et vendredis.	["1","2"]
retentionDays	integer	Oui	La période de rétention des instantanés automatiques. Unité : jours. Valeurs valides : -1 : les instantanés automatiques sont conservés de manière permanente. 1 à 65535 : les instantanés automatiques sont conservés pendant le nombre de jours spécifié. Valeur par défaut : -1.	30
EnableCrossRegionCopy	boolean	Non	Indique si la réplication interrégionale automatique doit être autorisée. true : autorise la réplication interrégionale automatique. false : n'autorise pas la réplication interrégionale automatique.	false
TargetCopyRegions	string	Non	La région de destination vers laquelle les instantanés sont répliqués. Vous pouvez spécifier une région de destination.	["cn-hangzhou"]
StorageLocationArn	string	Non	Remarque Ce paramètre n'est pas disponible publiquement.	null
CopiedSnapshotsRetentionDays	integer	Non	La période de rétention des réplicas d'instantanés interrégionaux. Unité : jours. Valeurs valides : -1 : les réplicas d'instantanés sont conservés de manière permanente. 1 à 65535 : les réplicas d'instantanés sont conservés pendant le nombre de jours spécifié. Valeur par défaut : -1.	30
CopyEncryptionConfiguration	object	Non	Les paramètres de chiffrement des sauvegardes pour la redondance géographique des instantanés.
Encrypted	boolean	Non	Indique si le chiffrement pour la sauvegarde interrégionale d'instantanés doit être activé. Valeurs valides : true : active le chiffrement. false : n'active pas le chiffrement. Valeur par défaut : false.	false
KMSKeyId	string	Non	L'identifiant de la clé KMS utilisée pour la sauvegarde interrégionale d'instantanés chiffrés.	0e478b7a-4262-4802-b8cb-00d3fb40826X
Arn	array<object>	Non	Remarque Ce paramètre n'est pas disponible publiquement.
	object	Non
RoleType	string	Non	Remarque Ce paramètre n'est pas disponible publiquement.	hide
Rolearn	string	Non	Remarque Ce paramètre n'est pas disponible publiquement.	hide
AssumeRoleFor	integer	Non	Remarque Ce paramètre n'est pas disponible publiquement.	1000000000
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-aek2kkmhmhs****
Tag	array<object>	Non	Les balises de la stratégie d'instantanés automatiques.
	object	Non
Key	string	Non	La clé de balise de la stratégie d'instantanés automatiques. Valeurs valides pour N : 1 à 20. La clé de balise ne peut pas être une chaîne vide. La clé de balise peut comporter jusqu'à 128 caractères et ne doit pas commencer par aliyun ou acs:. La clé de balise ne doit pas contenir http:// ou https://.	TestKey
Value	string	Non	La valeur de balise de la stratégie d'instantanés automatiques. Valeurs valides pour N : 1 à 20. La valeur de balise peut être une chaîne vide. La valeur de balise peut comporter jusqu'à 128 caractères et ne doit pas commencer par acs:. La valeur de balise ne doit pas contenir http:// ou https://.	TestValue
AssociationType	string	Non	Le type d'association entre la stratégie d'instantanés automatiques et les ressources cibles. Valeurs valides : ● AssociatedWithDisk : associé à des disques. ● AssociatedWithInstanceTag : associé à des balises d'instance. Valeur par défaut : AssociatedWithDisk.	AssociatedWithDisk
TargetTags	array<object>	Non	La liste des balises de ressources cibles. La stratégie d'instantanés automatiques associe les ressources cibles en fonction des balises. Lorsque AssociationType est défini sur AssociatedWithInstanceTag, ce paramètre est requis.
	object	Non	La balise de ressource cible.
Key	string	Non	La clé de balise. Valeurs valides pour N : 1 à 10. La clé de balise ne peut pas être une chaîne vide. La clé de balise peut comporter jusqu'à 128 caractères et ne doit pas commencer par aliyun ou acs:. La clé de balise ne doit pas contenir http:// ou https://.
Value	string	Non	La valeur de balise. Valeurs valides pour N : 1 à 10. La valeur de balise peut comporter jusqu'à 128 caractères et ne doit pas contenir http:// ou https://. Remarque : Si vous transmettez une valeur vide ou une chaîne vide, cela correspond à n'importe quelle valeur.

Éléments de réponse

Élément	Type	Description	Exemple
	object
AutoSnapshotPolicyId	string	L'identifiant de la stratégie d'instantanés automatiques.	sp-bp12m37ccmxvbmi5****
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemples

JSON format

{
  "AutoSnapshotPolicyId": "sp-bp12m37ccmxvbmi5****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	DiskCategory.OperationNotSupported	The type of the specified disk does not support creating a snapshot.
400	InvalidSnapshotPolicyName.Malformed	The specified autoSnapshotPolicyName is malformed.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.
400	InvalidParameter.EncryptedIllegal	The specified parameter Encrypted must be true when kmsKeyId is not empty.
400	InvalidParameter.KmsNotEnabled	Failed to perform this operation because KMS is not activated.
400	InvalidParameter.Encrypted.KmsNotEnable	Failed to perform this operation because KMS is not activated.
400	InvalidParam.EncryptedMismatch	Creating encrypted disks with shared encrypted image requires replacing encryption keys.
400	InvalidAssociationType.Malformed	The specified parameter AssociationType is invalid. Please check the valid range for this parameter.
400	MissingParameter.TargetTags	When the parameter AssociationType is set to AssociatedWithInstanceTag, the TargetTags parameter is required.
400	InvalidTargetTags.NotSupported	When the parameter AssociationType is set to AssociatedWithDisk, the TargetTags parameter is not supported.
400	InvalidTargetTagKey.Malformed	The specified TargetTag.n.Key [%s] is not valid.
400	InvalidTargetTagValue.Malformed	The specified TargetTag.n.Value [%s] is not valid.
400	Duplicate.TargetTagKey	Duplicate keys exist in the specified parameter TargetTags. Please ensure key uniqueness.
400	InvalidTargetTag.LimitExceed	The number [%s] of the specified parameter TargetTag exceeds the limit [%s].
403	ParameterInvalid	The specified RegionId parameter is invalid.
403	AutoSnapshotPolicy.QuotaExceed	The maximum number of automatic snapshot policy has been reached.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.
403	InvalidParameter.TargetCopyRegions	The specified TargetCopyRegions is invalid.
403	InvalidParameter.CopiedSnapshotsRetentionDays	The specified CopiedSnapshotsRetentionDays is invalid.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
403	InvalidOperation.KMSKeyIdNotFound	The specified KMSKeyId not found, %s.
403	Abs.InvalidAction.RegionNotSupport	This region does not support this action.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK (Customer Master Key) must be in an active state.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK(Customer Master Key) lacks authorization to add tags to the ECS service.
403	InvalidStorageLocationArn.Malformed	The specified parameter StorageLocationArn is malformed.
403	InvalidOperation.UserNotInWhiteList	The current user is temporarily unable to use this feature. Please submit a ticket for assistance.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.

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

Notes de version

Consultez Notes de version pour la liste complète.