Billing API 概览

结算 API 使用 Kubernetes 自定义资源,并依赖于 Kubernetes 资源模型 (KRM) 来管理 Google Distributed Cloud (GDC) 气隙服务的 SKU。

如需使用结算 API,请使用 GDC 控制台。如果您的应用使用自己的库来调用 API,请采用下一部分中的示例服务端点和完整的 API 定义来构建请求。

服务端点和发现文档

结算 API 以两种软件包的形式提供,具体取决于区域部署或全球部署。

区域级和全局结算 API 的 API 端点分别如下所示:

  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/billing.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/billing.global.gdc.goog/v1

MANAGEMENT_API_SERVER_ENDPOINT 变量是 Management API 服务器的端点。

使用 kubectl proxy 命令,在浏览器中访问相应网址以获取 Billing API 的发现文档。kubectl proxy 命令会在本地机器上打开一个代理,以连接到 Kubernetes API 服务器。127.0.0.1:8001运行该命令后,您可以通过以下网址访问文档:

  • http://127.0.0.1:8001/apis/billing.gdc.goog/v1
  • http://127.0.0.1:8001/apis/billing.global.gdc.goog/v1

示例资源

以下是 SKUDescription 资源的示例:

apiVersion: billing.gdc.goog/v1
kind: SKUDescription
metadata:
  name: 4a76-432c-797f
  namespace: billing-system
skuID: 4A76-432C-797F
invoiceDescription: "GDC-H Sample SKU"
description: "A description to describe what the SKU is charging."
category: Sample
pricingInfo:
  - unitPrice:
      currencyCode: USD
      units: 100
      nanos: 0
  usageUnit: vTestResource * month
  effectiveTime: "2023-01-01T00:00:00-08:00"