全部文档
当前文档
最近更新时间：2025-06-27 11:43:49
此操作将为用户创建一个新的存储空间（Bucket）用来存放对象。每个存储空间会拥有独立的配置属性，包括访问权限、桶类型、存储类型等。
1. 用户需要是已注册用户，并且使用有效的Access Key ID验证来发送请求。任何匿名请求都不会被允许创建存储空间。
2. 用户将成为其创建空间的拥有者，拥有者有全部操作权限。
3. 用户创建的Bucket总数不能超过100个。
4. 存储空间创建后，不支持对名称、地域、桶类型、存储类型进行修改。
5. 存储空间具有弹性容量扩展，无需对容量进行提前购买。
如果使用KS3管理控制台操作，则在所有区域中存储空间名称都必须符合DNS标准。符合DNS标准的存储空间名称使客户能够受益于新功能和操作改进，并支持对存储空间进行虚拟托管类型访问。
符合DNS标准的存储空间名称规则如下：
1. 存储空间名称在KS3范围内必须全局唯一。
2. 存储空间名称的长度必须为至少3个字符，且不能超过63个字符。
3. 存储空间名称只能包含小写字母、数字和连字符（-），且不能以连字符（-）开头或结尾。
以下示例是有效存储空间名称：
1. my-ksbucket
2. myksbucket123
3. 123myksbucket
以下示例是无效存储空间名称：
1. -myksbucket 名称不能以连字符 (-) 开始
2. myksbucket- 名称不能以连字符 (-) 结束
3. my.ksbucket 名称不能包含句点(.)
用户可以使用参数projectId将存储空间分配到不同的项目组中，未指派项目信息的存储空间将被分配到默认项目组中。
当用户使用此接口创建空间时，用户可以授予其他用户或者群组关于此空间的操作权限。以下列出了通过请求头部实现的两种授权方式。
使用x-kss-acl请求头部，指定一个预定义的ACL。该请求头部可为所有用户设置访问权限，一般需要设置为私有类型。
使用x-kss-grant-read,x-kss-grant-write,x-kss-grant-full-control请求头部，可为指定用户设置访问权限。
用户可以通过x-kss-bucket-type请求头指定Bucket存储类型。
NORMAL表示标准存储类型Bucket，若上传时，不指定Object存储类型则默认为标准存储类型。
IA表示低频存储Bucket，若上传时，不指定Object存储类型则默认为低频存储类型。
ARCHIVE表示归档存储Bucket，若上传时，不指定Object存储类型则默认为归档存储类型。
用户可以通过x-kss-bucket-visit-type请求头指定Bucket访问类型。
NORMAL表示标准存储类型Bucket，该桶类型适合源站等对数据频繁访问的场景。
FREQUENTLIST表示高频枚举类型Bucket，该桶类型适合AI训练、数据清洗等对Get Bucket请求较多的场景。
用户可以通过x-kss-server-side-encryption请求头开启Bucket服务端加密。
AES256表示桶开启服务端加密，上传对象默认桶的加密配置，但对象仍可以自定义加密配置，且优先级高于桶加密。
如果不指定请求头，则表示不开启桶服务端加密。
用户可以使用请求参数DataRedundancyType指定Bucket的冗余类型。
LRS表示指定Bucket是本地冗余类型的桶。
ZRS表示指定Bucket是同城冗余类型的桶。
PUT / HTTP/1.1
Host: {BucketName}.{endpoint}
Content-Length: {length}
Date: {date}
Authorization: {SignatureValue}
<CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<LocationConstraint>{BucketRegion}</LocationConstraint>
<DataRedundancyType>{RedundancyType}</DataRedundancyType>
</CreateBucketConfiguration>PUT /?projectId={projectId} HTTP/1.1
Host: {BucketName}.{endpoint}
Content-Length: {length}
Date: {date}
Authorization: {SignatureValue}
<CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<LocationConstraint>{BucketRegion}</LocationConstraint>
<DataRedundancyType>{RedundancyType}</DataRedundancyType>
</CreateBucketConfiguration>该接口不使用请求参数。
该接口除了可以使用常用请求头部外，还可以设置以下请求头。
用户可以通过以下请求头指定Bucket存储类型：
名称 | 描述 | 是否必选 |
|---|---|---|
x-kss-bucket-type | 用于指定Bucket类型。
NORMAL表示标准存储类型，IA表示低频存储类型，ARCHIVE表示归档存储类型。 | 否 |
用户可以通过以下请求头为Bucket设置一个预定义的ACL：
名称 | 描述 | 是否必选 |
|---|---|---|
x-kss-acl | 用于为存储空间设置预定义权限。
private表示私密，public-read表示公开读，public-read-write表示公开读写。 | 否 |
用户可以使用以下请求头为指定用户设置访问权限：
名称 | 描述 | 是否必选 |
|---|---|---|
x-kss-grant-read | 为若干用户授予READ（只读）权限。
| 否 |
x-kss-grant-write | 为若干用户授予WRITE（只写）权限。
| 否 |
x-kss-grant-full-control | 为若干用户授予FULL_CONTROL（读写）权限。
| 否 |
以上Header值的值为以逗号","分割的授权列表。每个授权信息的格式为type=value，当前type支持被授权者的用户id。
例如，要给id为1234578和3344211的两个用户授予WRITE权限：
x-kss-grant-write: id=“1234578”,id=“3344211”用户可以使用以下请求头为Bucket设置访问类型：
名称 | 描述 | 是否必选 |
x-kss-bucket-visit-type | 创建桶时设置桶的访问类型。
1. NORMAL表示标准类型Bucket，该桶类型适合源站等对数据频繁访问的场景。 2. FREQUENTLIST表示高频枚举类型Bucket，该桶类型适合AI训练、数据清洗等对GET Bucket（LIST Objects）请求较多的场景。 | 否 |
高频枚举桶主要针对GET Bucket（LIST Objects）QPS需求较高的场景（单桶LIST需求大于1000），注意如果使用高频枚举桶，单桶PUT+GET的QPS能力为5000。
用户可以使用以下请求头为Bucket开启服务端加密：
名称 | 描述 | 是否必选 |
x-kss-server-side-encryption | 创建桶时开启置桶的服务端加密。
| 否 |
用户可以通过请求体设置Bucket的所属Region，以及设置Bucket的冗余类型。请求参数如下所示：
名称 | 描述 | 是否必选 |
|---|---|---|
CreateBucketConfiguration | 用户桶配置信息的容器。
| 否 |
LocationConstraint | 指定用户空间将要被创建的区域。
| 否 |
DataRedundancyType | 指定桶的冗余类型，
当不设置冗余类型时，默认为该Bucket的冗余类型为本地冗余。 | 否 |
该接口除了返回公共响应头外，还返回以下响应头：
名称 | 描述 |
|---|---|
x-kss-data-redundancy-type | 表示桶的冗余类型，有效值：
|
该接口不返回响应内容。
PUT / HTTP/1.1
Host: {BucketName}.{endpoint}
Content-Length: {length}
Date: {date}
Authorization: {SignatureValue}
<CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<LocationConstraint>BEIJING</LocationConstraint>
</CreateBucketConfiguration>HTTP/1.1 200 OK
Date: Fri, 26 Dec 2014 06:30:04 GMT
Content-Length: 0
Connection: keep-alive
x-kss-request-id: f86r2t80l******kf4kmib
x-kss-data-redundancy-type：LRS
Server: KS3PUT /?projectId=111 HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Content-Length: 0
Date: Fri, 26 Dec 2014 06:30:04 GMT
Authorization: authorization string
<CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<LocationConstraint>BEIJING</LocationConstraint>
</CreateBucketConfiguration>HTTP/1.1 200 OK
Date: Fri, 26 Dec 2014 06:30:04 GMT
Content-Length: 0
Connection: keep-alive
x-kss-request-id: f86r2t80l******kf4kmib
x-kss-data-redundancy-type：LRS
Server: KS3PUT / HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
x-kss-bucket-visit-type：FREQUENTLIST
Content-Length: 0
Date: Fri, 26 Dec 2014 06:30:04 GMT
Authorization: authorization string
<CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<LocationConstraint>BEIJING</LocationConstraint>
</CreateBucketConfiguration>HTTP/1.1 200 OK
Date: Fri, 26 Dec 2014 06:30:04 GMT
Content-Length: 0
Connection: keep-alive
x-kss-request-id: f86r2t80l******kf4kmib
x-kss-data-redundancy-type：LRS
Server: KS3PUT / HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
x-kss-bucket-visit-type：FREQUENTLIST
Content-Length: 0
Date: Fri, 26 Dec 2014 06:30:04 GMT
Authorization: authorization string
<CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<LocationConstraint>BEIJING</LocationConstraint>
<DataRedundancyType>ZRS</DataRedundancyType>
</CreateBucketConfiguration>HTTP/1.1 200 OK
Date: Fri, 26 Dec 2014 06:30:04 GMT
Content-Length: 0
Connection: keep-alive
x-kss-request-id: f86r2t80l******kf4kmib
x-kss-data-redundancy-type：ZRS
Server: KS3HTTP状态码 | 错误码 | 描述 |
400 | InvalidBucketName | 定义的Bucket名称不符合命名规范。 |
400 | TooManyBuckets | 创建的Bucket数量超过上限。同一用户创建的Bucket总数不能超过100个。 |
400 | InvalidBucketVisitType | 无效的桶访问类型。 |
纯净模式