- 最新动态
- 功能总览
- 产品介绍
- 快速入门
-
用户指南
- 通过IAM授予使用IMS的权限
- 创建私有镜像
- 管理私有镜像
- Windows操作系统相关操作
- Linux操作系统相关操作
- 管理公共镜像
- 标签管理
- 配额管理
- 使用CTS审计IMS操作事件
- 最佳实践
- API参考
- SDK参考
-
常见问题
- 镜像咨询类
- 操作系统停止支持类
- 镜像创建类
- 镜像共享类
- 操作系统类
- 镜像导入类
- 镜像导出类
-
镜像优化类
- 一定要在云服务器中安装Guest OS driver吗?
- Windows操作系统为什么要安装并更新virtio?
- 通过镜像文件注册私有镜像过程中,系统会对镜像做哪些修改?
- 创建私有镜像前云服务器、裸金属服务器或镜像文件需要完成哪些初始化配置?
- Windows外部镜像文件在导出前未完成初始化配置,怎么办?
- Linux外部镜像文件在导出前未完成初始化配置,怎么办?
- 如何优化镜像?
- 如何使用通过I代云服务器创建的私有镜像创建II代云服务器
- 如何设置镜像的网卡多队列属性?
- 如何配置IPv6地址
- 如何优化系统盘镜像使其支持实例快速发放?
- 为什么Windows云服务器安装Guest OS driver会失败?
- 怎样安装原生的XEN和KVM驱动
- 镜像复制类
- 镜像删除类
- 镜像加密类
- 市场镜像类
- 账号与权限类
- Cloud-Init操作类
- 云服务器创建类
- 驱动安装类
- 镜像标签类
- 计费类
- 视频帮助
- 产品术语
-
更多文档
-
用户指南 (阿布扎比区域)
- 产品介绍
- 通过IAM授予使用IMS的权限
- 创建私有镜像
- 管理私有镜像
- Windows操作系统相关操作
- Linux操作系统相关操作
- 标签管理
- 配额管理
- 使用CTS审计IMS操作事件
- 常见问题
- API参考 (阿布扎比区域)
-
用户指南(巴黎区域)
- 产品介绍
- 通过IAM授予使用IMS的权限
- 创建私有镜像
- 管理私有镜像
- Windows操作系统相关操作
- Linux操作系统相关操作
- 标签管理
- 配额管理
- 使用CTS审计IMS操作事件
- 常见问题
- API参考 (巴黎区域)
-
用户指南(吉隆坡区域)
- 产品介绍
- 通过IAM授予使用IMS的权限
- 创建私有镜像
- 管理私有镜像
- Windows操作系统相关操作
- Linux操作系统相关操作
- 标签管理
- 配额管理
- 使用CTS审计IMS操作事件
- 常见问题
- API参考(吉隆坡区域)
-
用户指南(安卡拉区域)
- 产品介绍
- 通过IAM授予使用IMS的权限
- 创建私有镜像
- 管理私有镜像
- Windows操作系统相关操作
- Linux操作系统相关操作
- 标签管理
- 配额管理
- 使用CTS审计IMS操作事件
- 常见问题
- API参考(安卡拉区域)
-
用户指南 (阿布扎比区域)
- 通用参考
链接复制成功!
制作整机镜像
功能介绍
使用云服务器或者云备份制作整机镜像。作为异步接口,调用成功,只是说明后台收到了制作整机镜像的请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询。
约束与限制(使用云服务器制作整机镜像)
- 创建整机镜像时,请确保云服务器已完成相关配置,否则可能导致整机镜像创建云服务器失败。
- 使用Windows操作系统云服务器制作整机镜像时,不允许云服务器存在跨区卷,否则制作的整机镜像创建云服务器时可能会导致数据丢失。
- 使用Linux操作系统云服务器制作整机镜像时,不允许云服务器存在由多个物理卷组成的卷组、或由多个物理卷组成的逻辑卷,否则制作的整机镜像创建云服务器时可能会造成数据丢失。
- 整机镜像不支持如下操作:不允许导出、区域内复制。
- 使用Windows操作系统云服务器制作整机镜像时,需修改云服务器SAN策略为OnlineAll类型。否则可能导致使用镜像创建云服务器时,云服务器磁盘处于脱机状态。
Windows操作系统SAN策略分为三种类型:OnlineAll、OfflineShared、OfflineInternal
表1 Windows操作系统SAN策略类型 类型
说明
OnlineAll
表示所有新发现磁盘都置于在线模式。
OfflineShared
表示所有共享总线上(比如FC、ISCSI)的新发现磁盘都置于离线模式,非共享总线上的磁盘都置于在线模式。
OfflineInternal
表示所有新发现磁盘都置于离线模式。
- 运行cmd.exe,执行以下命令,使用DiskPart工具来查询云服务器当前的SAN策略。
diskpart
- 执行以下命令查看云服务器当前的SAN策略。
san
- 如果SAN策略为OnlineAll,请执行exit命令退出DiskPart。
- 否,请执行步骤3。
- 执行以下命令修改云服务器SAN策略为OnlineAll。
san policy=onlineall
- 运行cmd.exe,执行以下命令,使用DiskPart工具来查询云服务器当前的SAN策略。
约束与限制(使用云备份制作整机镜像)
- 创建整机镜像前,请确保创建该云备份所属的弹性云服务器已完成相关配置,否则可能导致整机镜像创建云服务器失败。
- 每个云备份只能创建一个整机镜像。
- 在云服务器关机状态下,制作整机镜像的过程中,用户不能启动云服务器。
- 通过云备份创建的整机镜像可以共享给其他租户。但是,如果这个云备份是由其他租户共享的,那么创建的整机镜像不支持共享。
- 整机镜像不支持如下操作:不允许导出、区域内复制。
URI
POST /v1/cloudimages/wholeimages/action
请求消息
- 使用云服务器创建整机镜像的请求参数
参数
是否必选
参数类型
描述
name
是
String
镜像名称。name参数说明请参考镜像属性。
description
否
String
镜像描述信息。description参数说明请参考镜像属性。
tags
否
Array of strings
镜像标签列表。默认为空。
tags和image_tags只能使用一个。
image_tags
否
Array of objects
新规范的镜像标签列表。默认为空。
tags和image_tags只能使用一个。
instance_id
是
String
云服务器ID。使用云服务器制作整机镜像时使用此参数。
如何获取云服务器ID:
- 登录控制台。
- 选择“计算 > 弹性云服务器”。
- 在云服务器列表栏,单击源云服务器名称,在详情页查看ID。
enterprise_project_id
否
String
表示当前镜像所属的企业项目。
max_ram
否
Integer
表示镜像支持的最大内存,单位为MB,默认不设置。
min_ram
否
Integer
表示镜像支持的最小内存,单位为MB,默认为0。
vault_id
是
String
表示云服务器待加入的或已加入的存储库的ID。
可以从云备份服务控制台获取,或者参考《云备份接口参考》的“查询存储库列表”章节查询。
- 使用云备份创建整机镜像的请求参数
参数
是否必选
参数类型
描述
name
是
String
镜像名称。name参数说明请参考镜像属性。
description
否
String
镜像描述信息。description参数说明请参考镜像属性。
tags
否
Array of strings
镜像标签列表。默认为空。
tags和image_tags只能使用一个。
image_tags
否
Array of objects
新规范的镜像标签列表。默认为空。
tags和image_tags只能使用一个。
backup_id
是
String
云备份ID。
如何获取云备份ID:- 登录管理控制台。
- 选择“存储 > 云备份”。
- 在云服务器备份页面,单击“备份副本”页签,在备份列表中查看备份ID。
max_ram
否
Integer
表示镜像支持的最大内存,单位为MB,默认不设置。
min_ram
否
Integer
表示镜像支持的最小内存,单位为MB,默认为0,表示不受限制。
whole_image_type
是
String
表示创建整机镜像的方式,必须填写“CBR”。
请求示例
- 使用云服务器制作整机镜像,其中,镜像标签数据格式为tags,虚拟机ID为“877a2cda-ba63-4e1e-b95f-e67e48b6129a”。
1 2 3 4 5 6 7 8 9 10 11 12
POST https://{Endpoint}/v1/cloudimages/wholeimages/action { "name": "instance_whole_image", "description": "云服务器制作镜像", "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "vault_id": "de9fcf45-11b2-432c-8562-5c5428574600", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] }
- 使用云服务器制作整机镜像,其中,镜像标签数据格式为image_tags,虚拟机ID为“877a2cda-ba63-4e1e-b95f-e67e48b6129a”。
1 2 3 4 5 6 7 8
POST https://{Endpoint}/v1/cloudimages/wholeimages/action { "name": "instance_whole_image", "description": "云服务器制作镜像", "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "vault_id": "de9fcf45-11b2-432c-8562-5c5428574600", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] }
- 使用制作整机镜像,其中,镜像标签数据格式为image_tags,备份ID为"9b27efab-4a17-4c06-bfa2-3e0cf021d3c3"。
1 2 3 4 5 6 7
POST https://{Endpoint}/v1/cloudimages/wholeimages/action { "name": "backup_whole_image", "description": "制作镜像", "backup_id": "9b27efab-4a17-4c06-bfa2-3e0cf021d3c3", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] }
- 使用云备份制作整机镜像,其中,镜像标签数据格式为tags,备份ID为"9b27efab-4a17-4c06-bfa2-3e0cf021d3c3"。
1 2 3 4 5 6 7 8 9 10 11 12
POST https://{Endpoint}/v1/cloudimages/wholeimages/action { "name": "backup_whole_image", "description": "云备份制作镜像", "backup_id": "9b27efab-4a17-4c06-bfa2-3e0cf021d3c3", "whole_image_type": "CBR", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] }
- 使用云备份制作整机镜像,其中,镜像标签数据格式为image_tags,备份ID为"9b27efab-4a17-4c06-bfa2-3e0cf021d3c3"。
1 2 3 4 5 6 7 8
POST https://{Endpoint}/v1/cloudimages/wholeimages/action { "name": "backup_whole_image", "description": "云备份制作镜像", "backup_id": "9b27efab-4a17-4c06-bfa2-3e0cf021d3c3", "whole_image_type": "CBR", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] }
响应消息
- 响应参数
参数
参数类型
描述
job_id
String
异步任务ID。
详情请参见异步任务查询。
- 响应样例
STATUS CODE 200
1 2 3
{ "job_id": "4010a32b5f909853015f90aaa24b0015" }
返回值
- 正常
- 异常
返回值
说明
400 Bad Request
请求错误,具体返回错误码请参见错误码。
401 Unauthorized
鉴权失败。
403 Forbidden
没有操作权限。
404 Not Found
找不到资源。
500 Internal Server Error
服务内部错误。
503 Service Unavailable
服务不可用。