导出镜像
功能介绍
该接口为扩展接口,用于用户将自己的私有镜像导出到指定的OBS桶中。
导出镜像前请确保用户已拥有对象存储服务的Tenant Administrator权限。
约束与限制
- 仅支持导出到存储类别为标准存储的桶,并且桶和镜像在同一区域。
- 如下类型的私有镜像不允许导出:
- 整机镜像
- ISO镜像
- Windows、SUSE、Red Hat、Ubuntu、Oracle Linux公共镜像所创建的私有镜像
- 市场镜像所创建的私有镜像
- 镜像大小必须小于1TB;大于128GB的镜像仅支持快速导出。
部分区域支持导出的镜像大小上限可能大于128G,请以控制台实际操作提示为准。
URI
POST /v1/cloudimages/{image_id}/file
请求消息
- 请求参数
参数
是否必选
参数类型
描述
bucket_url
是
String
目的文件的URL,格式:<bucket>:<file>。
说明:此处的OBS桶和镜像文件的存储类别必须是标准存储。
file_format
是
String
文件格式,支持qcow2、vhd、zvhd和vmdk。
is_quick_export
否
Boolean
是否使用快速导出,取值为true或者false。
说明:若使用快速导出,则无法指定file_format参数。导出的镜像文件格式为zvhd2。
请求示例
导出镜像,其中,镜像文件格式为“qcow2”,目的文件的URL为“ims-image:centos7_5.qcow2”
1 2 3 4 5 6 |
POST https://{Endpoint}/v1/cloudimages/d164b5df-1bc3-4c3f-893e-3e471fd16e64/file { "bucket_url": "ims-image:centos7_5.qcow2", "file_format": "qcow2", "is_quick_export": false } |
响应消息
- 响应参数
参数
参数类型
描述
job_id
String
异步任务ID。
详情请参见异步任务查询。
- 响应样例
STATUS CODE 200
1 2 3
{ "job_id": "edc89b490d7d4392898e19b2deb34797" }
返回值
- 正常
- 异常
返回值
说明
400 Bad Request
请求错误,具体返回错误码请参见错误码。
401 Unauthorized
鉴权失败。
403 Forbidden
没有操作权限。
404 Not Found
找不到资源。
500 Internal Server Error
服务内部错误。
503 Service Unavailable
服务不可用。