PutBucket
更新时间：2025-08-18 15:50:16
此接口用于创建存储空间。执行此操作需要具备 wos:PutBucket 权限。
请求语法
PUT / HTTP/1.1
Host: BucketName.s3-cn-south-6.wcsapi.com
Date: GMT Date
Authorization: SignatureValue
URI请求参数
无
请求头部
仅需使用公共请求头
请求主体
请求主体格式为XML，具体要素如下表：
| 元素名称 | 元素描述 | 是否必填 |
|---|---|---|
| CreateBucketConfiguration | 定义空间配置列表。 类型：XML 子节点：Rule 父节点：空 |
是 |
| StorageClass | 指定空间类型，支持以下类型： Standard-标准、IA-低频、Archive-归档（默认为用户配置的存储类型）。 类型：XML 父节点：CreateBucketConfiguration |
否 |
响应语法
HTTP/1.1 200 OK
x-wos-request-id: request id
Content-Type: type
Date: date
Content-Length: length
Server: WS-web-server
响应头部
仅需使用公共响应头
响应元素
无
异常场景
| 异常原因 | HTTP状态码 | 错误码 |
|---|---|---|
| 空间名称不合法 | 400 | InvalidBucketName |
| 空间名称已存在 | 409 | BucketAlreadyExists |
| IAM校验失败 | 403 | AccessDenied |
| 空间类型不正确 | 400 | InvalidStorageClass |
| 所选区域的存储服务未开通等 | 403 | Standard storage service in XX not enabled. |
| 指定的存储类型不存在（区分大小写） | 400 | InvalidStorageClass |
示例
该示例将演示通过 header 添加 x-amz-storage-class 或 XML 指定 StorageClass 来定义存储类型。
PUT / HTTP/1.1
Host: BucketName.s3-cn-south-6.wcsapi.com
Date: GMT Date
Authorization: SignatureValue
x-amz-storage-class: Standard-标准，IA-低频, Archive-归档
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
<StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>
HTTP/1.1 200 OK
x-amz-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2017 03:15:40 GMT
Content-Length: 0
Connection: keep-alive
Server: WCS-Web-Server
Location: /bucketName
本篇文档内容对您是否有帮助？
有帮助
我要反馈