本指南介绍了开始使用 Cloud Billing Budget API 所需的所有设置步骤。
准备工作
在阅读本指南之前,请先完成以下事项:
Google Cloud 控制台简介
Google Cloud 控制台(访问文档,打开控制台)是一个网页界面,用于预配、配置、管理和监控使用 Google Cloud 产品的系统。您可以使用 Google Cloud 控制台设置和管理 Google Cloud 和 Cloud Billing 资源。
1. 选择或创建项目
如需使用 Google Cloud 提供的服务,您必须创建一个项目。项目用于组织您的所有 Google Cloud 资源。项目由一组协作者、已启用的 API(和其他资源)、监控工具、结算信息以及身份验证和访问权限控制组成。您可以创建一个项目,也可以创建多个项目,并使用这些项目按资源层次结构组织 Google Cloud 资源。如需详细了解项目,请参阅 Resource Manager 文档。
建议:我们建议您创建一个单独的 Google Cloud 项目,在其中设置您的所有结算管理需求,包括 Cloud Billing Budget API。您的结算管理 Google Cloud 项目也可用于 Cloud Billing Account API 访问、Cloud Billing 导出的数据以及程序化预算通知的 Pub/Sub 渠道等。
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
2. 启用结算功能
您需要确保在调用 Cloud Billing Budget API 的项目中启用结算功能。如果您遵循了项目部分中的建议,那么这是您的结算管理 Google Cloud 项目。
Cloud Billing 账号用于定义一组给定 Google Cloud 资源的支付者。资源(例如已启用的 API)是在项目中组织的。Cloud Billing 账号可以关联到一个或多个项目。项目的资源使用费将记在关联的结算账号名下。在大多数情况下,您应在创建项目时配置结算信息。如需了解详情,请参阅结算文档。
您需要设置 Cloud Billing 预算来监控 Cloud Billing 账号。您监控的 Cloud Billing 账号可以是与调用 Cloud Billing Budget API 的项目关联的同一 Cloud Billing 账号。请注意,Cloud Billing Budget API 可供 Google Cloud 客户免费使用。如果您选择配置程序化预算通知,则需要支付标准 Pub/Sub 费用。
Make sure that billing is enabled for your Google Cloud project.
3. 启用 API
您必须在调用 Cloud Billing Budget API 的项目中启用 Cloud Billing Budget API。如果您遵循了项目部分中的建议,那么这是您的结算管理 Google Cloud 项目。
如需详细了解如何启用 API,请参阅服务使用工具文档。
Enable the Cloud Billing Budget API.
4. 设置身份验证和授权
如果您计划使用 Cloud Billing Budget API,则需要设置身份验证。任何使用 API 的客户端应用都必须通过身份验证来确认其身份。如需了解详情,请参阅向 Cloud Billing 进行身份验证。
您作为特定主账号(如 Google 账号或服务账号)进行身份验证。该主账号必须具有包含 Cloud Billing Budget API 所需权限的 Identity and Access Management (IAM) 角色。
为了确保主账号具有管理预算所需的权限,请让您的管理员为主账号授予结算账号的 Billing Account Administrator (roles/billing.admin
) IAM 角色账号。
如需详细了解如何授予角色,请参阅管理访问权限。
您的管理员还可以通过自定义角色或其他预定义角色向主账号授予所需的权限。
如需了解如何授予结算账号的角色,请参阅更新 Cloud Billing 权限。
5. 安装并初始化 gcloud CLI
如果您打算使用 Cloud Billing Budget API,则需要安装并初始化 Google Cloud CLI。Google Cloud CLI 是一组工具,可用于管理 Google Cloud 上托管的资源和应用。这包括 gcloud CLI。以下链接提供了相关说明:
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
6. 测试 SDK 和身份验证
如果您在前面的步骤中设置了身份验证,则可以使用 gcloud CLI 测试您的身份验证环境。执行以下命令,确认没有发生任何错误并且返回了凭据:
gcloud auth print-access-token
所有 Cloud Billing Budget API 命令行 REST 示例都会使用该命令对 API 调用进行身份验证。
7. 安装 Cloud Billing Budget API 客户端库
Cloud Billing Budget API 基于 HTTP 和 JSON 构建,因此任何标准 HTTP 客户端都可以向其发送请求并解析响应。
您可以通过以下三种方式调用 API:
Google 支持的客户端库(推荐)
客户端库可提供更好的语言集成和更高的安全性,并支持进行需要用户授权的调用。受 Google 支持的客户端库支持多种主流语言,建议您使用这些客户端库。