FDS Restful API
Get object acl related api supported by FDS
Version: 1.0.0
/{bucketname}/{objectname}
GET
Summary: get object's ACL info
Description: must have READ permission of the object to operate
Parameters
| Name | Located in | Description | Required | Schema |
|---|---|---|---|---|
| bucketname | path | Bucket name | Yes | string |
| objectname | path | Object name | Yes | string |
| acl | query | acl operation，value is void | Yes | string |
| authorization | header | authentication info，The calculation method is referred to the relevant document of signature verification | No | string |
| Date | header | request time | Yes | string |
Responses
| Code | Description | Schema |
|---|---|---|
| 200 | request successfully，return Object's ACL info | AccessControlPolicy |
Models
| Name | Type | Description | Required |
|---|---|---|---|
| owner | OwnerBean | No | |
| accessControlList | [ GrantBean ] | No |
| Name | Type | Description | Required |
|---|---|---|---|
| grantee | GranteeBean | No | |
| permission | string | permission description，including READ, FULL_CONTROL |
No |
| type | string | Type of authorization object，including USER, GROUP |
No |
| Name | Type | Description | Required |
|---|---|---|---|
| id | string | user ID | No |
| Name | Type | Description | Required |
|---|---|---|---|
| id | string | owner ID | No |
| displayName | string | owner name | No |
command line examples
curl -v -X 'GET' 'http://cnbj0.fds.api.xiaomi.com/fds-demo/tests/test.txt?acl' \
-H 'authorization: Galaxy-V2 54xxx45:x0axxxvU=' \
-H 'date: Tue, 28 Feb 2017 09:06:20 GMT'
* 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)
> GET /fds-demo/tests/test.txt?acl HTTP/1.1
> User-Agent: curl/7.35.0
> Host: cnbj0.fds.api.xiaomi.com
> Accept: */*
> authorization: Galaxy-V2 54xxx45:x0axxxvU=
> date: Tue, 28 Feb 2017 09:06:20 GMT
>
< HTTP/1.1 200 OK
* Server Tengine is not blacklisted
< Server: Tengine
< Date: Tue, 28 Feb 2017 09:07:09 GMT
< Content-Type: application/json
< Content-Length: 313
< Connection: keep-alive
< cache-control: no-store
< 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
{"accessControlList":[{"grantee":{"id":"10xxx0"},"permission":"READ","type":"USER"},{"grantee":{"id":"ALL_USERS"},"permission":"READ","type":"GROUP"},{"grantee":{"id":"GUEST"},"permission":"FULL_CONTROL","type":"USER"},{"grantee":{"id":"18xxx5"},"permission":"FULL_CONTROL","type":"USER"}],"owner":{"id":"18xxx5"}}