检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
异步任务查询 功能介绍 该接口为扩展接口，主要用于查询异步接口执行情况，比如查询导出镜像任务的执行状态。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/jobs/{job_id} 参数说明请参见表1。 表1 参数说明 参数
批量更新镜像成员状态 功能介绍 该接口为扩展接口，主要用于用户接受或者拒绝多个共享镜像时批量更新镜像成员的状态。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。
在云服务器关机状态下，制作整机镜像的过程中，用户不能启动云服务器。 整机镜像创建过程中，请勿对源云服务器做任何操作，避免创建失败。 图1中，当云服务器备份还未创建成功，只是创建好磁盘快照时，整机镜像状态为“可用区x可用”（可用区x表示镜像源云服务器所在的可用区），此时，这个整机镜像只能在该可用区中发放云服务
删除镜像标签 功能介绍 该接口用于为镜像删除指定的标签。 约束与限制 为兼容遗留数据，不对key进行字符集校验和长度校验。 此接口为非幂等接口：如果指定删除的key不存在，则返回404状态码。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v2/{
删除标签（OpenStack原生） 功能介绍 该接口主要用于删除某个镜像的自定义标签，通过该接口，用户可以将私有镜像中一些不用的标签删除。 当前接口已废弃，推荐使用以下接口。 如果需要为镜像删除指定的标签时，请使用删除镜像标签。 如果需要为指定镜像批量添加/更新、删除标签时，请使用批量添加删除镜像标签。
导入流程（基于Linux操作系统环境） 详细操作请参见快速导入镜像文件（基于Linux环境）。 基于Windows操作系统环境 推荐使用Windows系统本地PC作为操作的环境，流程如图2所示。 开源镜像转换工具qemu-img不支持将镜像文件转换为zvhd2格式，因此需要转换为raw格式，再使用CreateMF
Region内复制镜像 功能介绍 该接口为扩展接口，主要用于用户将一个已有镜像复制为另一个镜像。复制镜像时，可以更改镜像的加密等属性，以满足不同的场景。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed
查询镜像配额 功能介绍 该接口为扩展接口，主要用于查询租户在当前Region的私有镜像的配额数量。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/quota 请求消息 请求参数 无 请求示例 查询镜像配额。 GET http
功能介绍 该接口用于为指定镜像添加或更新指定的单个标签。 约束与限制 每个标签由键值对组成，标签的key的长度不超过36个字符，value的长度不超过43个字符。key不能为空或空白字符串，value不能为空，但可以是空白字符串。 单个镜像最多添加10个标签。 此接口为幂等接口：如果创
单个镜像最多添加10个标签。 请求体中的多个标签的key不允许重复。 此接口为幂等接口： 创建时，如果创建的标签已经存在，即key相同而value不同，则更新对应标签；如果创建的标签已经存在，key/value均相同，则不进行重复添加，视为添加成功。 删除时，如果指定的标签不存在，则默认视为删除成功。 批量删除时对key、value的限制：
使用上传至OBS桶中的外部数据盘镜像文件制作数据镜像。作为异步接口，调用成功，只是说明后台收到了制作请求，镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态，具体请参考异步任务查询。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/cloudimages/dataimages/action
删除镜像（OpenStack原生） 功能介绍 该接口主要用于删除镜像，用户可以通过该接口将自己的私有镜像删除。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v2/images/{image_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选
导出镜像 功能介绍 该接口为扩展接口，用于用户将自己的私有镜像导出到指定的OBS桶中。 导出镜像前请确保用户已拥有对象存储服务的Tenant Administrator权限。 约束与限制 仅支持导出到存储类别为标准存储的桶，并且桶和镜像在同一区域。 如下类型的私有镜像不允许导出：
更新镜像信息 功能介绍 更新镜像信息接口，主要用于镜像属性的修改。 当前仅支持可用（active）状态的镜像更新相关信息。 调试 您可以在API Explorer中调试该接口。 URI PATCH /v2/cloudimages/{image_id} 参数说明请参见表1。 表1 参数说明
可以导出至本地，您可以根据业务需要灵活选择。 常用操作 修改镜像属性 共享镜像 导出镜像 加密镜像 区域内复制镜像 跨区域复制镜像 导出镜像列表信息 删除镜像 标记镜像 06 API 通过IMS开放的丰富API和调用示例，您可以完成镜像制作、复制、共享等操作。 API文档 API
按标签查询镜像 功能介绍 该接口用于按标签或其他条件对镜像进行过滤或者计数使用。 约束与限制 为兼容遗留数据，使用tags、not_tags、tags_any、not_tags_any参数时，不对查询条件中标签的key、value进行字符集校验。 调试 您可以在API Explorer中调试该接口。
异步任务进度查询 功能介绍 该接口为扩展接口，主要用于查询异步任务进度。 URI GET /v1/cloudimages/job/{job_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 job_id 是 异步任务ID 请求消息 请求参数 无 请求示例 异步任务进度查询。
增加或修改标签 功能介绍 该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签，用户可以将镜像进行分类。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/cloudimages/tags 请求消息 请求参数 参数 是否必选 参数类型 描述
查询租户所有镜像标签 功能介绍 该接口用于查询租户的所有镜像上的标签。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/{project_id}/images/tags 参数说明请参见表1。 表1 参数说明 参数 是否必选 参数类型 描述 project_id
regions. 目的租户与源租户不在同一个Region。 请确认目的租户和源租户是否在同一个Region。 400 IMG.0178 The target tenant is the same as the source tenant. 目的租户和源租户相同。 目的租户不能与源租户相同，请检查。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
