Stay organized with collections
Save and categorize content based on your preferences.
The Billing API uses Kubernetes custom resources and relies on the
Kubernetes Resource Model (KRM) to manage SKUs for
Google Distributed Cloud (GDC) air-gapped services.
To use the Billing API, use the GDC console. If your application uses
your own libraries to call the API, adopt the example service endpoint in the
following section, and the full API definitions to build your requests.
The MANAGEMENT_API_SERVER_ENDPOINT variable is the
endpoint of the Management API server.
Using the kubectl proxy command, access the URL in your browser to
obtain the discovery document for the Billing API. The kubectl proxy
command opens up a proxy on 127.0.0.1:8001 to the Kubernetes API server on
your local machine. After that command is running, you can access the document at
the following URLs:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThe Billing API utilizes Kubernetes custom resources and the Kubernetes Resource Model (KRM) to manage SKUs for Google Distributed Cloud (GDC) air-gapped services.\u003c/p\u003e\n"],["\u003cp\u003eYou can access the Billing API via the GDC console, or by using the provided API definitions and example service endpoints to build your own requests.\u003c/p\u003e\n"],["\u003cp\u003eThe Billing APIs are available in two packages, zonal and global, with their respective endpoints provided for each deployment type.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the discovery document for the Billing API by using the \u003ccode\u003ekubectl proxy\u003c/code\u003e command and accessing specific URLs on your local machine.\u003c/p\u003e\n"],["\u003cp\u003eAn example of a SKUDescription is provided, showcasing the structure of a resource within the Billing API.\u003c/p\u003e\n"]]],[],null,["# Billing API overview\n\nThe Billing API uses Kubernetes custom resources and relies on the\nKubernetes Resource Model (KRM) to manage SKUs for\nGoogle Distributed Cloud (GDC) air-gapped services.\n\nTo use the Billing API, use the GDC console. If your application uses\nyour own libraries to call the API, adopt the example service endpoint in the\nfollowing section, and the full API definitions to build your requests.\n\n- [billing.gdc.goog/v1](/distributed-cloud/hosted/docs/latest/gdch/apis/service/billing/v1/billing-v1)\n- [billing.global.gdc.goog/v1](/distributed-cloud/hosted/docs/latest/gdch/apis/service/billing/v1/global-billing-v1)\n\nService endpoint and discovery document\n---------------------------------------\n\nThe Billing APIs are provided in two packages depending on zonal deployment or\nglobal deployment.\n\nThe API endpoints for the zonal and global Billing APIs are the following,\nrespectively:\n\n- `https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/billing.gdc.goog/v1`\n- `https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/billing.global.gdc.goog/v1`\n\nThe \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e variable is the\nendpoint of the Management API server.\n\nUsing the `kubectl proxy` command, access the URL in your browser to\nobtain the discovery document for the Billing API. The `kubectl proxy`\ncommand opens up a proxy on `127.0.0.1:8001` to the Kubernetes API server on\nyour local machine. After that command is running, you can access the document at\nthe following URLs:\n\n- `http://127.0.0.1:8001/apis/billing.gdc.goog/v1`\n- `http://127.0.0.1:8001/apis/billing.global.gdc.goog/v1`\n\nExample resources\n-----------------\n\nThe following is a sample `SKUDescription` resource: \n\n apiVersion: billing.gdc.goog/v1\n kind: SKUDescription\n metadata:\n name: 4a76-432c-797f\n namespace: billing-system\n skuID: 4A76-432C-797F\n invoiceDescription: \"GDC-H Sample SKU\"\n description: \"A description to describe what the SKU is charging.\"\n category: Sample\n pricingInfo:\n - unitPrice:\n currencyCode: USD\n units: 100\n nanos: 0\n usageUnit: vTestResource * month\n effectiveTime: \"2023-01-01T00:00:00-08:00\""]]
