Tous les produits
Search
Centre de documentation

Elastic Compute Service:CreateSnapshot

Dernière mise à jour :Oct 09, 2026

Crée un instantané pour un disque.

Description de l'opération

Les instantanés locaux ont été remplacés par la fonctionnalité d'accès instantané aux instantanés. Les descriptions des paramètres sont les suivantes :

  • Si vous avez utilisé des instantanés locaux avant le 14 décembre 2020, vous pouvez continuer à utiliser le paramètre Category normalement.

  • Si vous n'avez pas utilisé d'instantanés locaux avant le 14 décembre 2020, aucune configuration supplémentaire n'est requise. Les instantanés créés pour les disques de la série ESSD (ESSD, ESSD AutoPL, ESSD Entry et ESSD régional) ont l'accès instantané activé par défaut après leur création, et les instantanés manuels et automatiques sont tous deux pris en charge. Les paramètres InstantAccess, InstantAccessRetentionDays et DisableInstantAccess liés à la fonctionnalité d'accès instantané aux instantanés ne prennent plus effet dans les opérations API. Les opérations API DescribeSnapshots et DescribeSnapshotGroups ajoutent le paramètre de réponse Available pour décrire l'état d'activation des instantanés.

Avant de commencer :

  • Le service d'instantanés est activé. Pour plus d'informations, consultez Activer les instantanés.

  • Le disque doit être à l'état en cours d'utilisation ou non attaché. Notez les points suivants concernant les différents états :

    • Si le disque est à l'état en cours d'utilisation, l'instance doit être à l'état en cours d'exécution ou arrêtée.

    • Si le disque est à l'état non attaché, assurez-vous que le disque a déjà été attaché à une instance ECS. Les instantanés ne peuvent pas être créés pour des disques qui n'ont jamais été attachés à une instance ECS.

    • Lorsqu'un disque est utilisé pour créer un volume étendu dynamique ou une matrice RAID, nous vous recommandons d'utiliser un groupe d'instantanés cohérents et d'activer les instantanés cohérents au niveau de l'application pour sauvegarder les données. Un groupe d'instantanés cohérents garantit la cohérence chronologique des données écrites sur les disques et assure la cohérence en cas de plantage dans les scénarios où un système métier s'étend sur plusieurs disques. Pour plus d'informations, consultez Créer un groupe d'instantanés cohérents et Créer un instantané cohérent au niveau de l'application.

Lors de la création d'un instantané, prenez note des éléments suivants :

  • Évitez de créer des instantanés pendant les heures de pointe d'activité. Lors de la création d'un instantané, les performances d'E/S du disque diminuent de moins de 10 %, et les performances de lecture et d'écriture peuvent subir de brefs ralentissements instantanés.

  • Si la création de l'instantané n'est pas terminée, l'instantané ne peut pas être utilisé pour créer une image personnalisée (CreateImage).

  • Pendant la création de l'instantané, les données incrémentielles générées par les opérations sur le disque ne sont pas sauvegardées dans l'instantané.

  • Si le disque est attaché à une instance ECS, ne modifiez pas l'état de l'instance, par exemple en arrêtant ou en redémarrant l'instance ECS, pendant la création de l'instantané. Sinon, la création de l'instantané échoue.

  • Les disques pour lesquels des instantanés sont en cours de création ne prennent pas en charge le redimensionnement. Attendez que l'instantané soit créé avant de redimensionner le disque.

  • Vous pouvez créer des instantanés pour les disques dans l'état expiré (Expired). Si un disque atteint sa date d'expiration et de libération pendant la création d'un instantané, l'instantané dans l'état en cours de création (Creating) est supprimé lorsque le disque est libéré.

  • Une fois l'instantané créé, le système vous facture l'instantané en fonction de sa taille dans chaque région. Pour plus d'informations, consultez Facturation des instantanés.

  • Vous ne pouvez pas créer d'instantanés pour un disque spécifié dans les scénarios suivants :

    • Le nombre d'instantanés manuels conservés pour le disque a atteint la limite supérieure. Pour plus d'informations, consultez Limites des instantanés.

    • Il existe des limites de simultanéité pour la création d'instantanés. Le dépassement de ces limites entraîne l'échec de la création. Pour plus d'informations, consultez Limites des instantanés.

    • Lorsque vous interrogez les informations de l'instance ECS, si les données renvoyées contiennent {"OperationLocks": {"LockReason" : "security"}}, toutes les opérations sont interdites.

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:CreateSnapshot

