# 导出镜像（新） - ExportImageInSafeMode #### 功能介绍 该接口为扩展接口，用于用户将自己的私有镜像导出到指定的OBS桶中。 ![](https://support.huaweicloud.com/api-ims/public_sys-resources/note_3.0-zh-cn.png) 导出镜像前请确保用户已拥有对象存储服务的Tenant Administrator权限。 #### 约束限制 表1导出镜像约束限制 | 限制类别 | 具体限制 | |:---|:---| | 区域限制 | 仅支持导出到存储类别为标准存储的桶，并且桶和镜像在同一区域。 | | 镜像类型限制 | 如下类型的私有镜像不允许导出： - 整机镜像 - ISO镜像 - Windows、SUSE、Red Hat、Oracle Linux公共镜像所创建的私有镜像 - 市场镜像所创建的私有镜像 说明： - 加密镜像无法使用[快速导出功能](https://support.huaweicloud.com/ims_faq/faq_20191025_1.html)。若要将此镜像导出，可以解密后再导出。 - 部分区域已支持Ubuntu公共镜像创建的私有镜像导出，请以控制台实际操作提示为准。 | | 镜像格式限制 | - 支持导出zvhd2、qcow2、vmdk、vhd和zvhd格式的镜像。创建的私有镜像默认格式为zvhd2，导出过程中，不同的格式会导致导出的镜像大小不同。 - 使用快速导出镜像功能无法指定导出格式，导出的镜像文件格式只能为zvhd2，如果需要导出其他格式，您可以在镜像导出完成后，使用qemu-img-hw工具转换为其他格式的镜像文件。具体操作步骤请参考"[通过qemu-img-hw工具转换镜像格式](https://support.huaweicloud.com/bestpractice-ims/ims_bp_0052.html)"。 | | 镜像大小限制 | 镜像大小必须小于1TiB；大于128GiB且小于1TiB的镜像仅支持快速导出。镜像导出和快速导出的区别，请参见[导入和快速导入、导出和快速导出功能对比](https://support.huaweicloud.com/ims_faq/faq_20191025_1.html)。 说明： 部分区域支持导出的镜像大小上限可能大于128GiB，请以控制台实际操作提示为准。 | | 时间限制 | 导出镜像所需时间取决于私有镜像大小和当前导出任务的并发数，需要您耐心等待。 | | 费用相关 | 导出的镜像会产生一定的OBS存储费用。计费详情请参见"[OBS的收费标准](https://www.huaweicloud.com/pricing.html?tab=detail#/obs)" 。 | | 权限相关 | 加密镜像场景需要租户有KMS相关action权限。 | #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IMS/doc?locale=zh-cn&consoleCurrentProductId=ims&consoleCurrentProductshort=&api=ExportImageInSafeMode)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ims/ims_03_appendix_03.html)。 #### URI POST /v2.1/cloudimages/{image_id}/file 参数说明请参见[表2]。 表2参数说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | image_id | 是 | String | **参数解释：** 镜像ID。如何获取镜像ID，请参见[查询镜像列表 - ListImages](https://support.huaweicloud.com/api-ims/ims_03_0602.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 请求消息 - 请求参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | bucket_url | 是 | String | **参数解释：** 目的文件的URL，格式：\:\ **约束限制：** OBS桶和镜像文件的存储类别必须是标准存储 **取值范围：** 不涉及 **默认取值：** 不涉及 | | file_format | 是 | String | **参数解释：** 文件格式。 **约束限制：** 不涉及 **取值范围：** - qcow2：QCOW2格式镜像是QEMU模拟器支持的一种磁盘镜像，是用一个文件的形式来表示一块固定大小的块设备磁盘。 - vhd：VHD是微软提供的一种虚拟硬盘文件格式。VHD文件格式可以被压缩成单个文件存放到宿主机的文件系统上，主要包括弹性云服务器启动所需的文件系统。 - zvhd：云服务内部自研格式，采用ZLIB压缩算法，支持顺序读写。 - vmdk：VMDK是VMware创建的虚拟硬盘格式。一个VMDK文件代表VMFS（弹性云服务器文件系统）在弹性云服务器上的一个物理硬盘驱动。 **默认取值：** 不涉及 | | is_quick_export | 否 | Boolean | **参数解释：** 是否使用快速导出。 **约束限制：** 若使用快速导出，则无法指定file_format参数。导出的镜像文件格式为zvhd2。 **取值范围：** 取值为true或者false。 - true：使用快速导出。 - false：不使用快速导出。 **默认取值：** false | #### 请求示例 导出镜像，其中，镜像文件格式为"qcow2"，目的文件的URL为"ims-image:centos7_5.qcow2" ``` POST https://{Endpoint}/v2.1/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。 详情请参见[6.6.2-异步任务进度查询 - ShowJobProgress](https://support.huaweicloud.com/api-ims/ims_03_0911.html)。 **取值范围：** 不涉及 | - 响应样例 ``` STATUS CODE 200 ``` ``` { "job_id": "edc89b490d7d4392898e19b2deb34797" } ``` #### 返回值 - 正常 200 - 异常 | 返回值 | 说明 | |:---|:---| | 400 Bad Request | 请求错误，具体返回错误码请参见[错误码](https://support.huaweicloud.com/api-ims/ims_03_0908.html)。 | | 401 Unauthorized | 鉴权失败。 | | 403 Forbidden | 没有操作权限。 | | 404 Not Found | 找不到资源。 | | 500 Internal Server Error | 服务内部错误。 | | 503 Service Unavailable | 服务不可用。 |