存储分区命名准则

本页面概述了在 Cloud Storage 中创建存储分区时应遵循的命名准则。如需了解如何创建存储分区,请参阅存储分区创建指南

存储分区名称要求

您的存储分区名称必须符合以下要求:

  • 存储桶名称只能包含小写字母、数字字符、短划线 (-)、下划线 (_) 和句点 (.)。不允许使用空格。含有点的名称必须进行验证
  • 存储桶名称必须以数字或字母开头和结尾。
  • 存储桶名称必须包含 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 记录中使用存储分区名称作为 CNAMEA 重定向的一部分。

    为此,您的存储分区名称应符合标准 DNS 命名惯例。也就是说,您的存储分区名称不应该使用下划线 (_),或者句点旁边不应该有其他句点或短划线。例如,..-..- 不是 DNS 名称中的有效字符组合。

存储分区名称示例

以下是有效存储分区名称的示例:

  • my-travel-maps
  • 0f75d593-8e7b-4418-a5ba-cb2970f0b91e
  • test.example.com(需要验证 example.com 的所有权)

以下是无效存储分区名称的示例:

  • My-Travel-Maps(包含大写字母)
  • my_google_bucket(包含“google”)
  • test bucket(包含空格)

后续步骤