create

*Disk.

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

*Snapshot.

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

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

DiskId

string

Oui

L'identifiant du disque. Vous pouvez appeler l'opération DescribeDisks et filtrer les disques attachés à une instance à l'aide du paramètre InstanceId. Le disque utilisé pour créer un instantané doit être dans l'état en cours d'utilisation ou non attaché. Un disque non attaché doit avoir été attaché à une instance ECS au préalable.

d-bp1s5fnvk4gn2tws0****

SnapshotName

string

Non

Le nom de l'instantané. Le nom doit comporter de 2 à 128 caractères. Il doit commencer par une lettre et peut contenir des lettres Unicode (y compris des lettres anglaises et chinoises) et des chiffres ASCII (0 à 9). Il peut également contenir des deux-points (:), des traits de soulignement (_), des points (.) et des traits d'union (-).\n\n> Le nom ne peut pas commencer par http:// ou https://. Pour éviter les conflits de noms avec les instantanés automatiques, le nom ne peut pas commencer par auto.

testSnapshotName

Description

string

Non

La description de l'instantané. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://.\n\nValeur par défaut : vide.

testDescription

RetentionDays

integer

Non

Paramètres de la période de rétention de l'instantané. Unité : jours. Valeurs valides : 1 à 65536. Une fois la période de rétention expirée, la libération automatique est déclenchée pour l'instantané.\n\nValeur par défaut : vide, ce qui indique que l'instantané n'est pas soumis à la libération automatique.

30

Category

string

Non

Le type d'instantané. Valeurs valides :

  • Standard : instantané standard.

  • Flash : instantané local.

Remarque

Ce paramètre est sur le point d'être obsolète. Les instantanés standard pour les disques ESSD (SSD d'entreprise, et non SSD standard) ont été mis à niveau pour bénéficier de l'accès instantané activé par défaut. Aucune configuration supplémentaire n'est requise et aucun frais supplémentaire n'est facturé.

Standard

ClientToken

string

Non

Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique parmi les différentes requêtes. Le paramètre ClientToken ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.

123e4567-e89b-12d3-a456-426655440000

ResourceGroupId

string

Non

L'identifiant du groupe de ressources auquel l'instantané appartient.

rg-bp67acfmxazb4p****

InstantAccess

boolean

Non

