表单上传 - PostFile

表单上传文件

说明:适合使用浏览器的场景并且上传文件内容可以在一次HTTP请求完成,并且所有PUT上传支持的参数都可以在表单上传中指定。

Requests

Syntax:

POST / HTTP/1.1
Host: .cn-bj.ufileos.com
Content-Type: multipart/form-data; boundary=----AutoAIPOSTFormTestBoundary
Content-Length: 

Request Headers

Name Type Description Required
Content-Type String 待上传文件的类型,必须为multipart/form-data Yes
Content-Length Integer 请求body的长度 Yes
Content-MD5 String 文件内容的MD5摘要,为了保证数据的完整性,建议要配置Content-MD5并检查一致性 No
X-Ufile-Storage-Class String 文件存储类型,分别是标准、低频、归档,对应有效值:STANDARD, IA, ARCHIVE No

Request Parameters

Name Type Description Required
FileName StringBucket中文件的名称 Yes
AuthorizationString上传请求的授权签名 Yes
Content-Type String上传文件本身的MimeTypeNo
<blockquote>
  * **注意:**     - 以上参数是在form表单中的参数。
    - POST 表单上传时签名使用的是 form 表单参数的 Content-Type(即上传文件本身的 mimetype), 而非本次 HTTP 请求的 Content-Type。
</blockquote>

Responses

Response Headers

Name Type Description
Content-Type String 响应body部分的类型
Content-LengthInteger响应body部分的大小
ETag String 完成上传的文件的哈希值
X-SessionId String 请求失败时返回本次请求的会话Id

Response Elements

Name Type Description
RetCodeInteger执行失败时的错误代码
ErrMsg String 执行失败时的错误消息
注意: 成功执行只会返回HTTP 200回应,不带body数据.

Example

Example Request:

POST / HTTP/1.1
Host: .cn-bj.ufileos.com
Content-MD5: c5371fe3624d438cd8a59420a3221978
Content-Type: multipart/form-data; boundary=----AutoAIPOSTFormBoundary

------AutoAIPOSTFormBoundary
Content-Disposition: form-data; name="FileName"

demofile
------AutoAIPOSTFormBoundary
Content-Disposition: form-data; name="Authorization"

AutoAI demouser@ucloud.cn13424346821929713944:S5FVD2w613MKb/hisjaqHdjvn9U=
------AutoAIPOSTFormBoundary
Content-Disposition: form-data; name="file"; filename="MyFilename.jpg"
Content-Type: image/jpeg


------AutoAIPOSTFormBoundary--

Example Response:

HTTP/1.1 200 OK
Content-Length: 0
ETag: AQAAABP9DJdoo2X0hKyax2pVTLQPaVzH