检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
公共参数 镜像属性 镜像标签数据格式 镜像共享的约束限制 获取项目ID 相关参数取值列表
创建镜像元数据（OpenStack原生） 功能介绍 创建镜像元数据。 调用创建镜像元数据接口成功后，只是创建了镜像的元数据，镜像对应的实际镜像文件并不存在。 调试 您可以在API Explorer中调试该接口。 URI POST /v2/images 请求消息 请求参数 参数 是否必选
查询镜像列表视图（OpenStack原生） 查询镜像成员视图（OpenStack原生） 查询镜像成员列表视图（OpenStack原生） 父主题： OpenStack原生API
本节通过调用一系列IMS的API使用云服务器来创建私有镜像。 API的调用方法请参见如何调用API。 使用云服务器创建私有镜像时，请确保云服务器处于关机状态。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。 涉及API 当您使
更新镜像信息（OpenStack原生v2--已废弃，不推荐使用） 功能介绍 修改镜像信息。 当前接口已废弃，推荐使用更新镜像信息。 约束与限制 更新镜像目前只能更新用户自定义属性，或者镜像的名称和描述信息，其他属性不允许用户更新。 调试 您可以在API Explorer中调试该接口。 URI PATCH /v2/images/{image_id}
安全 责任共担 身份认证与访问控制 数据保护技术 审计与日志 认证证书
查询版本列表（OpenStack原生） 功能介绍 查询API的版本信息列表，包括API的版本兼容性、域名信息等。 URI GET / 请求消息 请求参数 无 请求示例 查询API的版本信息列表。 GET https://{Endpoint}/ 响应消息 响应参数 参数 参数类型 描述
删除镜像（OpenStack原生） 功能介绍 该接口主要用于删除镜像，用户可以通过该接口将自己的私有镜像删除。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v2/images/{image_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选
没有操作权限。 404 Not Found 找不到资源。 500 Internal Server Error 服务内部错误。 503 Service Unavailable 服务不可用。 父主题： 镜像共享
入门实践 本文介绍了镜像服务常见应用场景的操作实践，每个实践为您提供详细的方案描述和操作指导，帮助您轻松构建基于镜像的相关业务。 创建私有镜像类 实践 描述 基于VirtualBox使用ISO创建Windows镜像 主要介绍基于VirtualBox制作Windows镜像。包括安装
创建过程（Windows系统盘镜像） 步骤说明如下： 为原始ISO文件集成virtio驱动 由于Windows操作系统采用ide磁盘和virtio网卡，因此需要在注册为云平台的镜像前，先在Windows操作系统的ISO文件中集成virtio驱动。详情请参考为原始ISO文件集成virtio驱动。 将ISO文件注册为ISO镜像
务器备份或云备份创建带数据盘的整机镜像。 您可以使用本文档提供API对镜像进行相关操作，如创建、查询、删除、更新等。支持的全部操作请参见API概览。 在调用镜像服务API之前，请确保已经充分了解镜像服务相关概念，详细信息请参见“什么是镜像服务”。 镜像服务提供了REST（Representational
使用光驱来进行读取。 本章介绍通过ISO文件创建私有镜像的API操作过程。 涉及API 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 IAM获取token的API URI格式：POST ht
认证证书 合规证书 华为云服务及平台通过了多项国内外权威机构（ISO/SOC/PCI等）的安全合规认证，用户可自行申请下载合规资质证书。 图1 合规证书下载 资源中心 华为云还提供以下资源来帮助用户满足合规性要求，具体请查看资源中心。 图2 资源中心 销售许可证&软件著作权证书
目前不支持批量创建。 通过弹性云服务器或裸金属服务器创建系统盘镜像 弹性云服务器的状态必须为“关机”或“运行中”。 裸金属服务器的状态必须为“关机”，且必须为快速发放裸金属服务器（系统盘为云硬盘，而非本地盘）才可以用来创建私有镜像。 通过云服务器的数据盘创建数据盘镜像 弹性云服务器的状态必须为“关机”或“运行中”。
权限和授权项 权限及授权项说明 镜像管理 镜像标签 镜像视图 镜像共享 镜像复制 镜像配额
通过云服务器创建Linux系统盘镜像 通过裸金属服务器创建私有镜像 使用外部镜像文件创建系统盘镜像（也称导入镜像） 可以将您本地或者其他云平台的服务器系统盘镜像文件导入至华为云镜像服务中。导入后，可使用该镜像创建新的弹性云服务器或裸金属服务器实例，或对已有实例的系统进行重装或更换。
没有操作权限。 404 Not Found 找不到资源。 500 Internal Server Error 服务内部错误。 503 Service Unavailable 服务不可用。 父主题： 镜像标签（OpenStack原生）
镜像共享 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 添加镜像成员（OpenStack原生） POST /v2/images/{image_id}/members ims:images:get ims:images:share
镜像配额 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询镜像配额 GET /v1/cloudimages/quota ims:quotas:get √ √ 父主题： 权限和授权项
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
