tencent cloud

对象存储

动态与公告
产品动态
产品公告
产品简介
产品概述
功能概览
应用场景
产品优势
基本概念
地域和访问域名
规格与限制
产品计费
计费概述
计费方式
计费项
免费额度
计费示例
查看和下载账单
欠费说明
常见问题
快速入门
控制台快速入门
COSBrowser 快速入门
用户指南
创建请求
存储桶
对象
数据管理
批量处理
全球加速
监控与告警
运维中心
数据处理
内容审核
智能工具箱
数据工作流
应用集成
工具指南
工具概览
环境安装与配置
COSBrowser 工具
COSCLI 工具
COSCMD 工具
COS Migration 工具
FTP Server 工具
Hadoop 工具
COSDistCp 工具
HDFS TO COS 工具
GooseFS-Lite 工具
在线辅助工具
自助诊断工具
实践教程
概览
访问控制与权限管理
性能优化
使用 AWS S3 SDK 访问 COS
数据容灾备份
域名管理实践
图片处理实践
COS 音视频播放器实践
工作流实践
数据直传
内容审核实践
数据安全
数据校验
大数据实践
COS 成本优化解决方案
在第三方应用中使用 COS
迁移指南
本地数据迁移至 COS
第三方云存储数据迁移至 COS
以 URL 作为源地址的数据迁移至 COS
COS 之间数据迁移
Hadoop 文件系统与 COS 之间的数据迁移
数据湖存储
云原生数据湖
元数据加速
数据加速器 GooseFS
数据处理
数据处理概述
图片处理
媒体处理
内容审核
文件处理
文档处理
故障处理
获取 RequestId 操作指引
通过外网上传文件至 COS 缓慢
访问 COS 时返回403错误码
资源访问异常
POST Object 常见异常
API 文档
简介
公共请求头部
公共响应头部
错误码
请求签名
操作列表
Service 接口
Bucket 接口
Object 接口
批量处理接口
数据处理接口
任务与工作流
内容审核接口
云查毒接口
SDK 文档
SDK 概览
准备工作
Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Flutter SDK
Go SDK
iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
React Native SDK
小程序 SDK
错误码
鸿蒙(Harmony) SDK
终端 SDK 质量优化
安全与合规
数据容灾
数据安全
访问管理
常见问题
热门问题
一般性问题
计费计量问题
域名合规问题
存储桶配置问题
域名和 CDN 问题
文件操作问题
日志监控问题
权限管理问题
数据处理问题
数据安全问题
预签名 URL 问题
SDK 类问题
工具类问题
API 类问题
服务协议
Service Level Agreement
隐私政策
数据处理和安全协议
联系我们
词汇表

存储桶概述

PDF
聚焦模式
字号
最后更新时间: 2025-10-11 17:41:47

简介

存储桶(Bucket)是对象的载体,可理解为存放对象的“容器”,且该“容器”无容量上限。对象以扁平化结构存放在存储桶中,无文件夹和目录的概念,用户可选择将对象存放到单个或多个存储桶中。
说明:
每个存储桶可容纳任意数量的对象,但同个主账号下存储桶数量最多仅能创建200个。

存储桶命名规范

存储桶的命名由存储桶名称(BucketName)和 APPID 两部分组成,两者以中划线“-”相连。存储桶的命名格式为 <BucketName-APPID>
存储桶名称(BucketName):由用户手动输入的一串字符,命名规范如下:
仅支持小写英文字母和数字,即[a-z, 0-9]、中划线“-”及其组合。
存储桶名称的最大允许字符受到 地域简称APPID 的字符数影响,组成的完整请求域名字符数总计最多60个字符。例如请求域名 123456789012345678901-1250000000.cos.ap-beijing.myqcloud.com 总和为60个字符。
存储桶命名不能以“-”开头或结尾。
APPID:是您在成功申请腾讯云账户后所得到的账号,由系统自动分配,具有固定性和全局唯一性,可在 账号信息 中查看。通过控制台创建存储桶时,无需用户输入,而在使用工具、API、SDK 时则需要指定 APPID。

命名示例

