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
|
ecs:CreateSnapshot |
create |
*Disk.
*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 |
testSnapshotName |
| Description |
string |
Non |
La description de l'instantané. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par |
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 :
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 :
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 |
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.