检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com
导出镜像 操作场景 创建私有镜像后，您可以导出镜像到OBS标准存储桶，并下载到本地使用。本文介绍导出镜像的操作步骤及相关注意事项。 背景知识 导出镜像的流程如下，适用于将云上的服务器系统及软件环境复制到线下集群或私有云环境使用。 图1 导出镜像流程 导出镜像所需时间取决于私有镜像大小和当前导出任务的并发数
通过云服务器创建Windows系统盘镜像 操作场景 如果您已经创建了一台Windows云服务器，并根据业务需要进行了自定义配置（如安装软件、部署应用环境等），您可以为更新后的云服务器创建系统盘镜像。使用该镜像创建新的云服务器，会包含您已配置的自定义项，省去您重复配置的时间。 创建系统盘镜像不会影响云服务器上当前业务的运行
使用前必读 欢迎使用镜像服务（Image Management Service，IMS）。镜像是用于创建服务器或磁盘的模板，镜像服务提供镜像生命周期管理能力。可以通过服务器或外部文件创建系统盘镜像或数据盘镜像，也可以使用弹性云服务器、云服务器备份或云备份创建带数据盘的整机镜像。 您可以使用本文档提供
快速导入镜像文件（基于Windows环境） 操作场景 本节指导您基于Windows操作系统环境完成镜像文件快速导入，推荐使用Windows系统本地PC作为转换镜像格式和生成位表文件的环境。 Windows操作系统环境下，必须使用开源qemu-img工具进行镜像格式转换，qemu-img
通过云服务器创建Linux系统盘镜像 操作场景 如果您已经创建了一台Linux云服务器，并根据业务需要进行了自定义配置（如安装软件、部署应用环境等），您可以为更新后的云服务器创建系统盘镜像。使用该镜像创建新的云服务器，会包含您已配置的自定义项，省去您重复配置的时间。 创建系统盘镜像不会影响云服务器上当前业务的运行
使用Packer创建私有镜像 Packer是一款可以创建自定义镜像的开源工具。Packer包含构建器（Builder）、配置器（Provisioner）、后处理器（Post-Processor）三个组件，通过HCL2（HashiCorp Configuration Language
镜像属性 概念 镜像是一个包含了软件及必要配置的模板，至少包含操作系统，还可以包含应用软件（例如数据库软件）和私有软件。镜像是镜像管理服务（IMS）管理的核心对象。 镜像属性 名称 类型 说明 file String 镜像文件下载和上传链接。 owner String 镜像属于哪个租户
安装Cloud-Init工具 操作场景 为了保证使用私有镜像创建的新云服务器可以通过“用户数据注入”功能注入初始化自定义信息（例如为云服务器设置登录密码），请在创建私有镜像前安装Cloud-Init工具。 安装Cloud-Init工具时需要从官网下载并安装，因此，需要提前为云服务器绑定弹性公网
安装Cloud-Init工具 操作场景 为了保证使用私有镜像创建的新云服务器可以通过“用户数据注入”功能注入初始化自定义信息（例如为云服务器设置登录密码），请在创建私有镜像前安装Cloud-Init工具。 安装Cloud-Init工具时需要从官网下载并安装，因此，需要提前为云服务器绑定弹性公网
注册镜像（Windows） 操作场景 镜像文件上传到OBS桶以后，请参考本节指导注册镜像。 操作步骤 登录IMS控制台。 登录管理控制台。 选择“计算 > 镜像服务”。 进入镜像服务页面。 创建系统盘镜像。 单击右上角的“创建私有镜像”，进入创建私有镜像页面。 根据界面要求填写如下信息
创建镜像元数据（OpenStack原生） 功能介绍 创建镜像元数据。 调用创建镜像元数据接口成功后，只是创建了镜像的元数据，镜像对应的实际镜像文件并不存在。 调试 您可以在API Explorer中调试该接口。 URI POST /v2/images 请求消息 请求参数 参数 是否必选
注册镜像（Linux） 操作场景 镜像文件上传到OBS桶以后，请参考本节指导注册镜像。 操作步骤 登录IMS控制台。 登录管理控制台。 选择“计算 > 镜像服务”。 进入镜像服务页面。 创建系统盘镜像。 单击右上角的“创建私有镜像”，进入创建私有镜像页面。 根据界面要求填写如下信息
快速导入镜像文件（基于Linux环境） 操作场景 本节指导您基于Linux操作系统环境完成镜像文件快速导入，推荐使用云平台的EulerOS云服务器作为转换镜像格式和生成位表文件的环境。 Linux操作系统环境下，建议使用qemu-img-hw工具进行镜像格式转换。 前提条件 已完成镜像文件优化
查询镜像详情（OpenStack原生v2--已废弃，不推荐使用） 功能介绍 查询单个镜像详情，用户可以通过该接口查询单个私有或者公共镜像的详情。 当前接口已废弃，推荐使用查询镜像列表。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/images/{image_id
更新镜像信息 功能介绍 更新镜像信息接口，主要用于镜像属性的修改。 当前仅支持可用（active）状态的镜像更新相关信息。 调试 您可以在API Explorer中调试该接口。 URI PATCH /v2/cloudimages/{image_id} 参数说明请参见表1。 表1 参数说明
更新镜像信息（OpenStack原生v2--已废弃，不推荐使用） 功能介绍 修改镜像信息。 当前接口已废弃，推荐使用更新镜像信息。 约束与限制 更新镜像目前只能更新用户自定义属性，或者镜像的名称和描述信息，其他属性不允许用户更新。 调试 您可以在API Explorer中调试该接口
查询镜像列表（OpenStack原生v2--已废弃，不推荐使用） 功能介绍 获取镜像列表。 使用本接口查询镜像列表时，需要使用分页查询才能返回全部的镜像列表。 当前接口已废弃，推荐使用查询镜像列表。 分页说明 分页是指返回一组镜像的一个子集，在返回的时候会存在下个子集的链接和首个子集的链接
查询镜像列表 功能介绍 根据不同条件查询镜像列表信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/cloudimages{?__isregistered,__imagetype,__whole_image,__system__cmkid,protected
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
