本页面介绍了如何列出项目中的 Cloud Storage 存储桶,这些存储桶按名称的字典顺序在列表中排序。
须知事项
如需获得列出存储桶所需的权限,请让管理员向您授予您要列出的存储桶所属项目的 Storage Admin (roles/storage.admin
) IAM 角色或 Viewer (roles/viewer
) 基本角色。
如需详细了解如何授予项目角色,请参阅管理对项目的访问权限。
这些角色包含列出存储桶所需的 storage.buckets.list
权限。您还可以通过自定义角色获取此权限。
列出项目中的存储桶
控制台
- 在 Google Cloud 控制台中,进入 Cloud Storage 存储桶页面。
属于当前所选项目的存储桶会显示在列表中。
(可选)使用过滤功能来缩小列表中的结果范围。
命令行
-
在 Google Cloud 控制台中,激活 Cloud Shell。
Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动,并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。
在开发环境中,运行
gcloud storage ls
命令:gcloud storage ls
响应如下例所示:
gs://BUCKET_NAME1/ gs://BUCKET_NAME2/ gs://BUCKET_NAME3/ ...
客户端库
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 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
REST API
JSON API
- 从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。如需了解相关说明,请参阅 API 身份验证。
使用
cURL
,通过GET
服务请求调用 JSON API:curl -X GET -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage./storage/v1/b?project=PROJECT_IDENTIFIER"
其中:
OAUTH2_TOKEN
是您在第 1 步中生成的访问令牌。PROJECT_IDENTIFIER
是包含您要列出的存储桶的项目的 ID 或编号。例如my-project
。
XML API
- 从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。如需了解相关说明,请参阅 API 身份验证。
使用
cURL
,通过GET
服务请求调用 XML API:curl -X GET -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage."
其中:
OAUTH2_TOKEN
是您在第 1 步中生成的访问令牌。PROJECT_ID
是包含您要列出的存储桶的项目的 ID,例如my-project
。
后续步骤
- 获取有关存储桶大小的信息。
- 列出存储桶中的对象。
- 移动或重命名存储桶。
- 删除存储桶。
- 了解如何对结果进行分页。