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