此页面由 Cloud Translation API 翻译。

获取存储桶的存储布局

本页介绍了如何确定存储桶的存储布局。存储布局是指对象在存储桶（平面命名空间或分层命名空间）中的组织方式。布局对于与存储桶交互的应用非常重要，因为对象访问和操作方法因布局而异。存储布局还包含有关存储桶位置的信息。

通过使用 getStorageLayout API，您的应用可以根据存储桶是否使用分层命名空间来调整其行为，从而确保最佳兼容性，并根据存储桶配置利用适当的功能。

所需的角色

如需获得获取 Cloud Storage 存储桶存储布局所需的权限，请让您的管理员为您授予存储桶的 Storage Object User (roles/storage.objectUser) 角色。

该角色包含获取存储桶存储布局所需的 storage.objects.list 权限。

您也可以使用其他自定义角色或预定义角色来获取此权限。如需查看哪些角色与哪些权限相关联，请参阅适用于 Cloud Storage 的 IAM 角色。

如需了解如何授予存储桶的角色，请参阅将 IAM 与存储桶搭配使用。

获取存储桶的存储布局

命令行

使用带有 --format 标志的 gcloud alpha storage buckets describe 命令：

gcloud alpha storage buckets describe gs://BUCKET_NAME --raw --format="default(hierarchicalNamespace)"

其中：

BUCKET_NAME 是相关存储分区的名称，例如 my-bucket。

如果成功并且已启用分层命名空间，则响应类似于以下示例：

  hierarchicalNamespace:
    enabled: true

JSON API

安装并初始化 gcloud CLI，以便为 Authorization 标头生成访问令牌。

使用 cURL 通过 getStorageLayout 请求调用 JSON API：

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/storageLayout"

其中 BUCKET_NAME 是相关存储桶的名称。例如 my-bucket。

如果成功，则响应类似如下示例：

  {
      "kind": "storage#storageLayout",
      "bucket": "my-bucket",
      "location": "us-central1",
      "locationType": "region",
      "hierarchicalNamespace":{enabled: true},
  }

后续步骤

自行试用

如果您是 Google Cloud 新手，请创建一个账号来评估 Cloud Storage 在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

免费试用 Cloud Storage