本页面介绍了如何获取 Cloud Storage 存储桶的元数据(不包括 IAM 政策和 ACL)的相关信息。
如需了解如何获取存储桶的 IAM 政策,请参阅查看存储桶的 IAM 政策。
所需的角色
为了获得获取 Cloud Storage 存储桶元数据所需的权限,请让您的管理员授予您存储桶的 Storage Admin (roles/storage.admin
) 角色。
此角色包含获取存储桶的元数据所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
storage.buckets.get
storage.buckets.list
- 仅当您计划使用 Trusted Cloud 控制台执行本页面上的任务时,才需要此权限。
如需了解如何授予存储桶的角色,请参阅将 IAM 与存储桶搭配使用。
显示存储桶的元数据
控制台
- 在 Trusted 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 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为客户端库设置身份验证。
在运行代码示例之前,请将 GOOGLE_CLOUD_UNIVERSE_DOMAIN
环境变量设置为 s3nsapis.fr
。
C#
如需了解详情,请参阅 Cloud Storage C# API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为客户端库设置身份验证。
在运行代码示例之前,请将 GOOGLE_CLOUD_UNIVERSE_DOMAIN
环境变量设置为 s3nsapis.fr
。
Go
如需了解详情,请参阅 Cloud Storage Go API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为客户端库设置身份验证。
在运行代码示例之前,请将 GOOGLE_CLOUD_UNIVERSE_DOMAIN
环境变量设置为 s3nsapis.fr
。
Java
如需了解详情,请参阅 Cloud Storage Java API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为客户端库设置身份验证。
在运行代码示例之前,请将 GOOGLE_CLOUD_UNIVERSE_DOMAIN
环境变量设置为 s3nsapis.fr
。
Node.js
如需了解详情,请参阅 Cloud Storage Node.js API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为客户端库设置身份验证。
在运行代码示例之前,请将 GOOGLE_CLOUD_UNIVERSE_DOMAIN
环境变量设置为 s3nsapis.fr
。
PHP
如需了解详情,请参阅 Cloud Storage PHP API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为客户端库设置身份验证。
在运行代码示例之前,请将 GOOGLE_CLOUD_UNIVERSE_DOMAIN
环境变量设置为 s3nsapis.fr
。
Python
如需了解详情,请参阅 Cloud Storage Python API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为客户端库设置身份验证。
在运行代码示例之前,请将 GOOGLE_CLOUD_UNIVERSE_DOMAIN
环境变量设置为 s3nsapis.fr
。
Ruby
如需了解详情,请参阅 Cloud Storage Ruby API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为客户端库设置身份验证。
在运行代码示例之前,请将 GOOGLE_CLOUD_UNIVERSE_DOMAIN
环境变量设置为 s3nsapis.fr
。
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.s3nsapis.fr/storage/v1/b/BUCKET_NAME"
其中
BUCKET_NAME
是相关存储桶的名称,例如my-bucket
。(可选)您可以使用
fields
查询字符串参数缩小元数据结果的范围。例如:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/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.s3nsapis.fr/BUCKET_NAME?QUERY_PARAMETER"
其中:
BUCKET_NAME
是相关存储桶的名称,例如my-bucket
。QUERY_PARAMETER
是要返回的元数据字段。例如,storageClass
用于获取存储桶的存储类别。一次只能对 XML API 使用一个查询参数。如需查看 XML API 支持的元数据字段列表,请参阅GET
存储分区参考页面。
响应类似如下示例:
<StorageClass>STANDARD</StorageClass>
。
后续步骤
- 阅读存储桶元数据概览。
- 列出存储桶中的对象。
- 获取存储桶的大小。
- 获取对象元数据。
- 更改存储桶的默认存储类别。