检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
增加或修改标签 功能介绍 该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签，用户可以将镜像进行分类。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/cloudimages/tags 请求消息 请求参数 参数 是否必选 参数类型 描述
查询镜像成员视图（OpenStack原生） 功能介绍 该接口主要用于查询镜像成员视图，通过视图，用户可以了解到镜像成员包含哪些属性，同时也可以了解每个属性的数据类型。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/schemas/member 请求消息
过服务器或外部文件创建系统盘镜像或数据盘镜像，也可以使用弹性云服务器、云服务器备份或云备份创建带数据盘的整机镜像。 您可以使用本文档提供API对镜像进行相关操作，如创建、查询、删除、更新等。支持的全部操作请参见API概览。 在调用镜像服务API之前，请确保已经充分了解镜像服务相关
查询镜像列表视图（OpenStack原生） 功能介绍 该接口主要用于查询镜像列表视图，通过该接口用户可以了解到镜像列表的详细情况和数据结构。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/schemas/images 请求消息 请求参数 无 请求示例
查询镜像成员列表视图（OpenStack原生） 功能介绍 该接口主要用于查询镜像成员列表视图，通过视图，用户可以了解到镜像成员包含哪些属性，同时也可以了解每个属性的数据类型。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/schemas/members
取。 本章介绍通过ISO文件创建私有镜像的API操作过程。 涉及API 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 IAM获取token的API URI格式：POST https://{I
系统盘镜像和数据盘镜像，然后跨区域复制到目标区域，实现整机镜像的跨区域复制功能。 对于使用云服务器备份创建的整机镜像，仅支持对当前区域生成的备份执行跨区域复制操作，不支持对复制操作产生的备份再次执行跨区域复制操作。 调试 您可以在API Explorer中调试该接口。 URI POST
系统盘镜像和数据盘镜像的总和。 使用方式 数据存储位置：与服务器/磁盘数据分开存储，存储在对象存储（OBS）中。如果将创建备份的云硬盘删除，对应的备份不会被同时删除。 操作对象：保存云服务器/磁盘指定时刻的数据，可以设置自动备份和过期自动删除。 用途：备份可以恢复数据至原服务器/
镜像属性 概念 镜像是一个包含了软件及必要配置的模板，至少包含操作系统，还可以包含应用软件（例如数据库软件）和私有软件。镜像是镜像管理服务（IMS）管理的核心对象。 镜像属性 名称 类型 说明 file String 镜像文件下载和上传链接。 owner String 镜像属于哪个租户。
批量删除镜像成员 功能介绍 该接口为扩展接口，主要用于取消镜像共享。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。 调试 您可以在API Explorer中调试该接口。
建镜像 imsVolumeCreateImageJob：数据盘创建系统盘镜像 imsVolumesToSysDataImagesJob：数据盘创建数据盘镜像 imsImportDataImageJob：外部镜像文件创建数据盘镜像 imsCreateWholeImageByInstanceJob：云服务器创建整机镜像
批量添加镜像成员 功能介绍 该接口为扩展接口，主要用于镜像共享时用户将多个镜像共享给多个用户。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。 调试
批量更新镜像成员状态 功能介绍 该接口为扩展接口，主要用于用户接受或者拒绝多个共享镜像时批量更新镜像成员的状态。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。
跨Region复制镜像 功能介绍 该接口为扩展接口，用户在一个区域制作的私有镜像，可以通过跨Region复制镜像将镜像复制到其他区域，在其他区域发放相同类型的云服务器，帮助用户实现区域间的业务迁移。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是su
W或ZVHD2格式，因此镜像文件小于128GB时推荐您优先使用常规的创建私有镜像的方式。 作为异步接口，调用成功，只是说明后台收到了制作请求，镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态，具体请参考异步任务查询。 约束与限制 快速导入前请确认RAW或ZVHD2格式的镜像文件已完成以下准备：
不推荐使用） 功能介绍 修改镜像信息。 当前接口已废弃，推荐使用更新镜像信息。 约束与限制 更新镜像目前只能更新用户自定义属性，或者镜像的名称和描述信息，其他属性不允许用户更新。 调试 您可以在API Explorer中调试该接口。 URI PATCH /v2/images/{image_id}
Region内复制镜像 功能介绍 该接口为扩展接口，主要用于用户将一个已有镜像复制为另一个镜像。复制镜像时，可以更改镜像的加密等属性，以满足不同的场景。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed
功能介绍 该接口用于为指定镜像添加或更新指定的单个标签。 约束与限制 每个标签由键值对组成，标签的key的长度不超过36个字符，value的长度不超过43个字符。key不能为空或空白字符串，value不能为空，但可以是空白字符串。 单个镜像最多添加10个标签。 此接口为幂等接口：如果创
invalid.", "code": "IMG.0024" } } 错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 表1 错误码 状态码 错误码 错误信息 描述 处理措施 400 IMG.0001 The request
用户可以采用加密方式创建私有镜像，确保镜像数据安全性。 用户如需使用镜像加密特性需要提前申请KMS Administrator的权限。具体操作，请参见创建用户并授权使用IMS。 镜像服务如何通过KMS对数据进行加密，请参见“华为云服务如何使用KMS加密数据”。 约束与限制 用户已启用数据加密服务。 加密镜像不能共享给其他用户。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
