上传镜像（OpenStack原生）

功能介绍

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

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

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

准备待上传的镜像，支持的镜像格式：QCOW2、VMDK、VHD、RAW、VHDX、QED、VDI、QCOW、ZVHD2和ZVHD。
使用创建镜像元数据（OpenStack原生）创建镜像元数据。调用成功后，保存该镜像的ID。
使用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	系统错误。