检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
注册镜像 功能介绍 该接口用于将镜像文件注册为云平台未初始化的私有镜像。 使用该接口注册镜像的具体步骤如下： 将镜像文件上传到OBS个人桶中。具体操作请参见“上传文件或文件夹”。 使用创建镜像元数据接口创建镜像元数据。调用成功后，保存该镜像的ID。创建镜像元数据请参考创建镜像元数据
返回结果 状态码 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头
数据保护技术 镜像服务通过多种数据保护手段和特性，保障存储数据的安全可靠。 表1 镜像服务的数据保护手段和特性 数据保护手段 简要说明 传输加密（HTTPS） IMS支持HTTP和HTTPS两种传输协议，为保证数据传输的安全性，推荐您使用更加安全的HTTPS协议。 数据冗余存储 IMS
导出镜像 功能介绍 该接口为扩展接口，用于用户将自己的私有镜像导出到指定的OBS桶中。 导出镜像前请确保用户已拥有对象存储服务的Tenant Administrator权限。 约束与限制 仅支持导出到存储类别为标准存储的桶，并且桶和镜像在同一区域。 如下类型的私有镜像不允许导出：
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。 Token认证：通过Token认证调用请求
删除镜像标签 功能介绍 该接口用于为镜像删除指定的标签。 约束与限制 为兼容遗留数据，不对key进行字符集校验和长度校验。 此接口为非幂等接口：如果指定删除的key不存在，则返回404状态码。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v2/{project_id
查询镜像配额 功能介绍 该接口为扩展接口，主要用于查询租户在当前Region的私有镜像的配额数量。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/quota 请求消息 请求参数 无 请求示例 查询镜像配额。 GET https
镜像标签数据格式 概念 镜像标签可供给用户对私有镜像进行自定义标记。通过镜像标签，用户可以自由地对私有镜像分类管理。 镜像标签数据格式 tag数据格式： 标签数据规范的格式为“key.value”，新增key为增加标签，否则为修改标签。 当标签数据出现多个小数点时，定义第一个小数点之前的为
镜像共享的约束限制 概念 用户可以通过镜像共享将自己的私有镜像共享给其他用户使用。 约束与限制 用户只能共享自己没有发布为市场镜像的私有镜像，已经发布为市场镜像的不能共享。 镜像共享的范围只能在区域内。 系统盘镜像和数据盘镜像最多可以共享给128个租户，整机镜像最多可以共享给10个租户
可以裁剪镜像吗？ 不建议您裁剪镜像。 在导入外部镜像文件时，建议您使用操作系统官方发行版本进行系统构建，避免对发行版本进行裁剪及高度定制，以减少问题发生概率。 操作系统发行版本由操作系统厂商进行不定期版本更迭，部分系统版本厂商已停止维护，不再发布问题修复及安全补丁，建议及时关注厂商公告进行系统升级更新
添加镜像标签 功能介绍 该接口用于为指定镜像添加或更新指定的单个标签。 约束与限制 每个标签由键值对组成，标签的key的长度不超过36个字符，value的长度不超过43个字符。key不能为空或空白字符串，value不能为空，但可以是空白字符串。 单个镜像最多添加10个标签。 此接口为幂等接口
查询镜像标签 功能介绍 该接口用于查询指定镜像上的所有标签。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/{project_id}/images/{image_id}/tags 参数说明请参见表1。 表1 参数说明 参数 是否必选 参数类型 描述
批量添加镜像成员 功能介绍 该接口为扩展接口，主要用于镜像共享时用户将多个镜像共享给多个用户。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。 调试
共享指定镜像 操作场景 用户A获取用户B的项目ID之后，可以将指定的私有镜像共享给用户B。共享镜像可以分为批量镜像共享和单个镜像共享两种方式，用户可以按照需要进行选择。 前提条件 用户A已获取用户B的项目ID。 共享镜像前，请确认私有镜像已清除敏感数据和文件。 操作步骤 批量镜像共享
查询租户所有镜像标签 功能介绍 该接口用于查询租户的所有镜像上的标签。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/{project_id}/images/tags 参数说明请参见表1。 表1 参数说明 参数 是否必选 参数类型 描述 project_id
创建用户并授权使用IMS 操作场景 如果需要对您所拥有的IMS资源进行精细的权限管理，可以使用统一身份认证服务（Identity and Access Management，简称IAM）。通过IAM，您可以： 根据企业的业务组织，在您的华为账号中，给企业中不同职能部门的员工创建IAM
共享镜像如何计费？ 来源于他人共享的系统盘镜像、数据盘镜像：免费。 来源于他人共享的整机镜像：涉及云备份存储费用。 仅云备份创建的整机镜像支持共享。 父主题： 镜像共享类
增加或修改标签 功能介绍 该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签，用户可以将镜像进行分类。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/cloudimages/tags 请求消息 请求参数 参数 是否必选 参数类型 描述
批量删除镜像成员 功能介绍 该接口为扩展接口，主要用于取消镜像共享。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。 调试 您可以在API Explorer
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
