1. Put Bucket
1.1. 描述
创建一个 Bucket,不支持匿名访问创建。创建后,该bucket的对象内容将放在对应的地区,详细请参考可用区域。
创建 Bucket 时,如果没有指定访问权限,则默认使用私有读写(private)权限。Bucket名称必须唯一,并且开始和结束必须是小写字母,可以包含“-”。
1.2. 请求地址
PUT /{bucket}
1.3. 请求头
Name | Type | Description | Required |
---|---|---|---|
x-amz-acl | String | 定义Bucket访问权限,有效值:private和public-read,默认值:private | 否 |
1.4. 请求参数
Name | Type | Description | Required |
---|---|---|---|
projectId | String | 创建bucket所在project的projectId | 是 |
1.5. 请求示例
PUT /bucket123 HTTP/1.1 Date: Thu, 15 Nov 2018 13:27:48 GMT Nonce: 5e72e157-f4e3-4180-9062-7c7127939faa Authorization: YCS1-HMAC-SHA1 Credential=5adb2538-9333-4024-b757-e095fc609a84, SignedHeaders=date;nonce;version, Signature=5KmNSmZ7/vlWNti0cgNpJFiQNMY= x-amz-acl: public-read Version: 2018-10-30 |
{
"projectId":"2c9481226684eb130166854b595e0035"
}
1.6. 返回结果
1.6.1. 返回正确结果示例
{
"id" : "61281cdb-9fd1-4fc3-b443-ee547de9c8e7",
"name" : "bucket123",
"owner" : "2c94808965a74de00165a94b16cf0033",
"projectId" : "2c9481226684eb130166854b595e0035",
"created" : 1542288407586,
"storeBytes" : 0,
"fileCount" : 0,
"cannedAcl" : "public-read"
}
1.7. 错误码
该接口没有特殊错误码,错误码可以参考公共错误码