检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
增加或修改标签 功能介绍 该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签，用户可以将镜像进行分类。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/cloudimages/tags 请求消息 请求参数 参数 是否必选 参数类型 描述
批量删除镜像成员 功能介绍 该接口为扩展接口，主要用于取消镜像共享。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。 调试 您可以在API Explorer中调试该接口。
批量添加镜像成员 功能介绍 该接口为扩展接口，主要用于镜像共享时用户将多个镜像共享给多个用户。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。 调试
镜像复制 Region内复制镜像 跨Region复制镜像 父主题： API
镜像任务 异步任务查询 异步任务进度查询 父主题： API
按标签查询镜像 功能介绍 该接口用于按标签或其他条件对镜像进行过滤或者计数使用。 约束与限制 为兼容遗留数据，使用tags、not_tags、tags_any、not_tags_any参数时，不对查询条件中标签的key、value进行字符集校验。 调试 您可以在API Explorer中调试该接口。
功能介绍 本接口用于制作私有镜像，支持： 使用云服务器制作私有镜像（系统盘镜像/数据盘镜像）。 使用上传至OBS桶中的外部镜像文件制作系统盘镜像。 使用数据盘制作系统盘镜像。 作为异步接口，调用成功，只是说明云平台收到了制作请求，镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态，具体请参考异步任务查询。
更新镜像信息 功能介绍 更新镜像信息接口，主要用于镜像属性的修改。 当前仅支持可用（active）状态的镜像更新相关信息。 调试 您可以在API Explorer中调试该接口。 URI PATCH /v2/cloudimages/{image_id} 参数说明请参见表1。 表1 参数说明
批量更新镜像成员状态 功能介绍 该接口为扩展接口，主要用于用户接受或者拒绝多个共享镜像时批量更新镜像成员的状态。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。
完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创建IAM用户接口，返回如图1所示的消息头，其中“X-Subject-To
Region内复制镜像 功能介绍 该接口为扩展接口，主要用于用户将一个已有镜像复制为另一个镜像。复制镜像时，可以更改镜像的加密等属性，以满足不同的场景。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed
查询镜像支持的OS列表 功能介绍 查询当前区域弹性云服务器的OS兼容性列表。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/os_version 表1 查询参数 参数 是否必选 参数类型 描述 tag 否 String OS的标签。
单个镜像最多添加10个标签。 请求体中的多个标签的key不允许重复。 此接口为幂等接口： 创建时，如果创建的标签已经存在，即key相同而value不同，则更新对应标签；如果创建的标签已经存在，key/value均相同，则不进行重复添加，视为添加成功。 删除时，如果指定的标签不存在，则默认视为删除成功。 批量删除时对key、value的限制：
跨Region复制镜像 功能介绍 该接口为扩展接口，用户在一个区域制作的私有镜像，可以通过跨Region复制镜像将镜像复制到其他区域，在其他区域发放相同类型的云服务器，帮助用户实现区域间的业务迁移。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是su
查询镜像列表 功能介绍 根据不同条件查询镜像列表信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/cloudimages{?__isregistered,__imagetype,__whole_image,__system__cmkid,protected
查询镜像元数据（OpenStack原生v1--已废弃，不推荐使用） 查询镜像详情（OpenStack原生v1.1--已废弃，不推荐使用） 父主题： 历史API
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。
W或ZVHD2格式，因此镜像文件小于128GB时推荐您优先使用常规的创建私有镜像的方式。 作为异步接口，调用成功，只是说明后台收到了制作请求，镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态，具体请参考异步任务查询。 约束与限制 快速导入前请确认RAW或ZVHD2格式的镜像文件已完成以下准备：
制作整机镜像 功能介绍 使用云服务器、云服务器备份或者云备份制作整机镜像。作为异步接口，调用成功，只是说明后台收到了制作整机镜像的请求，镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态，具体请参考异步任务查询。 约束与限制（使用云服务器制作整机镜像） 创建整机镜像时，
删除标签（OpenStack原生） 功能介绍 该接口主要用于删除某个镜像的自定义标签，通过该接口，用户可以将私有镜像中一些不用的标签删除。 当前接口已废弃，推荐使用以下接口。 如果需要为镜像删除指定的标签时，请使用删除镜像标签。 如果需要为指定镜像批量添加/更新、删除标签时，请使用批量添加删除镜像标签。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