例如存储桶 examplebucket-1250000000,其中 examplebucket 为 BucketName(由用户手动输入的一串字符);1250000000为 APPID(用户申请腾讯云账号时,由系统自动分配)。
以下是有效的存储桶命名示例:
examplebucket-1-1250000000
mybucket123-1250000000
1-newproject-1250000000

存储桶所属地域

地域(Region)指对象存储 COS 的数据中心所在的地域。对象存储允许用户在不同地域上创建存储桶,您可以选择在离您业务最近的地域上创建存储桶,以满足低延迟、低成本以及合规性要求。
例如,当您的业务分布在华南地区,那么选择在广州地域创建存储桶可以提高对象的上传、下载速度。更多地域信息,请参见 地域和访问域名 文档。
注意:
地域是在创建存储桶时必须指定的,一旦指定之后将不允许更改。该存储桶下所有的对象都存储在对应的数据中心,目前不支持对象级别的地域设置。

存储桶权限类别

存储桶默认提供两种权限类型:公共权限和用户权限。
说明:
当存储桶为私有读写或对指定账号授予用户权限,请求对象时需携带签名用于身份验证,关于签名说明,请参见 请求签名
当存储桶为公有读私有写或公有读写时,请求对象时无需携带签名,匿名用户可直接通过链接访问对象,您的数据会存在泄露风险,请谨慎设置。

公共权限

公共权限包括:私有读写、公有读私有写和公有读写。其访问权限可通过对象存储控制台上的存储桶的权限管理进行修改,更多访问权限的说明,请参见 访问控制基本概念
私有读写
只有该存储桶的创建者及有授权的账号才对该存储桶中的对象有读写权限,其他任何人对该存储桶中的对象都没有读写权限。存储桶访问权限默认为私有读写,推荐使用。
公有读私有写
任何人(包括匿名访问者)都对该存储桶中的对象有读权限,但只有存储桶创建者及有授权的账号才对该存储桶中的对象有写权限。
公有读写
任何人(包括匿名访问者)都对该存储桶中的对象有读权限和写权限,不推荐使用。

用户权限

主账号默认拥有存储桶的所有权限(即完全控制)。另外 COS 支持添加子账号有数据读取、数据写入、权限读取、权限写入,甚至完全控制的最高权限。

使用方法

通过控制台查看存储桶概览

说明:
如果子账号无法查看概览数据,请联系主账号管理员赋予 GetBucket 权限。
1. 登录 对象存储控制台,在左侧导航栏中,单击存储桶列表
2. 找到您需要查看概览的存储桶,单击其存储桶名称。
3. 在跳转界面中单击左上方的概览,进入当前存储桶的概览页面。

用量概览

用量概览包含当前存储桶中的对象数量、文件碎片数量、存储量、流量及请求数。
注意:
用量概览并非实时数据,约有 2 小时延迟。 该数据仅作为监控数据以供参考,如需查看准确的计费计量数据,可到 费用中心 中下载用量明细进行查看。
对象数量/文件碎片数量:支持查看各种存储类型下的对象数量及文件碎片数量。
存储量:支持查看各种存储类型的存储用量,当前支持查看的存储类型为标准存储、标准存储(多AZ)、低频存储、低频存储(多AZ)、归档存储、归档存储(多 AZ)、深度归档存储、智能分层存储、智能分层存储(多 AZ)。
注意:
标准存储(多 AZ)、低频存储(多 AZ)、归档存储(多 AZ)、深度归档存储、智能分层存储、智能分层存储(多 AZ)仅支持部分地域的存储桶,具体支持地域可参见 存储类型介绍
流量:支持查看各种存储类型下的本月总流量、本月外网下行流量、本月内网下行流量、本月 CDN 回源流量、本月全球加速下行流量,当前支持查看的存储类型为标准存储、标准存储(多 AZ)、低频存储、低频存储(多 AZ)、智能分层存储、智能分层存储(多 AZ)。
请求数:支持查看各种存储类型下的本月总请求数、本月读请求数、本月写请求数。
取回量:支持查看低频、归档类型的数据取回量。

基本信息

基本信息包含存储桶名称、地域、创建时间及访问权限。
存储桶名称:由自定义名称与 APPID 组成,命名说明请参见 命名规范
所属地域:存储桶所在的地域。
创建时间:存储桶的创建时间。
访问权限:当前存储桶的访问权限,有关权限的说明请参见 存储桶访问权限

