Tous les produits
Search
Centre de documentation

Elastic Compute Service:CreateSnapshot

Dernière mise à jour :Aug 18, 2026

Crée un instantané pour un disque.

Description de l'opération

La fonctionnalité d'instantané local a été remplacée par la fonctionnalité d'accès instantané aux instantanés. La description des métriques est la suivante :

  • Si vous avez utilisé des instantanés locaux avant le 14 décembre 2020, vous pouvez utiliser le paramètre Category avec la valeur Normal.

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

Avant de commencer :

  • Activez la fonctionnalité d'instantané. Pour plus d'informations, consultez Activer les instantanés.

  • Le disque doit être dans l'état In Use ou Unattached. Notez les points suivants pour les différents états :

    • Si le disque est dans l'état In Use, l'instance doit être dans l'état Running ou Stopped.

    • Si le disque est dans l'état Unattached, le disque doit avoir été précédemment 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 un tableau RAID, utilisez un groupe cohérent au niveau des instantanés et activez les instantanés cohérents au niveau des applications pour sauvegarder les données. Les groupes cohérents au niveau des instantanés garantissent la cohérence de l'ordre d'écriture des données sur plusieurs disques dans un système métier et assurent la cohérence en cas de panne. Pour plus d'informations, consultez Créer un groupe cohérent au niveau des instantanés et Créer un instantané cohérent au niveau des applications.

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

  • Évitez de créer des instantanés pendant les heures de pointe de l'activité. Lorsqu'un instantané est en cours de création, les performances d'E/S du disque diminuent jusqu'à 10 %, et de brèves latences de performance en lecture et en écriture peuvent survenir.

  • Si l'instantané n'a pas été créé, il ne peut pas être utilisé pour créer une image personnalisée (CreateImage).

  • Les données incrémentielles générées par les opérations de disque pendant la création de l'instantané ne sont pas incluses dans la sauvegarde vers 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é échouera.

  • Un disque pour lequel un instantané est en cours de création ne prend pas en charge l'extension. Attendez que l'instantané soit créé avant d'exécuter l'opération d'extension.

  • Vous pouvez créer des instantanés pour des disques dans l'état Expired (Expired). Si le disque atteint son heure de libération prévue pendant la création de l'instantané, le disque est libéré et l'instantané dans l'état Creating (Creating) est également supprimé.

  • Une fois l'instantané créé, le système calcule les frais en fonction de la taille de l'instantané dans chaque région séparément. Pour plus d'informations, consultez Facturation des instantanés.

  • Dans les scénarios suivants, vous ne pouvez pas créer d'instantané pour le disque spécifié :

    • 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.

    • La création d'instantanés comporte des limites de simultanéité. Le dépassement de ces limites entraîne des échecs de 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.

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 ne peut pas commencer par http:// ou https://. Le nom peut contenir des caractères Unicode de la catégorie lettre (y compris les lettres en anglais et en chinois), des chiffres ASCII (0-9), des deux-points (:), des traits de soulignement (_), des points (.) et des traits d'union (-).

Remarque

Le nom ne peut pas commencer par auto pour éviter les conflits avec les noms des instantanés automatiques.

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://.

Valeur par défaut : null.

testDescription

RetentionDays

integer

Non

Paramètres de la période de rétention de l'instantané. Unité : jours. Valeurs valides : 1 à 65536. L'instantané est soumis à une libération automatique lorsque la période de rétention expire.

Valeur par défaut : null, ce qui indique que l'instantané n'est pas soumis à une libération automatique.

30

Category

string

Non

Le type d'instantané. Valeurs valides :

  • Standard : instantané standard.

  • Flash : instantané local.

Remarque

Ce paramètre sera obsolète. Les instantanés standard pour les SSD d'entreprise ont été mis à niveau vers un accès instantané par défaut. Aucune configuration ni frais supplémentaires ne sont requis. L'instantané est actif immédiatement après sa création.

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 assurez-vous que le jeton est unique parmi les 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 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 SSD d'entreprise 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 SSD d'entreprise ont été mis à niveau vers un accès instantané par défaut. Aucune configuration ni frais supplémentaires ne sont requis. L'instantané est actif immédiatement après sa création.

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, l'instantané est soumis à une libération automatique. Ce paramètre prend effet uniquement lorsque InstantAccess=true. Unité : jours. Valeurs valides : 1 à 65535.

La valeur par défaut est identique à la valeur du paramètre RetentionDays.

Remarque

Ce paramètre est obsolète. Les instantanés standard pour les SSD d'entreprise ont été mis à niveau vers un accès instantané par défaut. Aucune configuration ni frais supplémentaires ne sont requis. L'instantané est actif immédiatement après sa création.

1

Tag

array<object>

Non

Les balises.

object

Non

Les balises.

key

string

Non

La clé de balise de l'instantané.

Remarque

Pour des raisons de compatibilité, utilisez le paramètre Tag.N.Key.

null

Key

string

Non

La clé de balise de l'instantané. Valeurs valides de 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 peut pas commencer par aliyun ou acs:. La clé de balise ne peut pas contenir http:// ou https://.

TestKey

Value

string

Non

La valeur de balise de l'instantané. Valeurs valides de 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 peut pas contenir http:// ou https://.

TestValue

value

string

Non

La valeur de balise de l'instantané.

Remarque

Pour des raisons de compatibilité, utilisez le paramètre Tag.N.Value.

null

StorageLocationArn

string

Non

Remarque

Ce paramètre n'est pas disponible publiquement.

null

Éléments de réponse

Élément

Type

Description

Exemple

object

SnapshotId

string

L'identifiant de l'instantané.

s-bp17441ohwka0yuh****

RequestId

string

L'identifiant de la requête.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidParameter.KMSKeyId.NotFound The specified KMSKeyId does not exist.
400 InvalidSnapshotName.Malformed The specified SnapshotName is malformed.
400 IncorrectInstanceStatus The current status of the resource does not support this operation.
400 DiskCategory.OperationNotSupported The type of the specified disk does not support creating a snapshot.
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 InvalidRetentionDays.Malformed The specified RetentionDays is not valid.
400 CreateSnapshot.Failed The process of creating snapshot is failed.
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.
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.
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.
403 IncorrectInstanceStatus The current status of the resource does not support this operation.
403 IncorrectVolumeStatus The current volume status does not support this operation.
403 IdempotentParameterMismatch The specified clientToken is used.
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.
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.
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.
403 InvalidSnapshotCategory.Malformed The specified Category is not valid.
403 InvalidAction.Unauthorized The specified action is not valid.
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.
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.
403 CloudBoxNotSupportSnapshotWithInstantAccess The specified disk in CloudBox does not support to create a snapshot with InstantAccess.
403 InvalidOperation.UnfinishedEncryptedSnapshotCopy This disk has unfinished encrypted copy snapshots in the target region.
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.
403 InvalidClientToken.Malformed The specified clientToken is improperly formatted. It must contain only ASCII characters and must not exceed 64 characters in length.
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.
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.
403 OperationDenied.QuotaExceed The quota of tags on resource is beyond permitted range.
404 InvalidDiskId.NotFound The specified DiskId does not exist.
404 InvalidDescription.Malformed The specified description is malformed.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist.
404 InvalidVolumeId.NotFound The specified volume does not exist.
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.