asfsdfa

asdfsf.rst

1. A one, two, a one two three four

   
   

   Half a bee, philosophically,

   must, ipso facto, half not be.

   But half the bee has got to be,

   vis a vis its entity. D'you see?

   
   

   But can a bee be said to be

   or not to be an entire bee,

   when half the bee is not a bee,

   due to some ancient injury?

   
   

   Singing...
2. this is two item

   here you are

test.md

GET User Info

获取某用户的信息（如果不指定用户，则获取用户列表）。

请求语法

GET /{admin}/user?format=json HTTP/1.1

请求参数

名称	类型	描述
uid	String	指定用户名

返回参数

名称	类型	描述
user	Container	列出用户信息
user_id	String	用户名
display_name	String	用于显示的用户名
suspended	Boolean	用户账号是否被挂起
max_buckets	Integer	该用户被允许创建的存储桶数量的上限
keys	Container	与该用户相关连的密钥列表
caps	Container	该用户的权限列表

Create User

创建用户

请求语法

PUT /{admin}/user?format=json HTTP/1.1

请求参数

名称	类型	描述
uid	String	指定用户名
display_name	String	用于显示的用户名
email	String	用户的电子邮箱地址
access-key	String	用户的access密钥
secret-key	String	用户的secret密钥
user-caps	String	用户的权限
max-buckets	Integer	该用户被允许创建的存储桶数量的上限

返回参数

名称	类型	描述
user	Container	列出用户信息
user_id	String	用户名
display_name	String	用于显示的用户名
suspended	Boolean	用户账号是否被挂起
max_buckets	Integer	该用户被允许创建的存储桶数量的上限
keys	Container	与该用户相关连的密钥列表
caps	Container	该用户的权限列表

Modify User

修改用户

请求语法

POST /{admin}/user?format=json HTTP/1.1

请求参数

名称	类型	描述
uid	String	指定用户名
display_name	String	用于显示的用户名
email	String	用户的电子邮箱地址
access-key	String	用户的access密钥
secret-key	String	用户的secret密钥
user-caps	String	用户的权限
suspended	Boolean	是否将用户帐户挂起
max-buckets	Integer	该用户被允许创建的存储桶数量的上限

返回参数

名称	类型	描述
user	Container	列出用户信息
user_id	String	用户名
display_name	String	用于显示的用户名
suspended	Boolean	用户账号是否被挂起
max_buckets	Integer	该用户被允许创建的存储桶数量的上限
keys	Container	与该用户相关连的密钥列表
caps	Container	该用户的权限列表

REMOVE USER

删除一个已存在的用户。

请求语法

DELETE /{admin}/user?format=json HTTP/1.1

请求参数

名称	类型	描述
uid	String	要删除的用户的id
purge-data	Boolean	是否清理用户的数据，如果设置成True的话，属于这个用户的buckets和对象都会被删除。

返回参数

没有参数返回

CREATE KEY

创建一个密钥对。

请求语法

PUT /{admin}/user?key&format=json HTTP/1.1

请求参数

名称	类型	描述
uid	String	要创建的密钥对属于的用户id

返回参数

名称	类型	描述
access-key	String	access key
secret-key	String	secret key

REMOVE KEY

删除密钥对。

请求语法

DELETE /{admin}/user?key&format=json HTTP/1.1

请求参数

名称	类型	描述
access-key	String	access key

返回参数

没有参数返回

GET BUCKET INFO

获取Bucket的信息。如果只提供了uid，则返回用户所有的bucket信息。如果只有bucket参数，只有该bucket信息被返回。

请求语法

GET /{admin}/bucket?format=json HTTP/1.1

请求参数

名称	类型	描述
bucket	String	指定bucket
uid	String	指定用户信息
stats	Boolean	返回bucket统计

返回参数

名称	类型	描述
stats	Container	bucket 统计信息
buckets	Container	包含一个列表中的一个或多个bucket
bucket	String	单个bucket的信息
name	String	bucket的名称
pool	String	bucket存储池
ID	String	全局唯一的 bucket ID
marker	String	内部bucket标记
owner	String	所有者的用户ID

REMOVE BUCKET

删除一个已经存储的bucket

请求语法

DELETE /{admin}/bucket?format=json HTTP/1.1

请求参数

名称	类型	描述
bucket	String	指定要删除的bucket
purge-objects	Boolean	是否删除bucket下的对象

返回参数

无

REMOVE OBJECT

移除一个对象

请求语法

DELETE /{admin}/bucket?object&format=json HTTP/1.1

请求参数

名称	类型	描述
bucket	String	要删除对象所在的bucket
object	String	要删除的对象

返回参数

无