域名信息

域名信息展示了当前存储桶配置的所有域名。
访问域名:用于访问 COS 存储桶内数据的默认域名,用户在创建存储桶时,由系统根据存储桶名称和地域自动生成。
注意:
默认域名存在安全风险,可能暴露敏感信息,建议您为存储桶配置自定义域名。详情请参见 存储桶切换自定义域名
默认 CDN 加速域名:经由 CDN 加速节点的域名,系统默认生成。如果用户此前开通过,则显示该项。详情可参见 默认 CDN 加速域名
自定义 CDN 加速域名:用户可以为存储桶,绑定已备案的自定义域名至腾讯云国内 CDN 加速平台,通过自定义域名访问存储桶中的对象。
自定义源站域名:用户可以将已备案的自定义域名,绑定至当前存储桶,通过自定义域名访问桶内对象。
全球加速域名:开启全球加速功能后,系统默认生成全球加速域名,用户可通过该域名将数据加速上传至存储桶,有关全球加速的说明请参见 全球加速概述
静态网站域名:对于已配置静态网站的存储桶,可以通过静态网站域名访问存储桶中的数据。有关设置静态网站的说明请参见 设置静态网站

存储桶配置

存储桶配置展示了存储桶相关配置的状态信息。
多AZ特性:多AZ存储架构能够为用户数据提供数据中心级别的容灾能力。详情请参见 多 AZ 特性概述
元数据加速:由腾讯云对象存储(Cloud Object Storage,COS)服务提供的高性能文件系统功能。详情请参见 元数据加速功能概述
跨域访问:跨域访问即通过 HTTP 请求,从一个域去请求另一个域的资源,只要协议、域名、端口有任何一个不相同,都会被当作是不同的域。详情请参见 设置跨域访问
版本控制:启用存储桶版本控制功能,COS 将保留同名对象的多个版本,这有助于恢复被用户误删或应用程序故障而丢失的数据。详情请参见 设置版本控制
回源:当您请求的对象在存储桶中不存在或者需要对特定的请求进行重定向时,您可以通过回源规则从 COS 访问到对应的数据。详情请参见 设置回源
存储桶加密:通过设置存储桶加密,可对新上传至该存储桶的所有对象默认以指定的加密方式进行加密。详情请参见 存储桶加密概述
清单:清单功能可以实现定期每天、每周或每月为您的存储桶输出一份关于对象属性、配置详情等清单列表。详情请参见 设置清单
防盗链:设置防盗链可以避免恶意程序使用资源 URL 盗刷公网流量或使用恶意手法盗用资源。详情请参见 设置防盗链
生命周期:配置生命周期规则,COS 将按照您设定的规则对指定对象在指定的时间内自动进行存储类型转换或删除。详情请参见 设置生命周期
存储桶复制:启用存储桶复制功能后,您可以将源存储桶中的增量对象进行自动、异步地复制到另一地域的目标存储桶中。详情请参见 设置存储桶复制
日志管理:使用日志功能,COS 可以为您记录跟存储桶操作相关的各种请求日志,帮助您更好地管理和使用存储桶。详情请参见 设置日志存储
标签:存储桶标签可以作为管理存储桶的一个标识,便于用户对存储桶进行分组管理。详情请参见 设置存储桶标签

告警配置

您可以通过配置存储桶告警满足日常监控的需求。
当前报警:展示当前持续进行中的报警数量。
已配置告警策略:展示已配置的告警策略数量。

其他配置

除了以上 COS 相关配置,COS 还集成了数据万象功能,例如内容审核、数据处理等,更多介绍请参见 内容审核数据处理概述

相关说明

对象存储以扁平化结构来存放对象,无文件夹概念。详情请参见 对象概述 文档中的“文件夹和目录”部分。
每个主账号(即同一个 APPID)可以创建多个存储桶,数量上限是200个(不区分地域),但是存储桶中的对象数量没有限制。
在腾讯云中,同一个 APPID 下的存储桶名称是全局唯一的,不能重名。
存储桶一旦创建后,将无法重命名。您只能删除后重新创建再命名存储桶。
用户在创建存储桶时,请确认好所属地域,地域一旦设置后将无法修改。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