发起镜像复制到其他地域的任务。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ImageId |
string |
是 |
镜像 id |
imgc-07jyldnd9i***** |
| VersionId |
string |
否 |
镜像版本 ID，不填默认使用最新的镜像版本。 |
iv-07jyldnd9i**** |
| RetryType |
string |
否 |
该参数暂不对外透出。 |
RETRY |
| DestinationRegionList |
array |
否 |
需要复制的目标地域列表。 |
|
|
string |
否 |
阿里云地域 ID。 |
cn-hangzhou |
|
| ProductType |
string |
否 |
产品类型。 枚举值：
|
CloudApp |
| SourceRegion |
string |
否 |
指定复制镜像的源地域，不设置则随机选择。 |
cn-shanghai |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回数据结构体。 |
||
| Data |
string |
返回的镜像复制任务 ID。 |
tid-06xnr5lyp77e7**** |
| Success |
boolean |
是否成功。 |
true |
| Code |
string |
出错时的错误码。 |
200 |
| Message |
string |
出错时的错误消息。 |
success |
| RequestId |
string |
请求的 ID。 |
419F31B9-1FDF-5644-ABA3-D00026FA**** |
示例
正常返回示例
JSON格式
{
"Data": "tid-06xnr5lyp77e7****",
"Success": true,
"Code": "200",
"Message": "success",
"RequestId": "419F31B9-1FDF-5644-ABA3-D00026FA****"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | Instance.NotFound | The instance is not found. | 实例找不到。 |
| 400 | DesktopInstance.NotFound | The cloud computer instance does not exist. | 云电脑实例不存在。 |
| 400 | Instance.ImageUnsupported | A non-centralized image does not support this type of operation. | 使用非中心化镜像不支持该操作。 |
| 400 | Instance.PhysicalNodeNotExist | The instance physical node does not exist. | 物理节点不存在。 |
| 400 | ImageCreateByInstance.TaskExist | The image task of instance creation already exists. | 实例创建镜像任务已存在。 |
| 400 | ExceedBuilderQuota | The maximum number of builders is reached. | Builder数量达到了上限。 |
| 400 | InvalidBaseImage.NotConfigured | Configuration required for Vhd/Container images. | Vhd/Container镜像类型需要配置BaseImageId。 |
| 400 | CreateDesktopImageRecord.Failed | Create cloud computer image failed. | 创建云电脑镜像失败。 |
| 400 | Image.NotExist | The image does not exist. | 镜像不存在。 |
| 400 | ImageRegionDistribute.NotAllow | This image cannot be distributed. | 镜像不允许分发操作。 |
| 400 | ImageUpdateFailed.NotAllow | The image is not allowed to be modified. | 镜像不允许修改。 |
| 400 | ImageUpdateSharedImageFailed.NotAllow | The shared image is not allowed to be modified. | 共享镜像不允许修改。 |
| 400 | ParentImageRegionDistribute.NotExist | The target distribution region of the parent image does not exist. | 依赖父镜像分发地址不存在。 |
| 400 | InternalError | Internal error. | 内部错误 |
| 400 | ImageDistribute.TargetDistributeRegionListEmpty | The target distribution region list is empty. | 分发地域配置为空。 |
| 400 | ImageDistribute.ImageNotSupport | The image does not support region distribution. | 镜像不支持分发，如：加密镜像。 |
| 400 | ImageDistribute.RepeatedDistribution | This image has been distributed to this region. | 镜像已经分发过该地域。 |
| 400 | ImageDistribute.Undistributed | The image has not been distributed to any region. | 镜像分发无拷贝源地址，检查镜像分发地域是否已经清空。 |
| 400 | ImageRegion.NotConfigured | The image does not have any region configuration. | 镜像无任何地域配置信息。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。