Question

Add/Delete object acl related api supported by FDS

Version: 1.0.0

/{bucketname}/{objectname}

PUT

Summary:

修改Object的ACL

Description:

只有Object的拥有者或拥有Bucket FULL_CONTROL权限,才能执行这个操作

Parameters

Name	Located in	Description	Required	Schema
bucketname	path	Bucket名字	Yes	string
objectname	path	Object名字	Yes	string
authorization	header	认证信息，计算方式参考签名认证相关文档	Yes	string
Date	header	请求时间	Yes	string
acl	query	表示该请求是为Bucket的ACL操作，值为空	Yes	string
action	query	执行的操作，如果是delete，表示删除ACL，缺省为添加ACL	No	string
body	body	需要修改的ACL 信息	Yes	AccessControlPolicy

Responses

Code	Description
200	请求成功

Models

AccessControlPolicy

Name	Type	Description	Required
owner	OwnerBean		No
accessControlList	[ GrantBean ]		No

GrantBean

Name	Type	Description	Required
grantee	GranteeBean		No
permission	string	权限描述，包括READ, FULL_CONTROL	No
type	string	授权对象类型，包括USER, GROUP	No

GranteeBean

Name	Type	Description	Required
id	string	用户ID	No

OwnerBean

Name	Type	Description	Required
id	string	所有者ID	No
displayName	string	所有者名称	No	### 命令行示例

# 为id是10xx08的用户添加读取fds-demo下tests/test.txt的权限
curl -v -X 'PUT' 'http://cnbj0.fds.api.xiaomi.com/fds-demo/tests/test.txt?acl' \
> -H 'content-type: application/json; charset=UTF-8' \
> -H 'authorization: Galaxy-V2 54x045:2ExxxrQ=' \
> -H 'date: Mon, 27 Feb 2017 10:15:02 GMT' \
> -d '{"owner":{"id":"541xxxx45"},"accessControlList":[{"grantee":{"id":"10xx8"},"permission":"READ","type":"USER"}]}'

* 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)
> PUT /fds-demo/tests/test.txt?acl HTTP/1.1
> User-Agent: curl/7.35.0
> Host: cnbj0.fds.api.xiaomi.com
> Accept: */*
> content-type: application/json; charset=UTF-8
> authorization: Galaxy-V2 54x045:2ExxxrQ=
> date: Mon, 27 Feb 2017 10:15:02 GMT
> Content-Length: 116
> 
* upload completely sent off: 116 out of 116 bytes
< HTTP/1.1 200 OK
* Server Tengine is not blacklisted
< Server: Tengine
< Date: Mon, 27 Feb 2017 10:15:57 GMT
< Content-Length: 0
< 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