检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API 镜像 镜像标签 镜像共享 镜像复制 镜像配额 镜像任务
API概览 镜像服务所提供的接口分为IMS接口与OpenStack原生接口。推荐您使用IMS接口。 通过配合使用镜像服务提供的接口和OpenStack原生接口，您可以完整地使用镜像服务的所有功能。例如制作私有镜像，可以使用OpenStack原生接口，也可以使用IMS接口进行操作。
如何调用API 构造请求 认证鉴权 返回结果
OpenStack原生API 镜像（OpenStack原生） 镜像标签（OpenStack原生） 镜像视图（OpenStack原生） 镜像共享（OpenStack原生） 查询API版本信息（OpenStack原生）
查询镜像视图（OpenStack原生） 功能介绍 该接口主要用于查询镜像视图，通过视图，用户可以了解到镜像包含哪些属性，同时也可以了解每个属性的数据类型等。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/schemas/image 请求消息 请求参数
查询镜像标签 功能介绍 该接口用于查询指定镜像上的所有标签。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/{project_id}/images/{image_id}/tags 参数说明请参见表1。 表1 参数说明 参数 是否必选 参数类型 描述
查询API版本信息（OpenStack原生） 查询版本列表（OpenStack原生） 查询指定版本信息（OpenStack原生） 父主题： OpenStack原生API
云服务器购买成功后可以换镜像吗？ 可以。 如果由于镜像选择错误，业务需求变化，或者其他原因需要更换镜像，可以使用“切换操作系统”功能进行更换。 华为云支持不同镜像类型（包括公共镜像、私有镜像、共享镜像以及市场镜像）与不同操作系统之间互相切换。您可以将现有的操作系统切换为不同镜像类
异步任务查询 功能介绍 该接口为扩展接口，主要用于查询异步接口执行情况，比如查询导出镜像任务的执行状态。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/jobs/{job_id} 参数说明请参见表1。 表1 参数说明 参数
删除镜像标签 功能介绍 该接口用于为镜像删除指定的标签。 约束与限制 为兼容遗留数据，不对key进行字符集校验和长度校验。 此接口为非幂等接口：如果指定删除的key不存在，则返回404状态码。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v2/{
查询镜像配额 功能介绍 该接口为扩展接口，主要用于查询租户在当前Region的私有镜像的配额数量。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/quota 请求消息 请求参数 无 请求示例 查询镜像配额。 GET http
批量删除镜像成员 功能介绍 该接口为扩展接口，主要用于取消镜像共享。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。 调试 您可以在API Explorer中调试该接口。
增加或修改标签 功能介绍 该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签，用户可以将镜像进行分类。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/cloudimages/tags 请求消息 请求参数 参数 是否必选 参数类型 描述
killed：表示镜像上传错误。 active：表示镜像可以正常使用。 tags Array of strings 镜像标签列表，提供用户可以自定义管理私有镜像的能力。用户可以通过镜像标签接口为每个镜像增加不同的标签，在查询接口中可以根据标签进行过滤。 visibility String
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
批量更新镜像成员状态 功能介绍 该接口为扩展接口，主要用于用户接受或者拒绝多个共享镜像时批量更新镜像成员的状态。 该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。
killed：表示镜像上传错误。 active：表示镜像可以正常使用。 tags Array of strings 镜像标签列表，提供用户可以自定义管理私有镜像的能力。用户可以通过镜像标签接口为每个镜像增加不同的标签，在查询接口中可以根据标签进行过滤。 visibility String
注册镜像 功能介绍 该接口用于将镜像文件注册为云平台未初始化的私有镜像。 使用该接口注册镜像的具体步骤如下： 将镜像文件上传到OBS个人桶中。具体操作请参见“上传文件或文件夹”。 使用创建镜像元数据接口创建镜像元数据。调用成功后，保存该镜像的ID。创建镜像元数据请参考创建镜像元数据（OpenStack原生）。
完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创建IAM用户接口，返回如图1所示的消息头，其中“X-Subject-To
按标签查询镜像 功能介绍 该接口用于按标签或其他条件对镜像进行过滤或者计数使用。 约束与限制 为兼容遗留数据，使用tags、not_tags、tags_any、not_tags_any参数时，不对查询条件中标签的key、value进行字符集校验。 调试 您可以在API Explorer中调试该接口。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
