更新时间:2024-04-16 GMT+08:00

上传镜像(OpenStack原生)

功能介绍

该接口用于上传用户本地的镜像文件到云平台。使用该接口上传镜像时,镜像文件大小需要小于2GB,超过2GB的镜像文件参考注册镜像进行操作。

了解更多关于使用外部文件创建镜像的相关内容,请参见《镜像服务用户指南》中“通过外部镜像文件创建Windows私有镜像”、“通过外部镜像文件创建Linux私有镜像”章节。

使用该接口上传镜像的具体步骤如下:

  1. 准备待上传的镜像,支持的镜像格式:QCOW2、VMDK、VHD、RAW、VHDX、QED、VDI、QCOW、ZVHD2和ZVHD。
  2. 使用创建镜像元数据(OpenStack原生)创建镜像元数据。调用成功后,保存该镜像的ID。
  3. 使用2得到的镜像ID,上传支持格式的镜像文件。

URI

PUT /v2/images/{image_id}/file

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

参数

是否必选

参数类型

描述

image_id

String

镜像ID。

  • image_id为用户调用创建镜像元数据接口所创建出来镜像的id,使用其他方式创建的镜像id会导致上传失败。
  • 上传接口调用成功后,请根据镜像id查询镜像的状态。镜像状态变为active表示镜像上传成功。

请求消息

  • 请求参数

    参数

    是否必选

    参数类型

    描述

    image_file

    file

    上传文件请求体,选择需要上传的本地文件

请求示例

PUT https://{Endpoint}/v2/images/84ac7f2b-bf19-4efb-86a0-b5be8771b476/file

如果使用curl命令方式调用接口,样例参考如下:

curl -i --insecure 'https://IP/v2/images/84ac7f2b-bf19-4efb-86a0-b5be8771b476/file' -X PUT -H "X-Auth-Token: $mytoken" -H "Content-Type:application/octet-stream" -T /mnt/userdisk/images/suse.zvhd

响应消息

  • 响应参数

  • 响应样例
    HTTP/1.1 204

返回值

  • 正常

    204

  • 异常

    返回值

    说明

    400 Bad Request

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

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    409 Conflict

    请求冲突。

    500 System Error

    系统错误。