本页面介绍了如何获取 Cloud Storage 存储桶的元数据(不包括 IAM 政策和 ACL)的相关信息。
如需了解如何获取存储桶的 IAM 政策,请参阅查看存储桶的 IAM 政策。
所需的角色
为了获得获取 Cloud Storage 存储桶元数据所需的权限,请让您的管理员授予您存储桶的 Storage Admin (roles/storage.admin
) 角色。
此角色包含获取存储桶的元数据所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
storage.buckets.get
storage.buckets.list
- 仅当您计划使用 Google Cloud 控制台执行本页面上的任务时,才需要此权限。
如需了解如何授予存储桶的角色,请参阅将 IAM 与存储桶搭配使用。
显示存储桶的元数据
控制台
- 在 Google Cloud 控制台中,进入 Cloud Storage 存储桶页面。
在存储桶列表中,点击您要查看其元数据的存储桶的名称。
点击配置标签页以查看存储桶详细信息,例如包含的区域、存储类别、权限和复制类型。
命令行
使用 gcloud storage buckets describe
命令:
gcloud storage buckets describe gs://BUCKET_NAME
其中:
BUCKET_NAME
是您要查看其元数据的存储桶的名称,例如my-awesome-bucket
。
如果成功,响应类似于以下示例:
defaultEventBasedHold: false etag: CAE= iamConfiguration: bucketPolicyOnly: enabled: true ...
客户端库
C++
如需了解详情,请参阅 Cloud Storage C++ API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
C#
如需了解详情,请参阅 Cloud Storage C# API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
Go
如需了解详情,请参阅 Cloud Storage Go API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
Java
如需了解详情,请参阅 Cloud Storage Java API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
Node.js
如需了解详情,请参阅 Cloud Storage Node.js API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
PHP
如需了解详情,请参阅 Cloud Storage PHP API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
Python
如需了解详情,请参阅 Cloud Storage Python API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
Ruby
如需了解详情,请参阅 Cloud Storage Ruby API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
Terraform
您可以使用 Terraform 资源查看存储桶的元数据。
REST API
JSON API
安装并初始化 gcloud CLI,以便为
Authorization
标头生成访问令牌。使用
cURL
,通过GET
Bucket 请求调用 JSON API:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
其中
BUCKET_NAME
是相关存储桶的名称,例如my-bucket
。(可选)您可以使用
fields
查询字符串参数缩小元数据结果的范围。例如:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=FIELD1%2CFIELD2"
其中
FIELD#
是要包含在搜索结果中的存储桶属性。例如,projectNumber
和storageClass
。
响应如下例所示:
{ "projectNumber": "123456789012", "storageClass": "STANDARD" }
XML API
安装并初始化 gcloud CLI,以便为
Authorization
标头生成访问令牌。使用
cURL
通过GET
Bucket 请求调用 XML API:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?QUERY_PARAMETER"
其中:
BUCKET_NAME
是相关存储桶的名称,例如my-bucket
。QUERY_PARAMETER
是要返回的元数据字段。例如,storageClass
用于获取存储桶的存储类别。一次只能对 XML API 使用一个查询参数。如需查看 XML API 支持的元数据字段列表,请参阅GET
存储分区参考页面。
响应类似如下示例:
<StorageClass>STANDARD</StorageClass>
。
后续步骤
- 阅读存储桶元数据概览。
- 列出存储桶中的对象。
- 获取存储桶的大小。
- 获取对象元数据。
- 更改存储桶的默认存储类别。
自行试用
如果您是 Google Cloud 新手,请创建一个账号来评估 Cloud Storage 在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
免费试用 Cloud Storage