1.28.24 put-bucket

优质

小牛编辑

125浏览

2023-12-01

Create Bucket related api supported by FDS

Version: 1.0.0

/{bucketname}

PUT

Summary:

新建Bucket

Description:

创建Bucket的个数有Quota限制，具体信息参考FAQ

Parameters

Name	Located in	Description	Required	Schema
bucketname	path	bucket名字	Yes	string
authorization	header	认证信息，计算方式参考签名认证相关文档	Yes	string
Date	header	请求时间	Yes	string
x-xiaomi-meta-acl	header	指定Bucket权限，可选的值包括`PUBLIC_READ`, `PUBLIC_WRITE`, `PUBLIC_READ_OBJECTS`, `AUTHENTICATED_READ`, `AUTHENTICATED_WRITE`，`AUTHENTICATED_READ_OBJECTS`, 多个值之间用`,`分隔	No	string

Responses

Code	Description
200	请求成功
409	已经存在同名的Bucket

命令行示例

# 创建名叫fds-demo的bucket
curl -v -X 'PUT' 'cnbj0.fds.api.xiaomi.com/fds-demo' \
    -H 'content-type: application/json; charset=UTF-8' \
    -H 'authorization: Galaxy-V2 541xxxxx45:rvxxxxxY=' \
    -H 'date: Wed, 22 Feb 2017 07:30:01 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)
> PUT /fds-demo 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 541xxxxx45:rvxxxxxY=
> date: Wed, 22 Feb 2017 07:30:01 GMT
> Content-Length: 4
> 
* upload completely sent off: 4 out of 4 bytes
< HTTP/1.1 200 OK
* Server Tengine is not blacklisted
< Server: Tengine
< Date: Wed, 22 Feb 2017 07:30:34 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

# 创建Bucket同时，通过x-xiaomi-meta-acl头部设置bucket为所有人可读写
curl -v -X 'PUT' 'http://cnbj0.fds.api.xiaomi.com/fds-demo' \
    -H 'content-type: application/json; charset=UTF-8' \
    -H 'authorization: Galaxy-V2 54xxxxx45:9Gxxx9A=' \
    -H 'x-xiaomi-meta-acl: PUBLIC_READ, PUBLIC_WRITE' \
    -H 'date: Wed, 22 Feb 2017 09:04:36 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)
> PUT /fds-demo 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 Galaxy-V2 54xxxxx45:9Gxxx9A=
> x-xiaomi-meta-acl: PUBLIC_READ, PUBLIC_WRITE
> date: Wed, 22 Feb 2017 09:04:36 GMT
> Content-Length: 4
> 
* upload completely sent off: 4 out of 4 bytes
< HTTP/1.1 200 OK
* Server Tengine is not blacklisted
< Server: Tengine
< Date: Wed, 22 Feb 2017 09:05:42 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