Question

Post object related api supported by FDS

Version: 1.0.0

/{bucketname}

POST

Summary:

上传object，服务端将会返回上传的Object名字，保证唯一，不会覆盖已有Object

Description:

必须拥有Bucket的WRITE权限才能执行该操作

Parameters

Name	Located in	Description	Required	Schema
bucketname	path	Bucket名字	Yes	string
authorization	header	认证信息，计算方式参考签名认证相关文档	Yes	string
Date	header	请求时间	Yes	string
expires	query	如果上传成功，返回的签名的过期时间戳（UTC），单位毫秒，默认30天	No	string
body	body	Object内容	Yes	binary

Responses

Code	Description	Schema
200	请求成功	PutObjectResult

Models

PutObjectResult

Name	Type	Description	Required
bucketname	string (int32)	Bucket名字	No
objectName	string	Object名字	No
accessKeyId	string	签名用的accessKeyId	No
signature	string	用于下载这个Object的签名	No
expires	string	签名失效时间戳（UTC），单位毫秒，默认有效时间30天	No

命令行示例

# 上传一个Object到fds-demo下，object的名字由服务端生成并返回，并且：
# 通过header指定object的content-type
# 通过header指定所有人可读
curl -v -X 'POST' 'http://cnbj0.fds.api.xiaomi.com/fds-demo/' \
> -H 'content-type: application/json' \
> -H 'authorization: Galaxy-V2 54xxx45:JUxxxc=' \
> -H 'x-xiaomi-meta-acl: PUBLIC_READ' \
> -H 'date: Mon, 27 Feb 2017 10:10:04 GMT' \
> -d '{}'

* Hostname was NOT found in DNS cache
*   Trying 111.206.200.99...
* Connected to cnbj0.fds.api.xiaomi.com (111.206.200.99) port 80 (#0)
> POST /fds-demo/ HTTP/1.1
> User-Agent: curl/7.35.0
> Host: cnbj0.fds.api.xiaomi.com
> Accept: */*
> content-type: application/json
> authorization: Galaxy-V2 54xxx45:JUxxxc=
> x-xiaomi-meta-acl: PUBLIC_READ
> date: Mon, 27 Feb 2017 10:10:04 GMT
> Content-Length: 2
> 
* upload completely sent off: 2 out of 2 bytes
< HTTP/1.1 200 OK
* Server Tengine is not blacklisted
< Server: Tengine
< Date: Mon, 27 Feb 2017 10:11:30 GMT
< Content-Type: application/json
< Content-Length: 174
< Connection: keep-alive
< Access-Control-Allow-Credentials: true
< Access-Control-Max-Age: 1728000
< Access-Control-Allow-Methods: GET, POST, PUT, HEAD, DELETE, OPTIONS
< Access-Control-Allow-Headers: DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization,Content-MD5
< Access-Control-Expose-Headers: content-md5, upload-time, x-xiaomi-meta-content-length
< 
* Connection #0 to host cnbj0.fds.api.xiaomi.com left intact
{"accessKeyId":"54xxx45","bucketName":"fds-demo","expires":1490782290071,"objectName":"f0f0b424-05a3-4e8d-81ee-597b9be199d7","signature":"2Gxxx1PM="}