CopySnapshot_云服务器 ECS_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

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

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

流控信息

请求速率为1000/60(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
ecs:CopySnapshot
Create
Snapshot
acs:ecs:{#regionId}:{#accountId}:snapshot/{#snapshotId}

请求参数

字段名称字段详情
ResourceGroupIdstring

该参数暂未开放使用。

示例值:rg-bp67acfmxazb4p****参考取值来源:
    DescribeSecurityGroups
Tagarray<object>

新快照的标签信息。

子级条数 <= 20
RegionIdstring

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

示例值:cn-chengdu参考取值来源:
    DescribeRegions
DestinationRegionIdstring

新快照的目标地域 ID。

示例值:us-east-1
SnapshotIdstring

源快照 ID。

示例值:s-bp67acfmxazb4p****参考取值来源:
    CreateSnapshot
    DescribeSnapshots
DestinationSnapshotNamestring

新快照的名称。长度为 2~128 个字符,必须以大小写字母或中文开头,不能以 http://和 https:// 开头。支持 Unicode 中 letter 分类下的字符(其中包括英文、中文和数字等)。可以包含半角冒号(:)、下划线(_)、半角句号(.)或者短划线(-)。展开详情

示例值:CopySnapshotDemo
DestinationSnapshotDescriptionstring

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

示例值:CopySnapshotDemo
RetentionDaysinteger<int32>

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

示例值:60
Encryptedboolean

是否加密云盘。取值范围:展开详情

示例值:false
KMSKeyIdstring

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

示例值:0e478b7a-4262-4802-b8cb-00d3fb40****参考取值来源:
    DescribeDiskDefaultKMSKeyId
字符长度 <= 64
Arnarray<object>
说明 该参数正在邀测中,暂不支持使用。
子级条数 <= 10
DestinationStorageLocationArnstring
说明 该参数暂未开放使用。
示例值:null
ClientTokenstring

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。更多详情,请参见如何保证幂等性

示例值:123e4567-e89b-12d3-a456-426655440000

返回参数

字段名称字段详情
SnapshotIdstring

新快照的 ID。

示例值:s-bp17441ohwka0yui****
RequestIdstring

请求 ID。

示例值:C8B26B44-0189-443E-9816-D951F596****

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
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.诊断
400
InvalidParameter.Arns
The specified Arns is not valid.诊断
403
InvalidSnapshotId.EncryptedNotSupport
The specified snapshot with encrypted does not support copy.诊断
403
InvalidSnapshotId.NotFound
The specified snapshot is not exists.诊断
403
InvalidSnapshotCategory.NotSupportCopy
The specified snapshot's category does not support copy.诊断
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
InvalidOperation.Unauthorized
The specified operation is unauthorized.诊断
403
InvalidOperation.UnfinishedCrossRegionCopy
This disk has unfinished cross-region copy snapshots in the target region.诊断
403
InvalidOperation.NotSupportCopyInSameRegion
Copying snapshot in the same region is not supported.诊断
403
InvalidSnapshotName.Malformed
The specified SnapshotName is wrongly formed.诊断
403
InvalidDescription.Malformed
The specified description is wrongly formed.诊断
403
InvalidRetentionDays.Malformed
The specified RetentionDays is not valid.诊断
403
InvalidRegionId.NotSupportedEncryptedSnapshotCopy
The specified region not support copy encrypted snapshot.诊断
403
InvalidRegion.NotSupport
The specified region does not support byok.诊断
403
InvalidRegionId.NotSupportEncryptAlgorithm
The current region does not support creating encrypted disks with EncryptAlgorithm.诊断
403
InvalidRegionId.NotExists
Region not exists.诊断
403
InvalidEncryptAlgorithm
The specified parameter EncryptAlgorithm is not valid.诊断
403
InvalidEncrypted.NotMatchKmsKeyId
The specified parameter Encrypted must be true when KmsKeyId is not empty.诊断
403
InvalidEncrypted.NotMatchEncryptAlgorithm
The specified parameter Encrypted must be true when EncryptAlgorithm is not empty.诊断
403
InvalidEncrypted.NotSupportDecrypt
Encrypted snapshot not support copy to decrypt snapshot.诊断
403
InvalidSnapshotCategory.NotSupportCrossRegionCopy
The specified snapshot is not support cross region copy.诊断
403
InvalidSnapshotCategory.NotSupportEncryptedCopy
The specified snapshot is not support encrypted copy.诊断
403
InvalidParameter.KmsNotEnabled
The specified operation need enable KMS.诊断
403
InvalidParameter.DataEncryptedKeyCreateFailed
Create kms data encrypted key fail. If you need further assistance, you can contact the KMS Technical Support.诊断
403
InvalidParameter.KMSKeyId.NotFound
The specified KMSKeyId does not exist.诊断
403
InvalidParameter.KMSKeyId.CMKUnauthorized
This operation for kmsKeyId is forbidden by KMS. If you need further assistance, you can contact the KMS Technical Support.诊断
403
InvalidParameter.KMSKeyId.CMKNotEnabled
The CMK needs to be enabled.诊断
403
InvalidParameter.KMSKeyId.KMSUnauthorized
ECS service have no right to access your KMS.诊断
403
InvalidKMSKeyId.NotSymmetric
The specified parameter KmsKeyId must be symmetric.诊断
403
QuotaExceed.SnapshotQuota
The quota is insufficient, please contact your channel partner to increase the quota.诊断
403
InvalidOperation.UnfinishedEncryptedSnapshotCopy
This disk has unfinished encrypted copy snapshots in the target region.诊断
403
InvalidParameterDestinationStorageLocationArn.Unauthorized
The operation has failed due to lack of permission for the specified "DestinationStorageLocationArn". Please use a resource with appropriate permission for the operation.诊断
403
InvalidParameterDestinationStorageLocationArn.RegionNotMatch
The region information in the specified parameter "DestinationStorageLocationArn" is inconsistent with "DestinationRegionId". Please use the correct information for the operation.诊断
403
InvalidSnapshot.StorageLocationNotSupported
The storage location of the current snapshot does not support this operation.诊断
403
InvalidSnapshot.EncryptedNotSupported
The current operation does not support the use of encrypted snapshots.诊断
403
InvalidParameterDestinationStorageLocationArn.Malformed
The specified DestinationStorageLocationArn is wrongly formed.诊断
403
OperationDenied.NonCompliantDestinationRegion
The copy operation to the destination region is not in compliance with regulations.诊断
403
OperationDenied.SnapshotCategoryNotSupportCopy
The specified category of snapshot not support copy.诊断

变更历史

变更时间变更内容概要操作
2025-01-21
变更错误码403
2024-12-10
变更错误码403
2024-11-27
变更错误码400
2024-06-27
变更请求参数KMSKeyId
2023-12-18
变更错误码403
2023-08-02
变更错误码403
新增请求参数DestinationStorageLocationArn
删除返回参数
  • 1
  • 2
  • 10 条/页
2024年08月20日