调用CopySnapshot将一份普通快照从一个地域复制到另一个地域。

接口说明

调用该接口时,您需要注意:

  • 复制后的新快照不能回滚源快照对应的云盘。
  • 不支持复制已加密的快照。
  • 不支持复制本地快照。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CopySnapshot

系统规定参数。取值:CopySnapshot

ResourceGroupId String rg-bp67acfmxazb4p****

该参数暂未开放使用。

Tag.N.Key String TestKey

新快照的标签键。一旦传入该值,则不允许为空字符串。最多支持128个字符,不能以aliyun和acs:开头,不能包含http://或者https://。

Tag.N.Value String TestValue

新快照的标签值。一旦传入该值,允许为空字符串。最多支持128个字符,不能以aliyun和acs:开头,不能包含http://或者https://。

RegionId String cn-chengdu

源快照所在的地域。您可以调用DescribeRegions查看最新的阿里云地域列表。

DestinationRegionId String us-east-1

新快照的目标地域ID。

SnapshotId String s-bp67acfmxazb4p****

源快照ID。

DestinationSnapshotName String CopySnapshotDemo

新快照的名称。长度为2~128个英文或中文字符,必须以大小字母或中文开头,不能以http://和https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者短划线(-)。

默认值:空。

DestinationSnapshotDescription String CopySnapshotDemo

新快照的描述信息。长度为2~256个英文或中文字符,不能以http://或https://开头。

默认值:空。

RetentionDays Integer 60

新快照的保留时长,单位为天,到期后快照会被自动释放。取值范围:1~65536。

默认值:空,表示快照不会被自动释放。

Encrypted Boolean false

是否加密云盘。取值范围:

  • true:是。
  • false:否。

默认值:false。

KMSKeyId String 0e478b7a-4262-4802-b8cb-00d3fb40****

目标地域的KMS用户主密钥。

Arn.N.RoleType String null
说明 该参数暂未开放使用。
Arn.N.Rolearn String null
说明 该参数暂未开放使用。
Arn.N.AssumeRoleFor Long 0
说明 该参数暂未开放使用。

返回数据

名称 类型 示例值 描述
SnapshotId String s-bp17441ohwka0yui****

新快照的ID。

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

请求ID。

示例

请求示例

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
&公共请求参数

正常返回示例

XML格式

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

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

JSON格式

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

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

错误码

HttpCode 错误码 错误信息 描述
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. 指定的标签值参数有误。
403 InvalidSnapshotId.NotFound The specified snapshot is not exists. 指定的源快照不存在。
403 InvalidUser.NotInWhiteList The user is not in the white list of copying snapshot. 您暂未授权执行该操作。
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. 账号余额不足,请您先充值再进行该操作。
403 InvalidAccountStatus.SnapshotServiceUnavailable Snapshot service has not been opened yet. 快照服务未开通,操作无法执行。
403 InvalidSnapshotId.NotReady The specified snapshot has not completed yet. 指定的快照未完成。
403 InvalidSnapshotName.Malformed The specified SnapshotName is wrongly formed. 快照名称格式不合法。
403 InvalidDescription.Malformed The specified description is wrongly formed. 指定的资源描述格式不合法。长度为 2-256 个字符,不能以 http:// 和 https:// 开头。
403 InvalidRetentionDays.Malformed The specified RetentionDays is not valid. 指定的保留天数无效。请检查 RetentionDays 参数值是否正确。
403 InvalidRegion.NotSupport The specified region does not support byok. 该地域不支持BYOK。
403 InvalidParameter.KMSKeyId.NotFound The specified KMSKeyId does not exist. 指定的参数 KMSKeyId 不存在。
403 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK needs to be enabled. 加密云盘设置了 KMSKeyId 后,CMK必须处于启用状态。您可以调用密钥管理服务的 DescribeKey 接口查询指定CMK的相关信息。
403 InvalidParameter.KMSKeyId.KMSUnauthorized ECS service have no right to access your KMS. ECS 服务无权访问您的 KMS。

访问错误中心查看更多错误码。