Billing API の概要

Billing API は Kubernetes カスタム リソースを使用し、Kubernetes リソースモデル(KRM)に依存して、Google Distributed Cloud(GDC)エアギャップ サービスの SKU を管理します。

Billing API を使用するには、GDC コンソールを使用します。アプリケーションで独自のライブラリを使用して API を呼び出す場合は、次のセクションのサービス エンドポイントの例と、リクエストの作成に使用する完全な API 定義を採用します。

サービス エンドポイントとディスカバリ ドキュメント

Billing API は、ゾーン デプロイまたはグローバル デプロイに応じて 2 つのパッケージで提供されます。

ゾーン Billing API とグローバル Billing 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 コマンドを使用して、ブラウザで URL にアクセスし、Billing API のディスカバリ ドキュメントを取得します。kubectl proxy コマンドは、ローカルマシンの 127.0.0.1:8001 から Kubernetes API サーバーへのプロキシを開きます。このコマンドを実行すると、次の URL でドキュメントにアクセスできます。

  • 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"