检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 镜像服务所提供的接口分为IMS接口与OpenStack原生接口。推荐您使用IMS接口。 通过配合使用镜像服务提供的接口和OpenStack原生接口,您可以完整地使用镜像服务的所有功能。例如制作私有镜像,可以使用OpenStack原生接口,也可以使用IMS接口进行操作。
查询API版本信息(OpenStack原生) 查询版本列表(OpenStack原生) 查询指定版本信息(OpenStack原生) 父主题: OpenStack原生API
如何调用API 构造请求 认证鉴权 返回结果
API 镜像 镜像标签 镜像共享 镜像复制 镜像配额 镜像任务
OpenStack原生API 镜像(OpenStack原生) 镜像视图(OpenStack原生) 镜像共享(OpenStack原生) 查询API版本信息(OpenStack原生)
历史API 镜像(OpenStack原生) 镜像标签(OpenStack原生) 镜像共享(OpenStack原生)
查询镜像标签 功能介绍 该接口用于查询指定镜像上的所有标签。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/{project_id}/images/{image_id}/tags 参数说明请参见表1。 表1 参数说明 参数 是否必选 参数类型 描述
增加或修改标签 功能介绍 该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签,用户可以将镜像进行分类。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/cloudimages/tags 请求消息 请求参数 参数 是否必选 参数类型 描述
查询镜像视图(OpenStack原生) 功能介绍 该接口主要用于查询镜像视图,通过视图,用户可以了解到镜像包含哪些属性,同时也可以了解每个属性的数据类型等。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/schemas/image 请求消息 请求参数
使用上传至OBS桶中的外部数据盘镜像文件制作数据镜像。作为异步接口,调用成功,只是说明后台收到了制作请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/cloudimages/dataimages/action
功能介绍 本接口用于制作私有镜像,支持: 使用云服务器制作私有镜像(系统盘镜像/数据盘镜像)。 使用上传至OBS桶中的外部镜像文件制作系统盘镜像。 使用数据盘制作系统盘镜像。 作为异步接口,调用成功,只是说明云平台收到了制作请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询。
制作整机镜像 功能介绍 使用云服务器、云服务器备份或者云备份制作整机镜像。作为异步接口,调用成功,只是说明后台收到了制作整机镜像的请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询。 约束与限制(使用云服务器制作整机镜像) 创建整机镜像时,
invalid.", "code": "IMG.0024" } } 错误码说明 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 表1 错误码 状态码 错误码 错误信息 描述 处理措施 400 IMG.0001 The request
按条件查询租户镜像标签列表 按标签查询镜像 批量添加删除镜像标签 添加镜像标签 删除镜像标签 查询镜像标签 查询租户所有镜像标签 父主题: API
镜像复制 Region内复制镜像 跨Region复制镜像 父主题: API
W或ZVHD2格式,因此镜像文件小于128GB时推荐您优先使用常规的创建私有镜像的方式。 作为异步接口,调用成功,只是说明后台收到了制作请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询。 约束与限制 快速导入前请确认RAW或ZVHD2格式的镜像文件已完成以下准备:
镜像配额 查询镜像配额 父主题: API
更新镜像信息 制作镜像 镜像文件快速导入 使用外部镜像文件制作数据镜像 制作整机镜像 注册镜像 导出镜像 查询镜像支持的OS列表 父主题: API
镜像任务 异步任务查询 异步任务进度查询 父主题: API
镜像共享 批量删除镜像成员 批量添加镜像成员 批量更新镜像成员状态 父主题: API