CopySnapshot - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Tenez compte des points suivants :

Les nouveaux snapshots (copies de snapshots) ne peuvent pas servir à restaurer les disques pour lesquels les snapshots source (snapshots copiés) ont été créés.
Il est impossible de copier les snapshots locaux.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de la signature. Pour plus de 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

Parameter	Type	Required	Example	Description
Action	String	Yes	CopySnapshot	L'opération à effectuer. Définissez la valeur sur CopySnapshot.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	Ce paramètre n'est pas disponible publiquement.
Tag.N.Key	String	No	TestKey	Clé du tag N à ajouter au nouveau snapshot. La clé du tag ne peut pas être une chaîne vide. Elle peut comporter jusqu'à 128 caractères et ne doit pas contenir http:// ou https://. Elle ne peut pas commencer par acs: ou aliyun.
Tag.N.Value	String	No	TestValue	Valeur du tag N à ajouter au nouveau snapshot. La valeur du tag peut être une chaîne vide. Elle peut comporter jusqu'à 128 caractères et ne doit pas contenir http:// ou https://. Elle ne peut pas commencer par acs: ou aliyun.
RegionId	String	Yes	cn-chengdu	ID de région du snapshot source. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
DestinationRegionId	String	Yes	us-east-1	ID de la région de destination vers laquelle copier le snapshot source.
SnapshotId	String	Yes	s-bp67acfmxazb4p****	ID du snapshot source.
DestinationSnapshotName	String	Yes	CopySnapshotDemo	Nom du nouveau snapshot. Il doit comporter entre 2 et 128 caractères, commencer par une lettre et ne 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 (-). Ce paramètre est vide par défaut.
DestinationSnapshotDescription	String	Yes	CopySnapshotDemo	Description du nouveau snapshot. Elle doit comporter entre 2 et 256 caractères et ne pas commencer par http:// ou https://. Ce paramètre est vide par défaut.
RetentionDays	Integer	No	60	Période de rétention du nouveau snapshot, en jours. Le nouveau snapshot est automatiquement libéré à la fin de sa période de rétention. Valeurs valides : 1 à 65536. Ce paramètre est vide par défaut, ce qui indique que le snapshot n'est pas automatiquement libéré.
Encrypted	Boolean	No	false	Indique s'il faut chiffrer le nouveau snapshot. Valeurs valides : true false Valeur par défaut : false.
KMSKeyId	String	No	0e478b7a-4262-4802-b8cb-00d3fb40****	ID de la clé maître client (CMK) dans Key Management Service (KMS) dans la région de destination.
Arn.N.RoleType	String	No	null	Remarque Ce paramètre n'est pas disponible publiquement.
Arn.N.Rolearn	String	No	null	Remarque Ce paramètre n'est pas disponible publiquement.
Arn.N.AssumeRoleFor	Long	No	0	Remarque Ce paramètre n'est pas disponible publiquement.
DestinationStorageLocationArn	String	No	null	Remarque Ce paramètre n'est pas disponible publiquement.

Paramètres de réponse

Parameter

Type

Example

Description

SnapshotId

String

s-bp17441ohwka0yui****

ID du nouveau snapshot.

RequestId

String

C8B26B44-0189-443E-9816-D951F596****

ID de la requête.

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=CopySnapshot
&ResourceGroupId=hide
&Tag=[{"Key":"TestKey","Value":"TestValue"}]
&RegionId=cn-chengdu
&DestinationRegionId=us-east-1
&SnapshotId=s-bp67acfmxazb4p****
&DestinationSnapshotName=CopySnapshotDemo
&DestinationSnapshotDescription=CopySnapshotDemo
&RetentionDays=60
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<CopySnapshotResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F596****</RequestId>
    <SnapshotId>s-bp17441ohwka0yui****</SnapshotId>
</CopySnapshotResponse>

JSON format

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

{
  "RequestId" : "C8B26B44-0189-443E-9816-D951F596****",
  "SnapshotId" : "s-bp17441ohwka0yui****"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	La clé du tag existe déjà. Les clés de tag doivent être uniques.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valeur Tag.N.Key non valide.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valeur Tag.N.Value non valide.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.	Valeur RegionId non valide.
403	InvalidSnapshotId.NotFound	The specified snapshot is not exists.	Le snapshot source spécifié n'existe pas.
403	InvalidUser.NotInWhiteList	The user is not in the white list of copying snapshot.	Vous ne disposez pas des autorisations nécessaires pour effectuer l'opération.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Le solde du compte est insuffisant. Ajoutez des fonds au compte et réessayez.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	L'opération n'est pas prise en charge tant que le service de snapshot n'est pas activé.
403	InvalidSnapshotId.NotReady	The specified snapshot has not completed yet.	Le snapshot spécifié est en cours de création.
403	InvalidSnapshotName.Malformed	The specified SnapshotName is wrongly formed.	Le nom du snapshot spécifié n'est pas valide.
403	InvalidDescription.Malformed	The specified description is wrongly formed.	Format DestinationSnapshotDescription non valide. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par http:// ou https://.
403	InvalidRetentionDays.Malformed	The specified RetentionDays is not valid.	Valeur RetentionDays non valide. Vérifiez si la valeur RetentionDays est correcte.
403	InvalidRegion.NotSupport	The specified region does not support byok.	La fonctionnalité Bring Your Own Key (BYOK) n'est pas prise en charge dans la région spécifiée.
403	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist.	L'ID de clé KMS n'existe pas.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	La CMK n'est pas activée lorsque l'ID de la CMK est spécifié pour un disque. Vous pouvez appeler l'opération DescribeKey de KMS pour interroger les informations sur la CMK spécifiée.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.	Elastic Compute Service (ECS) n'est pas autorisé à accéder à vos ressources KMS.
403	QuotaExceed.SnapshotQuota	The quota is insufficient, please contact your channel partner to increase the quota.	Le quota est insuffisant. Vous pouvez contacter votre partenaire de canal pour demander une augmentation du quota.
403	InvalidSnapshot.EncryptedNotSupported	The current operation does not support the use of encrypted snapshots.	Les snapshots chiffrés ne prennent pas en charge l'opération.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.