CreateSnapshot - - Centre de documentation Alibaba Cloud

Description

La fonctionnalité de snapshot local est remplacée par la fonctionnalité d'accès instantané.

Si vous avez utilisé la fonctionnalité de snapshot local avant le 14 décembre 2020, vous pouvez utiliser les paramètres Category ou InstantAccess normalement, en tenant compte des éléments suivants :
- Les paramètres Category et InstantAccess ne peuvent pas être spécifiés simultanément.
- Si aucun des paramètres Category et InstantAccess n'est spécifié, des snapshots normaux sont créés.
Si vous n'avez pas utilisé la fonctionnalité de snapshot local avant le 14 décembre 2020, vous pouvez utiliser le paramètre InstantAccess mais ne pouvez pas utiliser le paramètre Category.

Vous ne pouvez pas créer de snapshots pour un disque dans les scénarios suivants :

Le nombre de snapshots manuels du disque a atteint 256.
Un snapshot est en cours de création pour le disque.
L'instance Elastic Compute Service (ECS) à laquelle le disque est attaché n'a jamais été démarrée.
L'instance ECS à laquelle le disque est attaché n'est pas dans l'état Stopped (Stopped) ou Running (Running).
Si la réponse contient {"OperationLocks": {"LockReason" : "security"}} lorsque vous interrogez les informations de l'instance, celle-ci est verrouillée pour des raisons de sécurité et toutes les opérations y sont interdites.

Lors de la création d'un snapshot, tenez compte des éléments suivants :

Si un snapshot est en cours de création, vous ne pouvez pas l'utiliser pour créer une image personnalisée en appelant l'opération CreateImage.
Lorsqu'un snapshot est en cours de création pour un disque attaché à une instance ECS, ne modifiez pas l'état de l'instance.
Vous pouvez créer des snapshots pour un disque dont l'état est Expired (Expired). Si l'heure de libération planifiée pour un disque arrive alors qu'un snapshot est en cours de création pour ce disque, le snapshot se trouve dans l'état Creating (Creating) et est supprimé lors de la libération du disque.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	CreateSnapshot	Opération à effectuer. Définissez la valeur sur CreateSnapshot.
DiskId	String	Oui	d-bp1s5fnvk4gn2tws0****	ID du disque.
SnapshotName	String	Non	testSnapshotName	Nom du snapshot. La longueur doit être comprise entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par `http://` ou `https://`. Il peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-). Il ne peut pas commencer par `auto`, car les snapshots dont les noms commencent par auto sont reconnus comme des snapshots automatiques.
Description	String	Non	testDescription	Description du snapshot. La longueur doit être comprise entre 2 et 256 caractères et ne peut pas commencer par `http://` ou `https://`. Ce paramètre est vide par défaut.
RetentionDays	Integer	Non	30	Période de rétention du snapshot. Valeurs valides : 1 à 65536. Unité : jours. Le snapshot est automatiquement libéré à l'expiration de sa période de rétention. Ce paramètre est vide par défaut, ce qui indique que le snapshot n'est pas automatiquement libéré.
Category	String	Non	Standard	Type du snapshot. Valeurs valides : Standard : snapshot normal Flash : snapshot local Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser le paramètre `InstantAccess` pour garantir la compatibilité future. Ce paramètre et le paramètre `InstantAccess` ne peuvent pas être spécifiés simultanément. Pour plus d'informations, consultez la section « Description » de cette rubrique.
ClientToken	String	Non	123e4567-e89b-12d3-a456-426655440000	Jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer la valeur, mais vous devez vous assurer qu'elle est unique parmi différentes requêtes. La valeur ClientToken ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez la rubrique Comment garantir l'idempotence.
ResourceGroupId	String	Non	rg-bp67acfmxazb4p****	ID du groupe de ressources auquel attribuer le snapshot.
InstantAccess	Boolean	Non	false	Indique si la fonctionnalité d'accès instantané est activée. Valeurs valides : true : active la fonctionnalité d'accès instantané. Cette fonctionnalité ne peut être activée que pour les disques ESSD (Enhanced SSD). Remarque Une fois la fonctionnalité d'accès instantané activée, le snapshot peut être utilisé pour restaurer des disques ou créer des disques entre zones, même lorsque le snapshot est en cours de création. Cette fonctionnalité garantit un accès instantané à un nouveau snapshot pour un disque ESSD, quelle que soit la taille du disque ESSD. false : n'active pas la fonctionnalité d'accès instantané. Si InstantAccess est défini sur false, un snapshot normal est créé. Valeur par défaut : false. Remarque Ce paramètre et le paramètre `Category` ne peuvent pas être spécifiés simultanément. Pour plus d'informations, consultez la section « Description » de cette rubrique.
InstantAccessRetentionDays	Integer	Non	1	Période de validité de la fonctionnalité d'accès instantané. À la fin de la période de validité, la fonctionnalité est désactivée et le snapshot d'accès instantané (IA) est automatiquement libéré. Ce paramètre prend effet uniquement lorsque `InstantAccess` est défini sur true. Unité : jours. Valeurs valides : 1 à 65535. Par défaut, la valeur de ce paramètre est identique à celle de `RetentionDays`.
Tag.N.key	String	Non	null	Clé du tag N à ajouter au snapshot. Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser le paramètre Tag.N.Key pour garantir la compatibilité future.
Tag.N.Key	String	Non	TestKey	Clé du tag N à ajouter au snapshot. Valeurs valides de N : 1 à 20. La clé du tag ne peut pas être une chaîne vide. Sa longueur maximale est de 128 caractères et elle ne peut pas commencer par acs: ou aliyun. Elle ne peut pas contenir http:// ou https://.
Tag.N.Value	String	Non	TestValue	Valeur du tag N à ajouter au snapshot. Valeurs valides de N : 1 à 20. La valeur du tag peut être une chaîne vide. Sa longueur maximale est de 128 caractères et elle ne peut pas commencer par acs: ni contenir http:// ou https://.
Tag.N.value	String	Non	null	Valeur du tag N à ajouter au snapshot. Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser le paramètre Tag.N.Value pour garantir la compatibilité future.
StorageLocationArn	String	Non	null	Remarque Ce paramètre n'est pas disponible.

