检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
按条件查询租户镜像标签列表 按标签查询镜像 批量添加删除镜像标签 添加镜像标签 删除镜像标签 查询镜像标签 查询租户所有镜像标签 父主题： API
镜像共享 批量删除镜像成员 批量添加镜像成员 批量更新镜像成员状态 父主题： API
镜像配额 查询镜像配额 父主题： API
将ISO文件注册为镜像（Windows） 操作场景 通过注册镜像操作，将外部镜像ISO文件注册为云平台的私有镜像，即ISO镜像。注册镜像前，需先将为原始ISO文件集成virtio驱动中保存的ISO文件上传到OBS桶中。 使用ISO文件注册的ISO镜像不支持复制、导出。 前提条件 待注册文件需为iso格式。
的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth
查询镜像元数据（OpenStack原生v1--已废弃，不推荐使用） 查询镜像详情（OpenStack原生v1.1--已废弃，不推荐使用） 父主题： 历史API
镜像大小必须小于1TB；大于128GB的镜像仅支持快速导出。 部分区域支持导出的镜像大小上限可能大于128G，请以控制台实际操作提示为准。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/cloudimages/{image_id}/file 参数说明请参见表1。 表1
所示的消息头，其中“X-Subject-Token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。 建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。 图1 管理员创建IAM用户响应消息头 响应消息体（可选） 该部分可选。响
上传镜像（OpenStack原生v2--已废弃，不推荐使用） 功能介绍 该接口用于上传用户本地的镜像文件到云平台。使用该接口上传镜像时，镜像文件大小需要小于2GB，超过2GB的镜像文件参考注册镜像进行操作。 了解更多关于使用外部文件创建镜像的相关内容，请参见“通过外部镜像文件创建
查询镜像标签 功能介绍 该接口用于查询指定镜像上的所有标签。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/{project_id}/images/{image_id}/tags 参数说明请参见表1。 表1 参数说明 参数 是否必选 参数类型 描述
更新镜像成员状态（OpenStack原生v2--已废弃，不推荐使用） 删除指定的镜像成员（OpenStack原生v2--已废弃，不推荐使用） 父主题： 历史API
同而value不同，则更新对应标签；如果创建的标签已经存在，key/value均相同，则不重复添加此标签，视为添加成功。 调试 您可以在API Explorer中调试该接口。 URI POST /v2/{project_id}/images/{image_id}/tags 参数说明请参见表1。
为兼容遗留数据，使用tags、not_tags、tags_any、not_tags_any参数时，不对查询条件中标签的key、value进行字符集校验。 调试 您可以在API Explorer中调试该接口。 URI POST /v2/{project_id}/images/resource_instances/action
增加或修改标签 功能介绍 该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签，用户可以将镜像进行分类。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/cloudimages/tags 请求消息 请求参数 参数 是否必选 参数类型 描述
务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v1/cloudimages/members 请求消息 请求参数 参数 是否必选
镜像标签（OpenStack原生） 增加标签（OpenStack原生v2--已废弃，不推荐使用） 删除标签（OpenStack原生） 父主题： 历史API
查询镜像配额 功能介绍 该接口为扩展接口，主要用于查询租户在当前Region的私有镜像的配额数量。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/quota 请求消息 请求参数 无 请求示例 查询镜像配额。 GET http
为兼容遗留数据，不对key进行字符集校验和长度校验。 此接口为非幂等接口：如果指定删除的key不存在，则返回404状态码。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v2/{project_id}/images/{image_id}/tags/{key}
对于使用云服务器备份创建的整机镜像，仅支持对当前区域生成的备份执行跨区域复制操作，不支持对复制操作产生的备份再次执行跨区域复制操作。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/cloudimages/wholeimages/action 请求消息 使用云服务器创建整机镜像的请求参数
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
