调用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 |
是否加密云盘。取值范围：
默认值：false。 |
| KMSKeyId | String | 否 | 0e478b7a-4262-4802-b8cb-00d3fb40**** |
目标地域的KMS用户主密钥。 |
| Arn.N.RoleType | String | 否 | null | 说明 该参数暂未开放使用。 |
| Arn.N.Rolearn | String | 否 | null | 说明 该参数暂未开放使用。 |
| Arn.N.AssumeRoleFor | Long | 否 | 0 | 说明 该参数暂未开放使用。 |
| DestinationStorageLocationArn | String | 否 | null | 说明 该参数暂未开放使用。 |
返回数据
|
名称 |
类型 |
示例值 |
描述 |
| 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
C8B26B44-0189-443E-9816-D951F596****
s-bp17441ohwka0yui****
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. | 指定的标签值参数有误。 |
| 400 | InvalidRegionId.MalFormed | The specified RegionId is not valid. | 指定的 RegionId 不合法。 |
| 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。 |
| 403 | QuotaExceed.SnapshotQuota | The quota is insufficient, please contact your channel partner to increase the quota. | 您当前配额不足，请您可以联系渠道伙伴为您增加额度。 |
| 403 | InvalidSnapshot.EncryptedNotSupported | The current operation does not support the use of encrypted snapshots. | 加密快照不支持此操作 |
访问错误中心查看更多错误码。
腾讯云1折，限时活动，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/152803.html