Paramètres de réponse

Paramètre

Type

Exemple

Description

SnapshotId

String

s-bp17441ohwka0yuh****

ID du snapshot.

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID de la requête.

Exemples

Exemple de requête

https://ecs.aliyuncs.com/?Action=CreateSnapshot
&DiskId=d-bp1s5fnvk4gn2tws0****
&SnapshotName=testSnapshotName
&Description=testDescription
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<CreateSnapshotResponse>
        <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
        <SnapshotId>s-bp17441ohwka0yuh****</SnapshotId>
</CreateSnapshotResponse>

Format JSON

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

{
  "RequestId" : "C8B26B44-0189-443E-9816-D951F59623A9",
  "SnapshotId" : "s-bp17441ohwka0yuh****"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist.	Message d'erreur renvoyé car l'ID de clé Key Management Service (KMS) spécifié n'existe pas.
400	InvalidSnapshotName.Malformed	The specified SnapshotName is wrongly formed.	Message d'erreur renvoyé car le paramètre SnapshotName spécifié n'est pas valide.
400	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Message d'erreur renvoyé car l'opération n'est pas prise en charge tant que la ressource se trouve dans l'état actuel.
400	DiskCategory.OperationNotSupported	The operation is not supported to the specified disk due to its disk category	Message d'erreur renvoyé car la catégorie de disque spécifiée ne prend pas en charge cette opération.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Message d'erreur renvoyé car la clé de tag spécifiée existe déjà. Les clés de tag doivent être uniques.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Message d'erreur renvoyé car le paramètre Tag.N.Key spécifié n'est pas valide.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Message d'erreur renvoyé car le paramètre Tag.N.Value spécifié n'est pas valide.
400	InvalidRetentionDays.Malformed	The specified RetentionDays is not valid.	Message d'erreur renvoyé car le paramètre RetentionDays spécifié n'est pas valide.
403	Throttling	Request was denied due to user flow control.	Message d'erreur renvoyé car votre requête est limitée en débit. Réessayez ultérieurement.
403	IncorrectDiskStatus.CreatingSnapshot	A previous snapshot creation is in process.	Message d'erreur renvoyé car un autre snapshot est en cours de création pour le disque. Attendez que le snapshot soit créé et réessayez.
403	InstanceLockedForSecurity	The disk attached instance is locked due to security.	Message d'erreur renvoyé car l'instance à laquelle le disque est attaché est verrouillée pour des raisons de sécurité.
403	IncorrectDiskStatus.NeverAttached	The specified disk has never been attached to any instance.	Message d'erreur renvoyé car le disque amovible n'a jamais été attaché à des instances et ses données restent inchangées.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.	Message d'erreur renvoyé car le nombre maximal de snapshots a été atteint. Pour créer de nouveaux snapshots, supprimez les snapshots qui ne sont plus nécessaires.
403	IncorrectDiskStatus.NeverUsed	The specified disk has never been used after creating.	Message d'erreur renvoyé car le disque spécifié n'a jamais été utilisé et ses données restent inchangées.
403	CreateSnapshot.Failed	The process of creating snapshot is failed.	Message d'erreur renvoyé car le snapshot ne peut pas être créé.
403	DiskInArrears	The specified operation is denied as your disk has expired.	Message d'erreur renvoyé car le disque a expiré en raison d'un paiement en retard.
403	DiskId.ValueNotSupported	The specified parameter diskid is not supported.	Message d'erreur renvoyé car la catégorie du périphérique Elastic Block Storage (EBS) spécifié ne prend pas en charge cette opération.
403	IncorrectDiskStatus	The current disk status does not support this operation.	Message d'erreur renvoyé car l'opération n'est pas prise en charge tant que le disque se trouve dans l'état actuel. Assurez-vous que le disque est utilisable et que vous n'avez aucun impayé le concernant.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Message d'erreur renvoyé car le solde de votre compte est insuffisant. Approvisionnez votre compte et réessayez.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	Message d'erreur renvoyé car l'opération n'est pas prise en charge tant que le service de snapshot n'est pas activé.
403	IncorrectVolumeStatus	The current volume status does not support this operation.	Message d'erreur renvoyé car l'opération n'est pas prise en charge tant que le périphérique Shared Block Storage se trouve dans l'état actuel.
403	IdempotentParameterMismatch	The specified clientToken is used.	Message d'erreur renvoyé car le jeton client spécifié est déjà utilisé.
403	IncorrectDiskType.NotSupport	The specified device type is not supported.	Message d'erreur renvoyé car le type de disque spécifié ne prend pas en charge l'opération.
403	IncorrectDiskStatus.Transferring	The specified device is transferring, you can retry after the process is finished.	Message d'erreur renvoyé car le disque spécifié est en cours de migration. Attendez que le disque soit migré et réessayez.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	Message d'erreur renvoyé car la clé maître cliente (CMK) n'est pas activée lorsqu'un ID de clé KMS est spécifié pour un disque. Vous pouvez appeler l'opération DescribeKey de KMS pour interroger les informations relatives à la CMK spécifiée.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.	Message d'erreur renvoyé car ECS n'est pas autorisé à accéder à vos ressources KMS.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.	Message d'erreur renvoyé car une requête idempotente précédente est en cours de traitement. Réessayez ultérieurement.
403	QuotaExceed.Tags	%s	Message d'erreur renvoyé car le nombre de tags spécifiés dépasse la limite supérieure. %s est une variable. Un message d'erreur est renvoyé dynamiquement en fonction des conditions d'appel.
403	InvalidSnapshotCategory.Malformed	The specified Category is not valid.	Message d'erreur renvoyé car le paramètre Category spécifié n'est pas valide.
403	IncorrectDiskStatus.Invalid	The specified disk status invalid, restart instance and try again.	Message d'erreur renvoyé car l'état du disque spécifié n'est pas valide. Redémarrez l'instance et réessayez.
404	InvalidDiskId.NotFound	The specified DiskId does not exist.	Message d'erreur renvoyé car le paramètre DiskId spécifié n'existe pas.
404	InvalidDescription.Malformed	The specified description is wrongly formed.	Message d'erreur renvoyé car le paramètre Description spécifié n'est pas valide. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par http:// ou https://.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Message d'erreur renvoyé car l'ID d'instance spécifié n'existe pas. Vérifiez si l'ID d'instance est correct.
404	InvalidVolumeId.NotFound	The specified volume does not exist.	Message d'erreur renvoyé car le périphérique Shared Block Storage spécifié n'existe pas. Vérifiez si l'ID du périphérique Shared Block Storage est correct.
500	InternalError	The request processing has failed due to some unknown error.	Message d'erreur renvoyé car une erreur interne s'est produite. Réessayez ultérieurement.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Message d'erreur renvoyé car une erreur interne s'est produite. Réessayez ultérieurement.

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