PutBucket
PutBucket接口用于创建存储空间(Bucket)。
说明
- 此接口不支持匿名访问。
- 同一阿里云账号在同一地域(Region)内最多可创建100个Bucket。
- 每个地域都有对应的访问域名(Endpoint),地域与访问域名的对应关系参见访问域名和数据中心 。
请求语法
PUT / HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
x-oss-acl: Permission
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
<StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>
请求头
名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
x-oss-acl | 字符串 | 否 |
指定Bucket访问权限。 有效值:public-read-write、public-read、private 说明 如果创建的Bucket没有指定访问权限,则默认使用private权限。
|
请求元素
名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
StorageClass | 字符串 | 否 |
指定Bucket存储类型。 有效值:
说明 如果创建的Bucket没有指定存储类型,则默认使用Standard(标准存储)。
|
DataRedundancyType | 字符串 | 否 |
指定Bucket的数据容灾类型。 有效值:
|
示例
请求示例
PUT / HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2017 03:15:40 GMT
x-oss-acl: private
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:77Dvh5wQgIjWjwO/KyRt8dOP****
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
<StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>
返回示例
HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2017 03:15:40 GMT
Location: /oss-example
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
SDK
此接口所对应的各语言SDK如下:
错误码
错误码 | HTTP 状态码 | 描述 |
---|---|---|
InvalidBucketName | 400 | 创建的Bucket不符合命名规范。 |
AccessDenied | 403 |
|
TooManyBuckets | 400 | 创建的Bucket数量超过上限。 同一用户在同一 Region内最多可创建100个Bucket。 |
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论