创建存储桶

最近更新时间:2025-07-31 15:50:42

我的收藏
将文件存放到对象存储(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 控制台 进行操作。详情请参见 托管存储配置

使用工具

您可以使用工具创建存储桶,例如 COSBrowser 工具、COSCMD 工具等,详情请参见 工具概览

使用 REST API

您可以直接使用 REST API 发起创建存储桶请求,详情请参见 PUT Bucket API 文档。

使用 SDK

您可以直接调用 SDK 创建存储桶,详情请参见下列各语言 SDK 文档:
C++ SDK
Java SDK