存储桶概述

最近更新时间: 2024-06-12 15:06:00

定义

存储桶(Bucket)是对象的载体,可理解为存放对象的“容器”。用户可以通过云控制台、API、SDK 等多种方式管理存储桶以及配置属性。例如,用户可以配置存储桶用于静态网站托管、配置存储桶的访问权限等。

命名规范

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

  • 系统生成数字串 APPID:由系统自动分配,无需用户输入,其在腾讯云金融专区具有唯一性。

  • 用户自定义字符串:由用户手动输入的一串字符,规范如下。

    自定义字符串的命名规范:

    • 仅支持小写英文字母和数字,即[a-z,0-9]、中划线“-”及其组合。

    • 用户自定义的字符串支持1 - 50个字符。

    • 存储桶命名不能以“-”开头或结尾。

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

  • mybucket123-1250000000

  • 1-newproject-1250000000

访问权限

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

公共权限

公共权限包括:私有读写、公有读私有写和公有读写。其访问权限可通过对象存储控制台上的存储桶的【权限管理】进行修改。

  • 私有读写

    只有该存储桶的创建者及有授权的账号才对该存储桶中的对象有读写权限,其他任何人对该存储桶中的对象都没有读写权限。存储桶访问权限默认为私有读写,推荐使用。

  • 公有读私有写

    任何人(包括匿名访问者)都对该存储桶中的对象有读权限,但只有存储桶创建者及有授权的账号才对该存储桶中的对象有写权限。

  • 公有读写

    任何人(包括匿名访问者)都对该存储桶中的对象有读权限和写权限,不推荐使用。

用户权限

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

相关说明

  • 对象存储以扁平化结构来存放对象,无文件夹概念。详情请参见 对象概述 文档中的“文件夹和目录”部分。

  • 同一用户账号下,可以创建多个存储桶,数量上限是200个(不区分地域),但是存储桶中的对象数量没有限制。

  • 同一个 APPID 下的存储桶名称是唯一的,不能重名。

  • 存储桶一旦创建后,将无法重命名。您只能删除后重新创建再命名存储桶。

  • 用户在创建存储桶时,请确认好所属地域,地域一旦设置后将无法修改。