本页面介绍了存储桶(Cloud Storage 中的一种资源)。如需大致了解 Cloud Storage 的工作原理,请参阅 Cloud Storage 产品概览。
存储桶
存储桶是用于存放数据的基本容器。您在 Cloud Storage 中存储的所有内容都必须包含在存储桶中。您可以使用存储桶来整理数据并控制数据的访问权限,但与目录和文件夹不同,您无法嵌套存储桶。
一个项目或位置可以拥有的存储桶数量不受限制。
- 但是,您创建或删除存储桶的速率存在限制。
创建存储桶时,您可以为其指定全局唯一名称以及存放存储桶及其内容的地理位置。
- 您无法更改现有存储桶的名称或位置。您可以创建一个具有所需属性的新存储桶,并将内容从旧存储桶移到新存储桶中。如需查看分步指南,请参阅移动和重命名存储桶。
- 价格(例如数据存储、数据处理和网络出站数据传输的费用)取决于存储桶的位置及其内部对象的存储类别等因素。如需了解详情,请参阅 Cloud Storage 价格。
- 您可以使用 Identity and Access Management (IAM) 来控制对各个存储桶的访问权限。
存储桶名称
您的存储桶名称必须符合以下要求:
- 存储桶名称只能包含小写字母、数字字符、短划线 (
-
)、下划线 (_
) 和句点 (.
)。不允许使用空格。含有点的名称必须进行验证。 - 存储桶名称必须以数字或字母开头和结尾。
- 存储桶名称必须包含 3 到 63 个字符。含句点的名称最多可以包含 222 个字符,但每个以句点分隔的组成部分不得超过 63 个字符。
- 存储桶名称不得以点分十进制的 IP 地址表示(例如 192.168.5.4)。
- 存储桶不得以“goog”前缀开头。
- 存储桶名称不得包含“google”或近似错拼变体(如“g00gle”)。
存储桶名称注意事项
存储桶名称都保存在所有 Cloud Storage 用户共享的单个命名空间中。也就是说:
每个存储桶名称都必须在全球范围内独一无二。
如果您尝试使用现有存储桶中已存在的名称创建存储桶,例如
example-bucket
,Cloud Storage 会返回一条错误消息。存储桶名称会公开显示。
不要在存储桶名称中使用用户 ID、电子邮件地址、项目名称、项目编号或任何个人身份信息 (PII),因为任何人都可以探测存储桶的存在。
删除存储桶后,任何人都可以将其名称重新用于新的存储桶。
删除的存储桶的名称通常最多只需数秒的时间即可再次使用;但是,请注意以下几点:
- 如果您删除包含该存储桶的项目(这实际上也会删除该存储桶),则该存储桶的名称可能在几周或更长时间内都不会释放。
- 如果在其他位置创建了同名的新存储桶,并且在删除旧存储桶后的 10 分钟内创建,则在这 10 分钟时间范围内向新存储桶发出的请求可能会失败并显示
404-Bucket Not Found
错误。 - 如果请求通过 XML API,则在删除旧存储桶后 10 分钟内尝试在新位置创建重复使用名称的存储桶可能会失败并显示
404-Bucket Not Found
错误。
您可以在 DNS 记录中使用存储桶名称作为
CNAME
或A
重定向的一部分。为此,您的存储桶名称应符合标准 DNS 命名惯例。也就是说,您的存储桶名称不应该使用下划线 (
_
),或者句点旁边不应该有其他句点或短划线。例如,..
、-.
和.-
是 DNS 名称中的无效字符组合。
存储桶名称示例
以下是有效存储桶名称的示例:
my-travel-maps
0f75d593-8e7b-4418-a5ba-cb2970f0b91e
test.example.com
(需要验证example.com
的所有权)
以下是无效存储桶名称的示例:
My-Travel-Maps
(包含大写字母)my_google_bucket
(包含“google”)test bucket
(包含空格)