检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
更新镜像信息 功能介绍 更新镜像信息接口，主要用于镜像属性的修改。 当前仅支持可用（active）状态的镜像更新相关信息。 调试 您可以在API Explorer中调试该接口。 URI PATCH /v2/cloudimages/{image_id} 参数说明请参见表1。 表1 参数说明
删除镜像标签 功能介绍 该接口用于为镜像删除指定的标签。 约束与限制 为兼容遗留数据，不对key进行字符集校验和长度校验。 此接口为非幂等接口：如果指定删除的key不存在，则返回404状态码。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v2/{project_id
查询镜像配额 功能介绍 该接口为扩展接口，主要用于查询租户在当前Region的私有镜像的配额数量。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/quota 请求消息 请求参数 无 请求示例 查询镜像配额。 GET https
异步任务查询 功能介绍 该接口为扩展接口，主要用于查询异步接口执行情况，比如查询导出镜像任务的执行状态。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/jobs/{job_id} 参数说明请参见表1。 表1 参数说明 参数
制作整机镜像 功能介绍 使用云服务器、云服务器备份或者云备份制作整机镜像。作为异步接口，调用成功，只是说明后台收到了制作整机镜像的请求，镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态，具体请参考异步任务查询。 约束与限制（使用云服务器制作整机镜像） 创建整机镜像时，请确保云服务器已完成相关配置
添加镜像标签 功能介绍 该接口用于为指定镜像添加或更新指定的单个标签。 约束与限制 每个标签由键值对组成，标签的key的长度不超过36个字符，value的长度不超过43个字符。key不能为空或空白字符串，value不能为空，但可以是空白字符串。 单个镜像最多添加10个标签。 此接口为幂等接口
查询镜像标签 功能介绍 该接口用于查询指定镜像上的所有标签。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/{project_id}/images/{image_id}/tags 参数说明请参见表1。 表1 参数说明 参数 是否必选 参数类型 描述
镜像（OpenStack原生） 查询镜像列表（OpenStack原生v2--已废弃，不推荐使用） 查询镜像详情（OpenStack原生v2--已废弃，不推荐使用） 更新镜像信息（OpenStack原生v2--已废弃，不推荐使用） 上传镜像（OpenStack原生v2--已废弃，不推荐使用
镜像标签（OpenStack原生） 增加标签（OpenStack原生v2--已废弃，不推荐使用） 删除标签（OpenStack原生） 父主题： 历史API
使用Packer创建私有镜像 Packer是一款可以创建自定义镜像的开源工具。Packer包含构建器（Builder）、配置器（Provisioner）、后处理器（Post-Processor）三个组件，通过HCL2（HashiCorp Configuration Language
批量添加镜像成员 功能介绍 该接口为扩展接口，主要用于镜像共享时用户将多个镜像共享给多个用户。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。 调试
Region内复制镜像 功能介绍 该接口为扩展接口，主要用于用户将一个已有镜像复制为另一个镜像。复制镜像时，可以更改镜像的加密等属性，以满足不同的场景。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败
增加或修改标签 功能介绍 该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签，用户可以将镜像进行分类。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/cloudimages/tags 请求消息 请求参数 参数 是否必选 参数类型 描述
按标签查询镜像 功能介绍 该接口用于按标签或其他条件对镜像进行过滤或者计数使用。 约束与限制 为兼容遗留数据，使用tags、not_tags、tags_any、not_tags_any参数时，不对查询条件中标签的key、value进行字符集校验。 调试 您可以在API Explorer
批量删除镜像成员 功能介绍 该接口为扩展接口，主要用于取消镜像共享。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。 调试 您可以在API Explorer
异步任务进度查询 功能介绍 该接口为扩展接口，主要用于查询异步任务进度。 URI GET /v1/cloudimages/job/{job_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 job_id 是 异步任务ID 请求消息 请求参数 无 请求示例 异步任务进度查询
镜像共享（OpenStack原生） 添加镜像成员（OpenStack原生v2--已废弃，不推荐使用） 更新镜像成员状态（OpenStack原生v2--已废弃，不推荐使用） 删除指定的镜像成员（OpenStack原生v2--已废弃，不推荐使用） 父主题： 历史API
镜像文件快速导入 功能介绍 使用上传至OBS桶中的超大外部镜像文件制作私有镜像，目前仅支持RAW或ZVHD2格式镜像文件。且要求镜像文件大小不能超过1TB。 由于快速导入功能要求提前转换镜像文件格式为RAW或ZVHD2格式，因此镜像文件小于128GB时推荐您优先使用常规的创建私有镜像的方式
查询镜像列表 功能介绍 根据不同条件查询镜像列表信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/cloudimages{?__isregistered,__imagetype,__whole_image,__system__cmkid,protected
查询租户所有镜像标签 功能介绍 该接口用于查询租户的所有镜像上的标签。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/{project_id}/images/tags 参数说明请参见表1。 表1 参数说明 参数 是否必选 参数类型 描述 project_id
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
