镜像服务 IMS
镜像服务 IMS
- 最新动态
- 功能总览
- 产品介绍
- 快速入门
-
用户指南
- 通过IAM授予使用IMS的权限
- 创建私有镜像
- 管理私有镜像
- Windows操作系统相关操作
- Linux操作系统相关操作
- 管理公共镜像
- 标签管理
- 配额管理
- 使用CTS审计IMS操作事件
- 最佳实践
- API参考
- SDK参考
- 场景代码示例
-
常见问题
- 镜像咨询类
- 操作系统停止支持类
- 镜像创建类
- 镜像共享类
- 操作系统类
- 镜像导入类
- 镜像导出类
-
镜像优化类
- 一定要在云服务器中安装Guest OS driver吗?
- Windows操作系统为什么要安装并更新virtio?
- 通过镜像文件注册私有镜像过程中,系统会对镜像做哪些修改?
- 创建私有镜像前云服务器、裸金属服务器或镜像文件需要完成哪些初始化配置?
- Windows外部镜像文件在导出前未完成初始化配置,怎么办?
- Linux外部镜像文件在导出前未完成初始化配置,怎么办?
- 如何优化镜像?
- 如何使用通过I代云服务器创建的私有镜像创建II代云服务器
- 如何设置镜像的网卡多队列属性?
- 如何配置IPv6地址
- 如何优化系统盘镜像使其支持实例快速发放?
- 为什么Windows云服务器安装Guest OS driver会失败?
- 怎样安装原生的XEN和KVM驱动
- 镜像复制类
- 镜像删除类
- 镜像加密类
- 市场镜像类
- 账号与权限类
- Cloud-Init操作类
- 云服务器创建类
- 驱动安装类
- 镜像标签类
- 计费类
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
注册镜像
功能介绍
该接口用于将镜像文件注册为云平台未初始化的私有镜像。
使用该接口注册镜像的具体步骤如下:
- 将镜像文件上传到OBS个人桶中。具体操作请参见“上传文件或文件夹”。
- 使用创建镜像元数据接口创建镜像元数据。调用成功后,保存该镜像的ID。创建镜像元数据请参考创建镜像元数据(OpenStack原生)。
- 根据2得到的镜像ID,使用注册镜像接口注册OBS桶中的镜像文件。
- 注册镜像接口作为异步接口,调用成功后,说明后台收到了注册请求。需要根据镜像ID查询该镜像状态验证镜像注册是否成功。当镜像状态变为“active”时,表示镜像注册成功。
如何查询异步任务,请参见异步任务查询。
注册镜像前请确保用户已拥有对象存储服务的Tenant Administrator权限。
调试
您可以在API Explorer中调试该接口。
URI
PUT /v1/cloudimages/{image_id}/upload
请求消息
- 请求参数
参数
是否必选
参数类型
描述
image_url
是
String
源镜像的URL,格式:<bucket>:<file>
image_url对应的镜像桶中的文件,镜像文件格式的取值范围为:ZVHD、QCOW2、VHD、RAW、VHDX、QED、VDI、QCOW、ZVHD2、VMDK、ISO。
说明:
此处的OBS桶和镜像文件的存储类别必须是标准存储。
请求示例
注册镜像,其中,源镜像URL为“bucketname:Centos6.5-disk1.vmdk”。
1 2 3 4 |
PUT https://{Endpoint}/v1/cloudimages/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba86/upload { "image_url": "bucketname:Centos6.5-disk1.vmdk" } |
响应消息
- 响应参数
参数
参数类型
描述
job_id
String
异步任务ID。
详情请参见异步任务查询。
- 响应样例
HTTP/1.1 200
1 2 3
{ "job_id":" b912fb4a4c464b568ecfca1071b21b10" }
返回值
返回值 |
说明 |
---|---|
400 Bad Request |
请求错误,具体返回错误码请参见错误码。 |
401 Unauthorized |
鉴权失败。 |
403 Forbidden |
没有操作权限。 |
404 Not Found |
找不到资源。 |
父主题: 镜像