接口请求域名: cvm.tencentcloudapi.com 。
本接口(CreateImage)用于将实例的系统盘制作为新镜像,创建后的镜像可以用于创建实例。
默认接口请求频率限制:10次/秒。
注意:本接口支持金融区地域。由于金融区和非金融区是隔离不互通的,因此当公共参数 Region 为金融区地域(例如 ap-shanghai-fsi)时,需要同时指定带金融区地域的域名,最好和 Region 的地域保持一致,例如:cvm.ap-shanghai-fsi.tencentcloudapi.com。
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:CreateImage。 |
Version | 是 | String | 公共参数,本接口取值:2017-03-12。 |
Region | 是 | String | 公共参数,详见产品支持的 地域列表。 |
ImageName | 是 | String | 镜像名称 |
InstanceId | 否 | String | 需要制作镜像的实例ID。 |
ImageDescription | 否 | String | 镜像描述 |
ForcePoweroff | 否 | String | 是否执行强制关机以制作镜像。 取值范围: 默认取值:FALSE。 开机状态制作镜像,可能导致部分数据未备份,影响数据安全。 |
Sysprep | 否 | String | 创建Windows镜像时是否启用Sysprep,关于Sysprep的详情请参考链接 |
DataDiskIds.N | 否 | Array of String | 基于实例创建整机镜像时,指定包含在镜像里的数据盘Id |
SnapshotIds.N | 否 | Array of String | 基于快照创建镜像,指定快照ID,必须包含一个系统盘快照。不可与InstanceId同时传入。 |
DryRun | 否 | Boolean | 检测本次请求的是否成功,但不会对操作的资源产生任何影响 |
参数名称 | 类型 | 描述 |
---|---|---|
ImageId | String | 镜像ID 注意:此字段可能返回 null,表示取不到有效值。 |
RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
使用实例ins-6pb6lrmy 创建一个镜像。当实例处于运行中时,执行软关机,软关机失败后,结束任务(默认语义)。
GET https://cvm.tencentcloudapi.com/?Action=CreateImage
&InstanceId=ins-6pb6lrmy
&ImageName="name"
&<公共请求参数>
{
"Response": {
"ImageId": "img-0yc6rie8",
"RequestId": "71e69b56-32be-4412-ab45-49eded6a87be"
}
}
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
ImageQuotaLimitExceeded | 镜像配额超过了限制。 |
InvalidAccount.InsufficientBalance | 账户余额不足。 |
InvalidImageName.Duplicate | 镜像名称与原有镜像重复。 |
InvalidInstance.NotSupported | 不被支持的实例。 |
InvalidInstanceId.NotFound | 没有找到相应实例。 |
InvalidParameter.DataDiskIdContainsRootDisk | DataDiskIds不应该传入RootDisk的Id。 |
InvalidParameter.DataDiskNotBelongSpecifiedInstance | 指定的数据盘不属于指定的实例。 |
InvalidParameter.DuplicateSystemSnapshots | 只能包含一个系统盘快照。 |
InvalidParameter.InstanceImageNotSupport | 当前接口不支持实例镜像。 |
InvalidParameter.InvalidDependence | 参数依赖不正确。 |
InvalidParameter.LocalDataDiskNotSupport | 本地数据盘不支持创建实例镜像。 |
InvalidParameter.SnapshotNotFound | 指定的快照不存在。 |
InvalidParameter.SpecifyOneParameter | 多选一必选参数缺失。 |
InvalidParameter.SwapDiskNotSupport | 不支持Swap盘。 |
InvalidParameter.SystemSnapshotNotFound | 参数不包含系统盘快照。 |
InvalidParameter.ValueTooLarge | 参数长度超过限制。 |
InvalidParameterConflict | 指定的两个参数冲突,不能同时存在。 EIP只能绑定在实例上或指定网卡的指定内网 IP 上。 |
InvalidParameterValue.TooLarge | 参数值超过最大限制。 |
MutexOperation.TaskRunning | 同样的任务正在运行。 |
OperationDenied.InstanceOperationInProgress | 实例正在执行其他操作,请稍后再试。 |
ResourceInUse | 资源被占用。 |
ResourceInsufficient.CloudDiskUnavailable | 云盘参数不符合规范 |
ResourceUnavailable.SnapshotCreating | 快照正在创建过程中。 |
UnsupportedOperation.InstanceStateRebooting | 请求不支持正在重启的实例 |
UnsupportedOperation.InstanceStateRescueMode | 请求不支持救援模式的实例 |
UnsupportedOperation.InstanceStateStopping | 请求不支持正在关机的实例 |
UnsupportedOperation.InstanceStateTerminating | 请求不支持正在销毁的实例 |
UnsupportedOperation.NotSupportInstanceImage | 操作不支持当前实例 |
UnsupportedOperation.SpecialInstanceType | 请求不支持特殊机型的实例 |
UnsupportedOperation.StoppedModeStopCharging | 不支持关机不收费特性 |
排查思路 无法通过远程桌面连接裸金属服务器时,我们推荐您按照以下思路排查问题...
注册了 域名 不备案可以吗?可以的。 注册域名 并不是一定要备案的,只有搭 建网...
3月24日,腾讯发布2020年Q4及全年财报,其中金融科技及企业服务第四季收入385亿...
??提到慕尼黑,大家第一个想到总是啤酒节,其实慕尼黑的文化同样闻名世界。慕尼...
API风格说明 当前ECS服务对外开放两类风格的API: ECS服务自定义规范的API(以下...
云虚拟主机 可以干什么?云 虚拟主机 可以是搭 建网站 的重要产品,可用来存放网...
案例背景 高校健康打卡项目发起于北京大学软件与微电子学院,是该学院张齐勋老师...
公司介绍 我们公司是全球法律服务整合平台,已有的4万多名律师遍布全国359个城市...
客户简介 趣医网(quyiyuan.com)创立于2014年,为京颐集团重要成员企业之一,是...
客户简介 全民直播是一家涵盖游戏、娱乐、户外等多领域泛娱乐的直播平台。2015年...