股票代码: 836286    股票简称: 易云股份
官方微信

扫一扫关注易云捷讯官方微信

备案 |       管理控制台
API 手册
 

创建Bucket

创建一个新Bucket。创建时必须提供有效的用户 ID 及对应的 Access Key 进行身份验证。匿名用户无法创建新Bucket。

限制条件

• Bucket名称必须是全局惟一;

• Bucket名称的长度在 3 ~ 255 之间(包括 3 和 255 );

• Bucket名称的必须以数字或者字母开头;

• Bucket名称只能由数字、字母、“-”、“.”组成。

创建Bucket时可以设置Bucket的访问控制权限,访问控制权限通过请求消息头进行。

创建Bucket可以指定Bucket所属的数据中心以及数据存放规则,通过请求消息元素 CreateBucketConfiguration 进行配置。

请求消息

请求格式

PUT / HTTP/1.1

Host: {BucketName}.eos.eayun.com

x-amz-acl: public-read-write

Authorization: AWS {access-key}:{hash-of-header-and-secret}

 

<CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"><LocationConstraint>BucketRegion[:BucketPlaceMentRule]</LocationConstraint></CreateBucketConfiguration>

请求消息头

公共请求消息头

请参考公共消息头

额外的请求消息头:

使用请求消息头设置Bucket的标准访问控制策略

消息头名称

描述

是否必选

x-amz-acl

标准访问控制策略。

类型:字符串

有效值: private , public-read , public-read-write , authenticated-read 

默认值:private

对于上述的4中标准ACL的解释:

标准 ACL

描述

private

所有者将获得 FULL_CONTROL。其他人没有访问权限(默认)。

public-read

所有者将获得 FULL_CONTROL。其他人将获得 READ 访问权限。

public-read-write

所有者将获得 FULL_CONTROL。其他人将获得 READ 和 WRITE 访问权限。通常不建议在存储Bucket上授予该权限。

authenticated-read

所有者将获得 FULL_CONTROL。通过认证的用户将获得 READ 访问权限。

请求消息参数

该请求无请求消息参数

请求消息元素

元素名称

描述

是否必选

CreateBucketConfiguration

请求消息元素的最上层 XML 容器,包含 LocationConstraint 元素。

类型:XML 容器

上层数据结构:无

LocationConstraint

指定Bucket所属的数据中心以及数据数储策略。

格式:数据中心[:数据存储策略],数据存储策略可以不指定。

上层数据结构:CreateBucketConfiguration

响应消息

响应格式

HTTP/1.1 {StatusCode}

Date: {Date}

Server: {Server}

Connection: close

Content-Type: application/xml

响应消息头

请参考公共响应消息头

响应消息元素

下面 2 种情况下:

• Bucket名称全局惟一;

• Bucket名称已经存在,但发起请求的用户是该Bucket的所有者 创建Bucket的操作成动,无任何响应消息元素。

错误响应消息

如果Bucket名称已经被其它用户使用,则创建Bucket操作失败,错误响应如下:

HTTP 状态码

描述

错误码

409

请求创建的Bucket名称已经存在,而且为其它用户所有,选择一个不同的名字重新尝试。

BucketAlreadyExists

错误响应消息格式

HTTP/1.1 409

Date: {Date}

Server: {Server}

Connection: close

Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?><Error><Code>BucketAlreadyExists</Code></Error>

示例

请求示例

PUT /new-bucket HTTP/1.1

Host: testbucket.eos.eayun.com

Content-Length: 164

Accept-Encoding: gzip, deflate

x-amz-grant-read: id=zc-test-2

Accept: */*

User-Agent: python-requests/2.8.1

Connection: keep-alive

date: Mon, 14 Dec 2015 04:22:10 GMT

Authorization: AWS BDNGQWVO6BCMTF5YTKKF:Ik5IWxif6+7iJRJ9MsKXCkufTGI=

 

<CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

  <LocationConstraint>

    chengdu

  </LocationConstraint>

</CreateBucketConfiguration>

响应示例

HTTP/1.1 200

Transfer-Encoding: chunked

Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.1e-fips

Connection: close

Cache-control: private

Date: Mon, 14 Dec 2015 04:22:17 GMT

Content-Type: application/xml


© 2011-2017 易云捷讯科技(北京)股份有限公司, 版权所有 | © 2011-2017 Eayun,Inc. All rights reserved.

京公网安备 11010802022475号 | 京ICP备 11028869号

业务咨询:400-606-6396