检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
通过外部镜像文件创建Linux系统盘镜像 除了可以通过云服务器创建私有镜像，系统也支持外部镜像导入功能，可将您本地或者其他云平台的服务器系统盘镜像文件导入至镜像服务私有镜像中。导入后，您可以使用该镜像创建新的云服务器，或对已有云服务器的系统进行重装。 本文以Linux操作系统为例
共享镜像和复制镜像的区别？ 共享镜像： 范围为同一区域。镜像支持共享到同一区域内的其他租户。如果您需要共享到不同区域，请先复制镜像到目标区域后再共享。详情参见共享镜像概述。 复制镜像： 区域内复制镜像：用户可以通过区域内复制镜像功能实现加密镜像与非加密镜像的转换，或者使镜像具备一些高级特性（如快速发放）。
功能概述 私有镜像生命周期 当您成功创建私有镜像后，镜像的状态为“正常”，您可以使用该镜像创建服务器实例或云硬盘，也可以将镜像共享给其他账号，或者复制镜像到其他区域。私有镜像的生命周期如图1所示。 图1 私有镜像生命周期 特性列表 表1 创建私有镜像类 特性 说明 相关操作 使用云服务器或裸金属服务器创建系统盘镜像
镜像服务与其他服务的关系 镜像服务与周边服务的依赖关系如图1所示。 图1 镜像服务与其他服务的关系 表1 镜像服务与其他服务的关系 服务名称 镜像服务与其他服务的关系 主要交互功能 弹性云服务器（Elastic Cloud Server，ECS） 通过镜像创建云服务器，或者将云服务器转换为镜像
制作镜像 功能介绍 本接口用于制作私有镜像，支持： 使用云服务器制作私有镜像（系统盘镜像/数据盘镜像）。 使用上传至OBS桶中的外部镜像文件制作系统盘镜像。 使用数据盘制作系统盘镜像。 作为异步接口，调用成功，只是说明云平台收到了制作请求，镜像是否制作成功需要通过异步任务查询接口
API概览 镜像服务所提供的接口分为IMS接口与OpenStack原生接口。推荐您使用IMS接口。 通过配合使用镜像服务提供的接口和OpenStack原生接口，您可以完整地使用镜像服务的所有功能。例如制作私有镜像，可以使用OpenStack原生接口，也可以使用IMS接口进行操作。
创建镜像元数据（OpenStack原生） 功能介绍 创建镜像元数据。 调用创建镜像元数据接口成功后，只是创建了镜像的元数据，镜像对应的实际镜像文件并不存在。 调试 您可以在API Explorer中调试该接口。 URI POST /v2/images 请求消息 请求参数 参数 是否必选
导出镜像 功能介绍 该接口为扩展接口，用于用户将自己的私有镜像导出到指定的OBS桶中。 导出镜像前请确保用户已拥有对象存储服务的Tenant Administrator权限。 约束与限制 仅支持导出到存储类别为标准存储的桶，并且桶和镜像在同一区域。 如下类型的私有镜像不允许导出：
增加或修改标签 功能介绍 该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签，用户可以将镜像进行分类。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/cloudimages/tags 请求消息 请求参数 参数 是否必选 参数类型 描述
使用外部镜像文件制作数据镜像 功能介绍 使用上传至OBS桶中的外部数据盘镜像文件制作数据镜像。作为异步接口，调用成功，只是说明后台收到了制作请求，镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态，具体请参考异步任务查询。 调试 您可以在API Explorer中调试该接口。
为原始ISO文件集成virtio驱动 操作场景 由于Windows操作系统采用ide磁盘和virtio网卡，因此需要在注册为云平台的镜像前，先在Windows操作系统的ISO文件中集成virtio驱动。由于ISO通常是将光盘文件做成一个文件，而部分光盘软件设定只能从光驱进行安装，
异步任务进度查询 功能介绍 该接口为扩展接口，主要用于查询异步任务进度。 URI GET /v1/cloudimages/job/{job_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 job_id 是 异步任务ID 请求消息 请求参数 无 请求示例 异步任务进度查询。
按条件查询租户镜像标签列表 功能介绍 根据不同条件查询镜像标签列表信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/tags{?__isregistered,__imagetype,__whole_image,__system__cmkid
返回结果 状态码 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对
添加镜像成员（OpenStack原生v2--已废弃，不推荐使用） 功能介绍 用户共享镜像给其他用户时，使用该接口向该镜像成员中添加接受镜像用户的项目ID。 当前接口已废弃，推荐使用批量添加镜像成员。 调试 您可以在API Explorer中调试该接口。 URI POST /v2/
查询镜像列表（OpenStack原生v2--已废弃，不推荐使用） 功能介绍 获取镜像列表。 使用本接口查询镜像列表时，需要使用分页查询才能返回全部的镜像列表。 当前接口已废弃，推荐使用查询镜像列表。 分页说明 分页是指返回一组镜像的一个子集，在返回的时候会存在下个子集的链接和首个
获取镜像成员列表（OpenStack原生） 功能介绍 该接口用于共享镜像过程中，获取接受该镜像的成员列表。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/images/{image_id}/members 参数说明请参见表1。 表1 参数说明 参数
上传镜像（OpenStack原生v2--已废弃，不推荐使用） 功能介绍 该接口用于上传用户本地的镜像文件到云平台。使用该接口上传镜像时，镜像文件大小需要小于2GB，超过2GB的镜像文件参考注册镜像进行操作。 了解更多关于使用外部文件创建镜像的相关内容，请参见“通过外部镜像文件创建
查询镜像列表 功能介绍 根据不同条件查询镜像列表信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/cloudimages{?__isregistered,__imagetype,__whole_image,__system__cmkid,protected
注册镜像 功能介绍 该接口用于将镜像文件注册为云平台未初始化的私有镜像。 使用该接口注册镜像的具体步骤如下： 将镜像文件上传到OBS个人桶中。具体操作请参见“上传文件或文件夹”。 使用创建镜像元数据接口创建镜像元数据。调用成功后，保存该镜像的ID。创建镜像元数据请参考创建镜像元数据（OpenStack原生）。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
