Skip to Content
对象存储 US3put_file

上传文件 - PutFile

简介

普通上传文件

定义

句法（Syntax）:

PUT /<object_name> HTTP/1.1
Host: <bucket_name>.cn-bj.ufileos.com
Authorization: <token>
Content-Length: <length>
Content-Type: <mimetype>
Content-MD5: <md5>

请求参数（Request Parameters）

请求头（Request Headers）

NameTypeDescriptionRequired
AuthorizationString上传请求的授权签名，API 签名算法Yes
Content-LengthInteger请求body部分即待上传文件的长度Yes
Content-TypeString请求body部分即待上传文件的类型No
Content-MD5String文件内容的MD5摘要，为了保证数据的完整性，建议要配置Content-MD5检查一致性No
X-Ufile-Storage-ClassString文件存储类型，分别是标准、低频、归档，对应有效值：STANDARD, IA, ARCHIVENo
X-Ufile-Meta- *StringUS3中规定所有以X-Ufile-Meta-为前缀的参数视为用户自定义元数据（User Meta），比如x-ufile-meta-location。一个文件可以有多个类似的参数，但所有的User Meta总大小不能超过8KB。这些User Meta信息会在GetFile或者HeadFile的时候在HTTP头部中返回。No

请求元素（Request Elements）

说明：未使用。

响应（Responses）

响应头（Response Headers）

NameTypeDescription
Content-TypeString响应body部分的类型
Content-LengthInteger响应body部分的长度
ETagString已经上传文件在US3中的哈希值
X-SessionIdString请求失败时返回本次请求的会话Id

响应元素（Response Elements）

NameTypeDescription
RetCodeInteger执行失败时的错误代码
ErrMsgString执行失败时的错误消息

注意: 成功执行只会返回HTTP 200回应,不带body数据。

示例

请求示例（Example Request）:

PUT /demokey HTTP/1.1
Host: <bucket_name>.cn-bj.ufileos.com
Authorization:  demouser@ucloud.cn13424346821929713944:S5FVD2w613MKb/hisjaqHdjvn9U=
Content-Length: 11434
Content-Type: image/jpg
Content-MD5: c5371fe3624d438cd8a59420a3221978

[11434 bytes of file data]

响应示例（Example Response）:

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

响应错误示例（Example Response with Error）：

HTTP/1.1 404 Not Found
Content-Type: applicaton/json
Content-Length: 54 
X-SessionId: e2f4fc84-3936-4a2d-85b5-ef8f2e79933c

{
    "RetCode": -30010,
    "ErrMsg": "bucket not exist"
}

说明：在带错误的响应中还有一个响应头X-SessionId，可用于服务端进行具体的错误定位。

prefix_file_listrestore