PutBucket_对象存储_API文档-阿里云OpenAPI开发者门户

接口说明

同一阿里云账号在同一地域（Region）内最多支持创建 100 个 Bucket。
每个地域都有对应的访问域名（Endpoint）。关于地域与访问域名对应关系的更多信息，请参见访问域名和数据中心。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

oss:PutBucket	Create	Bucket acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}	acs:UserAgent acs:AccessId oss:BucketTag oss:x-oss-acl oss:x-oss-server-side-data-encryption oss:x-oss-server-side-encryption oss:x-oss-server-side-encryption-key-id oss:TLSVersion	oss:PutBucketAcl

请求语法

PUT / HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-acl: undefined
x-oss-resource-group-id: undefined
x-oss-bucket-tagging: string
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>CreateBucketConfiguration</CreateBucketConfiguration>

请求参数

字段名称	字段详情
bucketstring	Bucket 名称。存储空间的命名规范如下：展开详情示例值:examplebucket
x-oss-aclBucketACL	指定 Bucket 的访问权限 ACL。包含如下三种访问权限：展开详情枚举值:
x-oss-resource-group-idResourceGroupId	指定资源组 ID。展开详情
x-oss-bucket-taggingstring	指定 Bucket 标签，如 k1=v1&k2=v2。示例值:k1=v1&k2=v2
bodyobject	存储创建 Bucket 信息的容器。

变更历史

	变更时间	变更内容概要	操作
	2024-12-05	变更请求参数x-oss-bucket-tagging
	2024-12-04	新增请求参数x-oss-bucket-tagging
	2024-11-28	变更请求参数x-oss-acl 变更请求参数x-oss-resource-group-id 变更请求参数body
	2024-02-21	新增请求参数body

PutBucket_对象存储_API文档

接口说明

流控信息

授权信息

请求语法

请求参数

变更历史

相关示例