项目

本页面介绍 Google Cloud Console 项目与 Cloud Storage 资源之间的关系。如需从整体上详细了解 Google Cloud Console 项目,请参阅《Google Cloud 概览》中的项目

什么是项目?

项目用于组织您的所有 Google Cloud 资源。项目包含一组用户和一组 API,以及这些 API 的结算、身份验证和监控设置。因此,举例来说,您的所有 Cloud Storage 存储分区和对象以及它们的用户访问权限均包含在项目中。 您可以使用一个项目,也可以创建多个项目并使用它们来将您的 Google Cloud 资源(包括 Cloud Storage 数据)组织到逻辑组中。

何时指定项目

大多数情况下,在 Cloud Storage 中执行操作时无需指定项目;但在以下情况下,您应指定项目 ID 或项目编号:

控制台

  • 将 Cloud Storage 与 Cloud Console 搭配使用时,系统会自动将您与项目关联起来。您可以使用 Cloud Console 窗口顶部的下拉菜单更改项目。

  • 首次访问启用了请求者付款功能的存储分区时,系统会提示您选择一个项目以便结算请求费用。之后,您可以更改结算项目,方法是点击更改项目按钮(位于存储分区中的对象列表上方)。

gsutil

  • 使用 gsutil mbgsutil lsgsutil kms 命令时,您必须指定项目,除非您已设置默认项目。如果您尚未设置默认项目或想要使用其他项目,请使用 -p 标志指定项目。使用其他 gsutil 命令时无需指定项目。

  • 使用 -u 标志和项目 ID 来指明用于结算存储分区访问费用的项目。如果访问的存储分区启用了请求者付款功能,您必须执行此操作,否则此为可选操作。

JSON API

  • 使用 list bucketsinsert bucket 方法时,您必须指定项目。项目将以参数形式在请求网址中发送,如以下示例所示:

    GET https://storage.googleapis.com/storage/v1/b?project=PROJECT_ID
  • 要指明用于结算存储分区访问费用的项目,需使用“userProject”查询参数和项目 ID,如以下示例所示:

    GET https://storage.googleapis.com/storage/v1/b?userProject=PROJECT_ID

    如果访问的存储分区启用了请求者付款功能,则必须使用此查询参数,否则此为可选参数。

XML API

  • 列出存储分区和插入存储分区时需指定项目。与这些 XML API 请求关联的项目在 x-goog-project-id HTTP 标头中指定,如以下示例所示:

    x-goog-project-id: PROJECT_ID

    如果使用其他 XML API 请求,或者您已针对互操作访问设置默认项目,则此为可选标头。

  • 要指明用于结算存储分区访问费用的项目,需使用“x-goog-user-project”标头和项目 ID,如以下示例中所示:

    x-goog-user-project: PROJECT_ID

    如果访问的存储分区启用了请求者付款功能,则必须使用此标头,否则此为可选标头。

项目和权限

对于每个项目,您都可以使用 Identity and Access Management (IAM) 授予管理和处理项目的权限。如果您向某成员(例如 Google 帐号)授予 IAM 角色,该成员可获得特定权限,从而可执行某些操作。如果您在项目级层授予某角色,该角色提供的访问权限会应用于项目中的所有存储分区和对象。或者,如果您为单个存储分区授予角色,该角色提供的访问权限将仅适用于该存储分区以及该存储分区包含的对象。

如需查看适用于 Cloud Storage 的可用角色列表,以及有关特殊角色集(称为基本角色)如何适用于 Cloud Storage 的讨论,请参阅 Cloud Storage IAM 角色

如需在存储分区和项目级层查看、授予和撤消成员角色的说明,请参阅将 IAM 用于项目

服务帐号

服务帐号可让应用验证和访问 Google Cloud 资源及服务。例如,您可以创建服务帐号,供 Compute Engine 实例用来访问存储于 Cloud Storage 存储分区中的对象。

服务帐号在项目中创建,并具有可供识别的专属电子邮件地址。大多数服务帐号都是由用户创建和管理,但有些服务帐号是由 Google Cloud 服务自动创建和管理的。Cloud Storage 创建的服务帐号中包含以下格式的电子邮件地址:

service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com

其中,PROJECT_NUMBER 是拥有该服务帐号的项目的编号

与 Cloud Storage 搭配使用

以下功能使用自动 Cloud Storage 服务帐号:

以下是您创建和管理的服务帐号可以执行的 Cloud Storage 相关操作示例:

后续步骤