Gcp/cloudbilling

@swamp/gcp/cloudbillingv2026.10.13.1· 1d agoBEHAVIORS

01README

Google Cloud cloudbilling infrastructure models

02Release Notes

Updated: billingaccounts, projects, subaccounts, services, services_skus, tasks, tasks_pushnotificationconfigs

03Behaviors7

@swamp/gcp/cloudbilling/billingaccountsv2026.10.13.1billingaccounts.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
currencyCode?	string	no	Optional. The currency in which the billing account is billed and charged, represented as an ISO 4217 code such as `USD`. Billing account currency is determined at the time of billing account creation and cannot be updated subsequently, so this field should not be set on update requests. In addition, a subaccount always matches the currency of its parent billing account, so this field should not be set on subaccount creation requests. Clients can read this field to determine the currency of an e
displayName?	string	no	The display name given to the billing account, such as `My Billing Account`. This name is displayed in the Google Cloud Console.
masterBillingAccount?	string	no	If this account is a [subaccount](https://cloud.google.com/billing/docs/concepts), then this will be the resource name of the parent billing account that it is being resold through. Otherwise this will be empty.

fn create()

Create a billingAccounts

fn get(identifier: string)

Get a billingAccounts

Argument	Type	Required	Description
identifier	string	yes	The name of the billingAccounts

fn update(identifier?: string)

Update billingAccounts attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific billingAccounts by name (e.g. one discovered by list)

fn sync(identifier?: string)

Sync billingAccounts state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific billingAccounts by name (e.g. one discovered by list)

fn list(filter?: string, pageSize?: number, parent?: string, maxPages?: number)

List billingAccounts resources

Argument	Type	Required	Description
filter?	string	no	Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (for example, `master_billing_account=billingAccounts/012345-678901-ABCDEF`). Boolean algebra and other fields are not currently supported.
pageSize?	number	no	Requested page size. The maximum page size is 100; this is also the default.
parent?	string	no	Optional. The parent resource to list billing accounts from. Format: - `organizations/{organization_id}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id}`, for example, `billingAccounts/012345-567890-ABCDEF`
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

fn get_iam_policy(options_requestedPolicyVersion?: any)

get iam policy

Argument	Type	Required	Description
options_requestedPolicyVersion?	any	no

fn move(destinationParent?: any)

move

Argument	Type	Required	Description
destinationParent?	any	no

fn set_iam_policy(policy?: any, updateMask?: any)

set iam policy

Argument	Type	Required	Description
policy?	any	no
updateMask?	any	no

fn test_iam_permissions(permissions?: any)

test iam permissions

Argument	Type	Required	Description
permissions?	any	no

Resources

state(infinite)— A billing account in the [Google Cloud Console](https://console.cloud.google....

@swamp/gcp/cloudbilling/projectsv2026.10.13.1projects.ts

Global Arguments

Argument	Type	Required	Description
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
name	string	yes	Required. The resource name of the billing account associated with the projects that you want to list. For example, `billingAccounts/012345-567890-ABCDEF`.

fn get(identifier: string)

Get a projects

Argument	Type	Required	Description
identifier	string	yes	The name of the projects

fn sync(identifier?: string)

Sync projects state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific projects by name (e.g. one discovered by list)

fn list(pageSize?: number, maxPages?: number)

List projects resources

Argument	Type	Required	Description
pageSize?	number	no	Requested page size. The maximum page size is 100; this is also the default.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— Encapsulation of billing information for a Google Cloud Console project. A pr...

@swamp/gcp/cloudbilling/servicesv2026.10.13.1services.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.

fn get(identifier: string)

Get a services

Argument	Type	Required	Description
identifier	string	yes	The name of the services

fn sync(identifier?: string)

Sync services state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific services by name (e.g. one discovered by list)

fn list(pageSize?: number, maxPages?: number)

List services resources

Argument	Type	Required	Description
pageSize?	number	no	Requested page size. Defaults to 5000.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— Encapsulates a single service in Google Cloud Platform.

@swamp/gcp/cloudbilling/services-skusv2026.10.13.1services_skus.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
parent?	string	no	The parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456)

fn get(identifier: string)

Get a skus

Argument	Type	Required	Description
identifier	string	yes	The name of the skus

fn sync(identifier?: string)

Sync skus state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific skus by name (e.g. one discovered by list)

fn list(currencyCode?: string, endTime?: string, pageSize?: number, startTime?: string, maxPages?: number)

List skus resources

Argument	Type	Required	Description
currencyCode?	string	no	The ISO 4217 currency code for the pricing info in the response proto. Will use the conversion rate as of start_time. Optional. If not specified USD will be used.
endTime?	string	no	Optional exclusive end time of the time range for which the pricing versions will be returned. Timestamps in the future are not allowed. The time range has to be within a single calendar month in America/Los_Angeles timezone. Time range as a whole is optional. If not specified, the latest pricing will be returned (up to 12 hours old at most).
pageSize?	number	no	Requested page size. Defaults to 5000.
startTime?	string	no	Optional inclusive start time of the time range for which the pricing versions will be returned. Timestamps in the future are not allowed. The time range has to be within a single calendar month in America/Los_Angeles timezone. Time range as a whole is optional. If not specified, the latest pricing will be returned (up to 12 hours old at most).
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— Encapsulates a single SKU in Google Cloud

@swamp/gcp/cloudbilling/subaccountsv2026.10.13.1subaccounts.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
currencyCode?	string	no	Optional. The currency in which the billing account is billed and charged, represented as an ISO 4217 code such as `USD`. Billing account currency is determined at the time of billing account creation and cannot be updated subsequently, so this field should not be set on update requests. In addition, a subaccount always matches the currency of its parent billing account, so this field should not be set on subaccount creation requests. Clients can read this field to determine the currency of an e
displayName?	string	no	The display name given to the billing account, such as `My Billing Account`. This name is displayed in the Google Cloud Console.
masterBillingAccount?	string	no	If this account is a [subaccount](https://cloud.google.com/billing/docs/concepts), then this will be the resource name of the parent billing account that it is being resold through. Otherwise this will be empty.
parent?	string	no	Output only. The billing account's parent resource identifier. Use the `MoveBillingAccount` method to update the account's parent resource if it is a organization. Format: - `organizations/{organization_id}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id}`, for example, `billingAccounts/012345-567890-ABCDEF`

fn create()

Create a subAccounts

fn get(identifier: string)

Get a subAccounts

Argument	Type	Required	Description
identifier	string	yes	The name of the subAccounts

fn sync(identifier?: string)

Sync subAccounts state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific subAccounts by name (e.g. one discovered by list)

fn list(filter?: string, pageSize?: number, maxPages?: number)

List subAccounts resources

Argument	Type	Required	Description
filter?	string	no	Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (for example, `master_billing_account=billingAccounts/012345-678901-ABCDEF`). Boolean algebra and other fields are not currently supported.
pageSize?	number	no	Requested page size. The maximum page size is 100; this is also the default.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— A billing account in the [Google Cloud Console](https://console.cloud.google....

@swamp/gcp/cloudbilling/tasksv2026.10.13.1tasks.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.

fn get(identifier: string)

Get a tasks

Argument	Type	Required	Description
identifier	string	yes	The name of the tasks

fn sync(identifier?: string)

Sync tasks state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific tasks by name (e.g. one discovered by list)

fn cancel(tenant?: any)

cancel

Argument	Type	Required	Description
tenant?	any	no

fn subscribe(tenant?: any)

Argument	Type	Required	Description
tenant?	any	no

Resources

state(infinite)— Task is the core unit of action for A2A. It has a current status and when res...

@swamp/gcp/cloudbilling/tasks-pushnotificationconfigsv2026.10.13.1tasks_pushnotificationconfigs.ts

Global Arguments

Argument	Type	Required	Description
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
name?	string	no	The resource name of the config. Format: tasks/{task_id}/pushNotificationConfigs/{config_id}
pushNotificationConfig?	object	no	The push notification configuration details.
configId?	string	no	Required. The ID for the new config.
tenant?	string	no	Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.
parent?	string	no	The parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456)

fn create()

Create a pushNotificationConfigs

fn get(identifier: string)

Get a pushNotificationConfigs

Argument	Type	Required	Description
identifier	string	yes	The name of the pushNotificationConfigs

fn delete(identifier: string)

Delete the pushNotificationConfigs

Argument	Type	Required	Description
identifier	string	yes	The name of the pushNotificationConfigs

fn sync(identifier?: string)

Sync pushNotificationConfigs state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific pushNotificationConfigs by name (e.g. one discovered by list)

fn list(pageSize?: number, tenant?: string, maxPages?: number)

List pushNotificationConfigs resources

Argument	Type	Required	Description
pageSize?	number	no	For AIP-158 these fields are present. Usually not used/needed. The maximum number of configurations to return. If unspecified, all configs will be returned.
tenant?	string	no	Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— Get a push notification config for a task.

04Previous Versions19

2026.10.06.1Oct 6, 2026

Updated: billingaccounts, tasks

2026.09.07.2Sep 8, 2026

Updated: billingaccounts

2026.09.03.1Sep 3, 2026

Added: tasks, tasks_pushnotificationconfigs

Added 2 behaviors

2026.08.12.2Aug 12, 2026

Updated: billingaccounts, projects, subaccounts, services, services_skus

2026.07.29.1Jul 30, 2026

Updated: billingaccounts, projects, subaccounts, services, services_skus

2026.07.21.2Jul 21, 2026

Updated: billingaccounts, projects, subaccounts, services, services_skus

2026.07.20.1Jul 20, 2026

Updated: billingaccounts, projects, subaccounts, services, services_skus

2026.07.19.2Jul 19, 2026

Updated: projects

2026.07.19.1Jul 19, 2026

Updated: billingaccounts, projects, subaccounts, services, services_skus

2026.07.18.2Jul 18, 2026

Updated: billingaccounts, projects, subaccounts, services, services_skus

2026.07.17.1Jul 17, 2026

Updated: billingaccounts

2026.06.08.2Jun 8, 2026

Updated: billingaccounts, projects, subaccounts, services, services_skus

2026.06.07.1Jun 7, 2026

Updated: billingaccounts, projects, subaccounts, services, services_skus

2026.05.25.2May 25, 2026

Updated: billingaccounts, services

Modified 5 behaviors

2026.05.24.1May 24, 2026

Updated: billingaccounts, projects, subaccounts, services, services_skus

2026.05.21.2May 21, 2026

Updated: billingaccounts, projects, subaccounts, services, services_skus

2026.05.21.1May 21, 2026

Modified 1 behaviors

2026.05.19.2May 19, 2026

2026.05.19.1May 19, 2026

05Stats

93 / 100

Downloads

Archive size

47.9 KB

Verified by Swamp

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types (deprecated)1/1earned
Dependencies pass trust audit2/2earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License1/2partial
no SPDX license declared
Verified public repository2/2earned

Repository

https://github.com/swamp-club/swamp-extensions

06Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64 windows · x86_64

07Labels

#gcp #google-cloud #cloudbilling #cloud #infrastructure