华为云计算 云知识 导出镜像ExportImage
导出镜像ExportImage

 

功能介绍

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

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

约束与限制

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

调试

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

URI

POST /v1/cloudimages/{image_id}/file

参数说明请参见表1。
表1 参数说明

参数

是否必选

参数类型

描述

image_id

String

镜像ID。

如何获取镜像ID,请参见查询镜像列表

请求消息

  • 请求参数

    参数

    是否必选

    参数类型

    描述

    bucket_url

    String

    目的文件的URL,格式::。

    说明:

    此处的OBS桶和镜像文件的存储类别必须是标准存储。

    file_format

    String

    文件格式,支持qcow2、vhd、zvhd和vmdk。

    is_quick_export

    Boolean

    是否使用快速导出,取值为true或者false。

    说明:

    若使用快速导出,则无法指定file_format参数。

请求示例

导出镜像,其中,镜像文件格式为“qcow2”,目的文件的URL为“ims-image:centos7_5.qcow2”

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
    {
        "job_id": "edc89b490d7d4392898e19b2deb34797"
    }
    

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误,具体返回错误码请参见错误码

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

上一篇:IAM中的用户 下一篇:Linux常用命令及Shell编程

镜像服务 IMS

镜像是用于创建服务器或磁盘的模板。镜像服务提供镜像生命周期管理能力。可以通过服务器或外部文件创建系统盘镜像或数据盘镜像,也可以使用弹性云服务器或云服务器备份创建带数据盘的整机镜像。创建镜像功能免费,仅需支付使用对象存储服务或云服务器备份的费用。