FDS Restful API

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="}

results matching ""

    No results matching ""