导出镜像

功能介绍

该接口为扩展接口，用于用户将自己的私有镜像导出到指定的OBS桶中。

导出镜像前请确保用户已拥有对象存储服务的Tenant Administrator权限。

约束与限制

• 仅支持导出到存储类别为标准存储的桶，并且桶和镜像在同一区域。
• 如下类型的私有镜像不允许导出：
  • 整机镜像
  • ISO镜像
  • Windows、SUSE、Red Hat、Ubuntu、Oracle Linux公共镜像所创建的私有镜像
  • 市场镜像所创建的私有镜像
• 镜像大小必须小于1TB；大于128GB的镜像仅支持快速导出。
  

  部分区域支持导出的镜像大小上限可能大于128G，请以控制台实际操作提示为准。

调试

您可以在API Explorer中调试该接口。

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" }

返回值

• 正常

  200

• 异常

  返回值	说明
  400 Bad Request	请求错误，具体返回错误码请参见错误码。
  401 Unauthorized	鉴权失败。
  403 Forbidden	没有操作权限。
  404 Not Found	找不到资源。
  500 Internal Server Error	服务内部错误。
  503 Service Unavailable	服务不可用。