控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

存储桶概述

最近更新时间:2020-12-02 10:49:44

简介

存储桶(Bucket)是对象的载体,可理解为存放对象的“容器”,且该“容器”无容量上限。对象以扁平化结构存放在存储桶中,无文件夹和目录的概念,用户可选择将对象存放到单个或多个存储桶中。

说明:

每个存储桶可容纳任意数量的对象,但同个主账号下存储桶数量最多仅能创建200个。

存储桶命名规范

存储桶的命名由存储桶名称(BucketName)和 APPID 两部分组成,两者以中划线“-”相连。例如examplebucket-1250000000,其中 examplebucket 为用户自定义字符串,1250000000 为系统生成数字串(APPID)。在 API、SDK 的示例中,存储桶的命名格式为<bucketname-appid>

  • 存储桶名称(BucketName):由用户手动输入的一串字符,命名规范如下:
    • 仅支持小写英文字母和数字,即[a-z,0-9]、中划线“-”及其组合。
    • 用户自定义的字符串支持1 - 50个字符。
    • 存储桶命名不能以“-”开头或结尾。
  • APPID:是您在成功申请腾讯云账户后所得到的账号,由系统自动分配,具有固定性和唯一性,可在 账号信息 中查看。通过控制台创建存储桶时,无需用户输入,而在使用工具、API、SDK 时则需要指定 APPID。

以下是有效的存储桶命名示例:

  • examplebucket-1-1250000000
  • mybucket123-1250000000
  • 1-newproject-1250000000

存储桶所属地域

地域(Region)指对象存储 COS 的数据中心所在的地域。对象存储允许用户在不同地域上创建存储桶,您可以选择在离您业务最近的地域上创建存储桶,以满足低延迟、低成本以及合规性要求。

例如,当您的业务分布在华南地区,那么选择在广州地域创建存储桶可以提高对象的上传、下载速度。更多地域信息,请参见 地域和访问域名 文档。

注意:

地域是在创建存储桶时必须指定的,一旦指定之后将不允许更改。该存储桶下所有的对象都存储在对应的数据中心,目前不支持对象级别的地域设置。

权限类别

存储桶默认提供两种权限类型:公共权限和用户权限。

公共权限

公共权限包括:私有读写、公有读私有写和公有读写。其访问权限可通过对象存储控制台上的存储桶的【权限管理】进行修改,更多访问权限的说明,请参见 访问控制基本概念

  • 私有读写
    只有该存储桶的创建者及有授权的账号才对该存储桶中的对象有读写权限,其他任何人对该存储桶中的对象都没有读写权限。存储桶访问权限默认为私有读写,推荐使用。
  • 公有读私有写
    任何人(包括匿名访问者)都对该存储桶中的对象有读权限,但只有存储桶创建者及有授权的账号才对该存储桶中的对象有写权限。
  • 公有读写
    任何人(包括匿名访问者)都对该存储桶中的对象有读权限和写权限,不推荐使用。

用户权限

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

以下视频为您详细介绍存储桶权限:

存储桶操作

用户可以通过腾讯云控制台、工具、API、SDK 等多种方式管理存储桶以及配置属性。例如,配置存储桶用于静态网站托管、配置存储桶的访问权限等。下面列举了部分功能配置指引,有关存储桶功能配置的更多信息,请参见 存储桶概述

相关说明

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

目录