创建存储桶

最近更新时间:2025-11-05 17:27:02

我的收藏
将文件存放到对象存储(Cloud Object Storage,COS)时,您需要先创建一个存储桶用于存放对象,您可以通过控制台、工具、API 或 SDK 的方式来创建存储桶。关于存储桶的概念,请参见 存储桶概述,下面将为您详细介绍如何创建存储桶。
创建存储桶后,您可将对象上传至该存储桶,此外还可以为存储桶配置其他功能,例如 设置静态网站设置存储桶标签设置存储桶加密 等,更多配置指引请参见 控制台概述

限制说明

同个主账号下仅允许创建最多200个存储桶。
存储桶一旦创建成功,存储桶名称和所属地域不能修改。
同一主账号下所有存储桶名称唯一且不支持重命名。
存储桶名称仅支持小写英文字母和数字,即[a-z,0-9]、中划线“-”及其组合。存储桶名称的最大允许字符受到 地域简称APPID 的字符数影响,组成的完整请求域名字符数总计最多60个字符。例如请求域名123456789012345678901-1250000000.cos.ap-beijing.myqcloud.com总和为60个字符。
存储桶命名不能以“-”开头或结尾。

使用方法

使用对象存储控制台

2. 在左侧导航中,单击存储桶列表
3. 在存储桶列表页面,单击创建存储桶
4. 在弹出的创建存储桶对话框中,配置如下信息:
4.1 基本信息

所属地域:请选择与您业务(或用户数量)相对集中的物理区域所对应的 COS 地域,设置后不可修改。地域的更多信息请参见 地域和访问域名
名称:请输入自定义的存储桶名称。设置后不可修改。命名说明请参见存储桶的 命名规范
访问权限:存储桶默认提供三种访问权限:私有读写、公有读私有写和公有读写,设置后仍可修改。详细信息请参见 存储桶访问权限
请求域名:自动生成。创建完存储桶后,您可以使用该域名对存储桶进行访问。
多 AZ 特性:多 AZ 特性是存储桶的一个标识,当您确认开启多 AZ 配置后,您的数据将存放到同个地域的不同机房中,具有同城容灾的作用。目前该特性仅适用于部分地域,例如北京、上海、广州、中国香港、新加坡、上海金融地域,更多适用地域和特性介绍,可参见 多 AZ 特性概述 文档。
注意:
多 AZ 存储产生的存储容量费用比单 AZ 高,详情请参见各地域 产品定价
存储桶多 AZ 配置开启后,将无法进行修改。开启后,数据将以支持多 AZ 特性的存储类型(例如标准存储(多 AZ)、低频存储(多 AZ))存放在存储桶中,请谨慎配置。如果同时开启了版本控制,则版本控制的状态也同样无法修改。
您已创建的存储桶无法开启多 AZ 配置,仅新创建存储桶时可设置开启。
4.2 高级可选配置
说明:
该设置项为可选,您可按需进行设置。

版本控制:开启后,上传同名对象或者对对象进行增删改等操作将保存历史版本,便于您找回对象的历史版本。
注意:
如果同时开启了版本控制和多 AZ 特性,则版本控制的状态将无法修改,请谨慎配置。
元数据加速:该配置项当前仅对白名单用户开放,详情请参见 元数据加速功能概述
日志存储:为您记录跟存储桶操作相关的各种请求日志。
极智压缩:开启后,每次访问桶内指定格式的图片时,会在不改变图片格式的情况下进行实时压缩,大幅节省流量,详情请参见 极智压缩介绍
存储桶标签:存储桶标签作为管理存储桶的一个标识,您可以为存储桶设置标签,便于分组管理存储桶,详情请参见 设置存储桶标签
服务端加密:您可选择服务端加密方式,关于服务端加密的介绍和支持地域,请参见 服务端加密概述
4.3 确认配置
对存储桶的配置信息进行确认。如需修改,单击上一步即可。
5. 确认信息无误后,单击创建,即可创建存储桶。在存储桶列表界面中,您可以看到刚才已创建的存储桶。


说明:
存储桶列表仅会展示您数据湖计算 DLC 创建的桶,暂不支持进行配置。如您需配置,请跳转至 数据湖计算 DLC 控制台 进行操作。详情请参见 托管存储配置

使用 REST API/SDK

您可以直接使用 REST API 发起创建存储桶请求,详情请参见 PUT Bucket API 文档。
您可以直接调用 SDK 创建存储桶,详情请参见下列各语言 SDK 文档:

使用工具

您可以使用工具创建存储桶,例如 COSBrowserCOSCMDCOSCLI,更多工具介绍请参见 工具概览