检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询镜像配额 功能介绍 该接口为扩展接口，主要用于查询租户在当前Region的私有镜像的配额数量。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/quota 请求消息 请求参数 无 请求示例 查询镜像配额。 GET http
获取镜像成员列表（OpenStack原生） 功能介绍 该接口用于共享镜像过程中，获取接受该镜像的成员列表。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/images/{image_id}/members 参数说明请参见表1。 表1 参数说明 参数
API概览 镜像服务所提供的接口分为IMS接口与OpenStack原生接口。推荐您使用IMS接口。 通过配合使用镜像服务提供的接口和OpenStack原生接口，您可以完整地使用镜像服务的所有功能。例如制作私有镜像，可以使用OpenStack原生接口，也可以使用IMS接口进行操作。
批量删除镜像成员 功能介绍 该接口为扩展接口，主要用于取消镜像共享。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。 调试 您可以在API Explorer中调试该接口。
批量添加镜像成员 功能介绍 该接口为扩展接口，主要用于镜像共享时用户将多个镜像共享给多个用户。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。 调试
增加或修改标签 功能介绍 该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签，用户可以将镜像进行分类。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/cloudimages/tags 请求消息 请求参数 参数 是否必选 参数类型 描述
获取镜像成员详情（OpenStack原生） 功能介绍 该接口主要用于镜像共享中查询某个镜像成员的详情。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/images/{image_id}/members/{member_id} 参数说明请参见表1。 表1
查询版本列表（OpenStack原生） 功能介绍 查询API的版本信息列表，包括API的版本兼容性、域名信息等。 URI GET / 请求消息 请求参数 无 请求示例 查询API的版本信息列表。 GET https://{Endpoint}/ 响应消息 响应参数 参数 参数类型 描述
使用外部镜像文件制作数据镜像 功能介绍 使用上传至OBS桶中的外部数据盘镜像文件制作数据镜像。作为异步接口，调用成功，只是说明后台收到了制作请求，镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态，具体请参考异步任务查询。 调试 您可以在API Explorer中调试该接口。
服务的访问控制 镜像服务支持通过IAM权限策略进行访问控制。IAM权限是作用于云资源的，IAM权限定义了允许和拒绝的访问操作，以此实现云资源权限访问控制。管理员创建IAM用户后，需要将用户加入到一个用户组中，IAM可以对这个组授予IMS所需的权限，组内用户自动继承用户组的所有权限。
批量添加删除镜像标签 功能介绍 该接口用于为指定镜像批量添加/更新、删除标签。 约束与限制 每个标签由键值对组成，标签的key的长度不超过36个字符，value的长度不超过43个字符。key不能为空或者空白字符串，value不能为空，但可以是空白字符串。 单个镜像最多添加10个标签。
注册镜像 功能介绍 该接口用于将镜像文件注册为云平台未初始化的私有镜像。 使用该接口注册镜像的具体步骤如下： 将镜像文件上传到OBS个人桶中。具体操作请参见“上传文件或文件夹”。 使用创建镜像元数据接口创建镜像元数据。调用成功后，保存该镜像的ID。创建镜像元数据请参考创建镜像元数据（OpenStack原生）。
查询镜像详情（OpenStack原生v1.1--已废弃，不推荐使用） 功能介绍 查询镜像列表详情。 当前接口已废弃，推荐使用查询镜像列表（OpenStack原生v2--已废弃，不推荐使用）。 URI GET /v1.1/images/detail 请求消息 请求参数 可以把nam
查询镜像元数据（OpenStack原生v1--已废弃，不推荐使用） 功能介绍 查询镜像元数据。 当前接口已废弃，推荐使用查询镜像详情（OpenStack原生v2--已废弃，不推荐使用）。 URI HEAD /v1/images/{image_id} 参数说明请参见表1。 表1 参数说明
查询镜像视图（OpenStack原生） 功能介绍 该接口主要用于查询镜像视图，通过视图，用户可以了解到镜像包含哪些属性，同时也可以了解每个属性的数据类型等。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/schemas/image 请求消息 请求参数
按标签查询镜像 功能介绍 该接口用于按标签或其他条件对镜像进行过滤或者计数使用。 约束与限制 为兼容遗留数据，使用tags、not_tags、tags_any、not_tags_any参数时，不对查询条件中标签的key、value进行字符集校验。 调试 您可以在API Explorer中调试该接口。
查询镜像列表视图（OpenStack原生） 功能介绍 该接口主要用于查询镜像列表视图，通过该接口用户可以了解到镜像列表的详细情况和数据结构。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/schemas/images 请求消息 请求参数 无 请求示例
数据保护技术 镜像服务通过多种数据保护手段和特性，保障存储数据的安全可靠。 表1 镜像服务的数据保护手段和特性 数据保护手段 简要说明 传输加密（HTTPS） IMS支持HTTP和HTTPS两种传输协议，为保证数据传输的安全性，推荐您使用更加安全的HTTPS协议。 数据冗余存储 IMS采用Erasure
IMS权限管理 如果您需要对创建的镜像服务（Image Management Service）资源，给企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限
添加镜像成员（OpenStack原生v2--已废弃，不推荐使用） 功能介绍 用户共享镜像给其他用户时，使用该接口向该镜像成员中添加接受镜像用户的项目ID。 当前接口已废弃，推荐使用批量添加镜像成员。 调试 您可以在API Explorer中调试该接口。 URI POST /v2/
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