Indique si la fonctionnalité d'accès instantané aux instantanés doit être activée. Valeurs valides :

  • true : active la fonctionnalité. Seuls les disques ESSD (SSD d'entreprise, et non SSD standard) prennent en charge cette fonctionnalité.

  • false : désactive la fonctionnalité. Un instantané standard est créé.

Valeur par défaut : false.

Remarque

Ce paramètre est obsolète. Les instantanés standard pour les disques ESSD (SSD d'entreprise, et non SSD standard) ont été mis à niveau pour bénéficier de l'accès instantané activé par défaut. Aucune configuration supplémentaire n'est requise et aucun frais supplémentaire n'est facturé.

false

InstantAccessRetentionDays

integer

Non

Paramètres de la période de rétention de la fonctionnalité d'accès instantané aux instantanés. Une fois la période de rétention expirée, la libération automatique est déclenchée pour l'instantané. Ce paramètre ne prend effet que lorsque InstantAccess est défini sur true. Unité : jours. Valeurs valides : 1 à 65535.\n\nValeur par défaut : la valeur du paramètre RetentionDays.\n\n> Ce paramètre est obsolète. Les instantanés standard pour les disques ESSD (SSD d'entreprise, et non SSD standard) ont été mis à niveau pour bénéficier de l'accès instantané activé par défaut. Aucune configuration supplémentaire n'est requise et aucun frais supplémentaire n'est engagé.

1

Tag

array<object>

Non

La liste des balises.

object

Non

La liste des balises.

Key

string

Non

La clé de balise de l'instantané. N varie de 1 à 20. Si ce paramètre est spécifié, il ne peut pas s'agir d'une chaîne vide. La clé de balise peut comporter jusqu'à 128 caractères. Elle ne peut pas commencer par aliyun ou acs:, et ne peut pas contenir http:// ou https://.

TestKey

Value

string

Non

La valeur de balise de l'instantané. N varie de 1 à 20. Si ce paramètre est spécifié, il peut s'agir d'une chaîne vide. La valeur de balise peut comporter jusqu'à 128 caractères et ne peut pas contenir http:// ou https://.

TestValue

key

string

Non

La clé de balise de l'instantané.\n\n> Pour améliorer la compatibilité, nous vous recommandons d'utiliser le paramètre Tag.N.Key.

null

value

string

Non

La valeur de balise de l'instantané.\n\n> Pour améliorer la compatibilité, nous vous recommandons d'utiliser le paramètre Tag.N.Value.

null

StorageLocationArn

string

Non

Remarque

Ce paramètre n'est pas disponible.

null

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

L'identifiant de la requête.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

SnapshotId

string

L'identifiant de l'instantané.

s-bp17441ohwka0yuh****

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "SnapshotId": "s-bp17441ohwka0yuh****"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidParameter.KMSKeyId.NotFound The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
400 InvalidSnapshotName.Malformed The specified SnapshotName is malformed.
400 IncorrectInstanceStatus The current status of the resource does not support this operation. L'état actuel de l'instance ne prend pas en charge cette opération.
400 DiskCategory.OperationNotSupported The type of the specified disk does not support creating a snapshot. Le type de disque actuel ne prend pas en charge cette opération.
400 Duplicate.TagKey The Tag.N.Key contain duplicate key. Des clés en double existent dans les balises. Assurez-vous que toutes les clés sont uniques.
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. Le paramètre de clé de balise spécifié n'est pas valide.
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. Le paramètre de valeur de balise spécifié n'est pas valide.
400 InvalidRetentionDays.Malformed The specified RetentionDays is not valid. La valeur de durée de rétention spécifiée n'est pas valide. Vérifiez si la valeur du paramètre RetentionDays est correcte.
400 CreateSnapshot.Failed The process of creating snapshot is failed. Échec de la création de l'instantané.
400 InvalidOperation.StorageLocationMismatch The specified storageLocation does not match the storage location of the last snapshot for the disk. Ensure the storageLocation is consistent with previous snapshots.
500 InternalError The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
403 Throttling Request was denied due to user flow control. La requête est limitée.
403 IncorrectDiskStatus.CreatingSnapshot A previous snapshot creation is in process.
403 InstanceLockedForSecurity The disk attached instance is locked due to security.
403 IncorrectDiskStatus.NeverAttached The specified disk has never been attached to any instance.
403 QuotaExceed.Snapshot The snapshot quota exceeds.
403 IncorrectDiskStatus.NeverUsed The specified disk has never been used after creating.
403 CreateSnapshot.Failed The process of creating snapshot is failed.
403 DiskInArrears The specified operation is denied as your disk has expired.
403 DiskId.ValueNotSupported The specified parameter diskid is not supported. Le type de stockage par blocs spécifié ne prend pas en charge cette opération.
403 IncorrectDiskStatus The current disk status does not support this operation.
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
403 InvalidAccountStatus.SnapshotServiceUnavailable Snapshot service has not been opened yet. Le service d'instantanés n'est pas activé. L'opération ne peut pas être effectuée.
403 IncorrectInstanceStatus The current status of the resource does not support this operation.
403 IncorrectVolumeStatus The current volume status does not support this operation. L'état actuel ne prend pas en charge cette opération.
403 IdempotentParameterMismatch The specified clientToken is used. Les paramètres de la requête ne correspondent pas à la requête ayant le même ClientToken.
403 IncorrectDiskStatus.Invalid The specified disk status is invalid. Restart the instance and try again.
403 IncorrectDiskType.NotSupport The specified device type is not supported. Le type de stockage du disque spécifié ne prend pas en charge cette opération.
403 IncorrectDiskStatus.Transferring The specified device is transferring. You can retry after the process is finished.
403 InvalidParameter.KMSKeyId.CMKUnauthorized ECS tags must be added to the CMK. La balise ECS doit être ajoutée à la clé principale client (CMK).
403 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK needs to be enabled.
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 IdempotentProcessing The previous idempotent request(s) is still processing. La requête idempotente précédente est toujours en cours de traitement. Réessayez plus tard.
403 InvalidSnapshotCategory.Malformed The specified Category is not valid. Le type d'instantané spécifié n'est pas valide. Vérifiez si la valeur du paramètre Category est correcte.
403 InvalidAction.Unauthorized The specified action is not valid. L'opération spécifiée n'est pas valide.
403 InvalidRegion.NotSupportSnapshotInstantAccessRegion The snapshot InstantAccess is not supported for this region.
403 InvalidCategoryAndInstantAccess.Malformed The snapshot Category and InstantAccess can't be used together.
403 DISK_HAS_CREATING_SNAPSHOT The operation cannot be performed while a snapshot is being created for the disk.
403 HibernationConfigured.InstanceOperationForbidden The operation is not permitted due to limit of the hibernation configured instance. L'opération n'est pas autorisée car l'instance ne répond pas aux exigences pour l'activation de l'option d'hibernation.
403 QuotaExceed.SnapshotQuota The quota is insufficient. Please contact your channel partner to increase the quota.
403 InvalidInstantAccessRetentionDays.Malformed The specified InstantAccessRetentionDays is not valid. Le format du paramètre InstantAccessRetentionDays spécifié est invalide.
403 CloudBoxNotSupportSnapshotWithInstantAccess The specified disk in CloudBox does not support to create a snapshot with InstantAccess. Les disques dans CloudBox ne prennent pas en charge la création d'instantanés avec la fonctionnalité d'accès instantané.
403 InvalidOperation.UnfinishedEncryptedSnapshotCopy This disk has unfinished encrypted copy snapshots in the target region. Le disque fait l'objet d'une tâche de copie d'instantané chiffré en cours.
403 QuotaExceed.ConcurrentSnapshotQuota The number of snapshots being created for the disk %s has exceeded the concurrent quota (%s). Please wait for the previous snapshots to complete before trying again. Le nombre d'instantanés en cours de création pour ce disque a dépassé le quota de simultanéité. Attendez que les instantanés précédents se terminent, puis réessayez.
403 InvalidClientToken.Malformed The specified clientToken is improperly formatted. It must contain only ASCII characters and must not exceed 64 characters in length. Le paramètre idempotent spécifié est invalide.
403 InvalidParameter.UnauthorizedStorageLocationArn The operation has failed due to lack of permission for the specified "StorageLocationArn". Please use a resource with appropriate permission for the operation. L'opération actuelle a échoué car le StorageLocationArn spécifié ne dispose pas des autorisations suffisantes. Contactez l'administrateur de la ressource pour obtenir les autorisations requises.
403 InvalidStorageLocationArn.Malformed The specified parameter StorageLocationArn is malformed.
403 InvalidStatus.ResourceGroup You cannot perform an operation on a resource group that is being created or deleted. Les opérations ne sont pas autorisées pendant la création ou la suppression du groupe de ressources.
403 OperationDenied.QuotaExceed The quota of tags on resource is beyond permitted range. Le nombre de balises de ressource a atteint la limite supérieure.
403 Forbidden.InDebt The operation is not allowed because your account has an outstanding balance. Please settle the overdue payment and try again.
404 InvalidDiskId.NotFound The specified DiskId does not exist. Le disque spécifié n'existe pas. Vérifiez si l'identifiant du disque est correct.
404 InvalidDescription.Malformed The specified description is malformed.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. L'instance spécifiée n'existe pas. Vérifiez que l'identifiant de l'instance est correct.
404 InvalidVolumeId.NotFound The specified volume does not exist.
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. Le groupe de ressources est introuvable dans les enregistrements.

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

Notes de version

Consultez Notes de version pour la liste complète.