FDS Restful API
Post object related api supported by FDS
Version: 1.0.0
/{bucketname}
POST
Summary: upload object，the server will return the object names, unique, won't override exsisting object
Description: must have WRITE permission of the bucket
Parameters
| Name | Located in | Description | Required | Schema |
|---|---|---|---|---|
| bucketname | path | Bucket name | Yes | string |
| authorization | header | authentication info，The calculation method is referred to the relevant document of signature verification | Yes | string |
| Date | header | request time | Yes | string |
| expires | query | if upload successfully，expire time stamp of the signature returned（UTC）,unit is ms, default 30 days | No | string |
| body | body | Object content | Yes | binary |
Responses
| Code | Description | Schema |
|---|---|---|
| 200 | request successfully | PutObjectResult |
Models
| Name | Type | Description | Required |
|---|---|---|---|
| bucketname | string (int32) | Bucket name | No |
| objectName | string | Object name | No |
| accessKeyId | string | accessKeyId used for signature | No |
| signature | string | signature used for downloading the object | No |
| expires | string | Signature failure time stamp（UTC）, time is ms, default time is 30 days | No |
command line examples
# upload an Object under fds-demo，the name of the object is generated and returned by the server,and：
# Specify object's content-type through header
# Specify all users can read through 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="}