Gcp/tpu

@swamp/gcp/tpuv2026.10.30.1· AGPL-3.0-or-later· 1d agoBEHAVIORS

01README

Google Cloud tpu infrastructure models

02Release Notes

Updated: locations, nodes, queuedresources

03Behaviors6

@swamp/gcp/tpu/acceleratortypesv2026.10.23.1acceleratortypes.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.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn get(identifier: string)

Get a acceleratorTypes

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

fn sync(identifier?: string)

Sync acceleratorTypes state from GCP

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

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

List acceleratorTypes resources

Argument	Type	Required	Description
filter?	string	no	List filter.
orderBy?	string	no	Sort results.
pageSize?	number	no	The maximum number of items to return.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— A accelerator type that a Node can be configured with.

@swamp/gcp/tpu/locationsv2026.10.30.1locations.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	The resource that owns the locations collection, if applicable.

fn get(identifier: string)

Get a locations

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

fn sync(identifier?: string)

Sync locations state from GCP

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

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

List locations resources

Argument	Type	Required	Description
extraLocationTypes?	string	no	Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.
filter?	string	no	A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
pageSize?	number	no	The maximum number of results to return. If not set, the service selects a default.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

fn generate_service_identity()

generate service identity

Resources

state(infinite)— A resource that represents a Google Cloud location.

@swamp/gcp/tpu/nodesv2026.10.30.1nodes.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.
acceleratorConfig?	object	no	The AccleratorConfig for the TPU Node.
acceleratorType?	string	no	Optional. The type of hardware accelerators associated with this node.
bootDiskConfig?	object	no	Optional. Boot disk configuration.
cidrBlock?	string	no	The CIDR block that the TPU node will use when selecting an IP address. This CIDR block must be a /29 block; the Compute Engine networks API forbids a smaller block, and using a larger block would be wasteful (a node can only consume one IP address). Errors will occur if the CIDR block has already been used for a currently existing TPU node, the CIDR block conflicts with any subnetworks in the user's provided network, or the provided network is peered with another network that is using that CIDR
dataDisks?	array	no	The additional data disks for the Node.
description?	string	no	The user-supplied description of the TPU. Maximum of 512 characters.
health?	enum	no	The health status of the TPU node.
labels?	record	no	Resource labels to represent user-provided metadata.
metadata?	record	no	Custom metadata to apply to the TPU Node. Can set startup-script and shutdown-script
networkConfig?	object	no	Network configurations for the TPU node. network_config and network_configs are mutually exclusive, you can only specify one of them. If both are specified, an error will be returned.
networkConfigs?	array	no	Optional. Repeated network configurations for the TPU node. This field is used to specify multiple networks configs for the TPU node. network_config and network_configs are mutually exclusive, you can only specify one of them. If both are specified, an error will be returned.
runtimeVersion?	string	no	Required. The runtime version running in the Node.
schedulingConfig?	object	no	The scheduling options for this node.
serviceAccount?	object	no	The Google Cloud Platform Service Account to be used by the TPU node VMs. If None is specified, the default compute service account will be used.
shieldedInstanceConfig?	object	no	Shielded Instance options.
tags?	array	no	Tags to apply to the TPU Node. Tags are used to identify valid sources or targets for network firewalls.
nodeId?	string	no	The unqualified resource name.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create(waitForReady?: boolean)

Create a nodes

Argument	Type	Required	Description
waitForReady?	boolean	no	Wait for the resource to reach a ready state after creation (default: true)

fn get(identifier: string)

Get a nodes

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

fn update(identifier?: string, waitForReady?: boolean)

Update nodes attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific nodes by name (e.g. one discovered by list)
waitForReady?	boolean	no	Wait for the resource to reach a ready state after update (default: true)

fn delete(identifier: string)

Delete the nodes

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

fn sync(identifier?: string)

Sync nodes state from GCP

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

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

List nodes resources

Argument	Type	Required	Description
pageSize?	number	no	The maximum number of items to return.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

fn get_guest_attributes(queryPath?: any, workerIds?: any)

get guest attributes

Argument	Type	Required	Description
queryPath?	any	no
workerIds?	any	no

fn start()

start

fn stop()

stop

Resources

state(infinite)— A TPU instance.

@swamp/gcp/tpu/queuedresourcesv2026.10.30.1queuedresources.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.
guaranteed?	object	no	Optional. The Guaranteed tier
queueingPolicy?	object	no	Optional. The queueing policy of the QueuedRequest.
reservationName?	string	no	Optional. Name of the reservation in which the resource should be provisioned. Format: projects/{project}/locations/{zone}/reservations/{reservation}
spot?	object	no	Optional. The Spot tier.
tpu?	object	no	Optional. Defines a TPU resource.
queuedResourceId?	string	no	Optional. The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$` regex format.
requestId?	string	no	Optional. Idempotent request UUID.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a queuedResources

fn get(identifier: string)

Get a queuedResources

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

fn delete(identifier: string)

Delete the queuedResources

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

fn sync(identifier?: string)

Sync queuedResources state from GCP

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

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

List queuedResources resources

Argument	Type	Required	Description
pageSize?	number	no	Optional. The maximum number of items to return.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

fn reset()

reset

Resources

state(infinite)— A QueuedResource represents a request for resources that will be placed in a ...

@swamp/gcp/tpu/runtimeversionsv2026.10.23.1runtimeversions.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.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn get(identifier: string)

Get a runtimeVersions

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

fn sync(identifier?: string)

Sync runtimeVersions state from GCP

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

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

List runtimeVersions resources

Argument	Type	Required	Description
filter?	string	no	List filter.
orderBy?	string	no	Sort results.
pageSize?	number	no	The maximum number of items to return.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— A runtime version that a Node can be configured with.

@swamp/gcp/tpu/tensorflowversionsv2026.10.23.1tensorflowversions.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.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn get(identifier: string)

Get a tensorflowVersions

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

fn sync(identifier?: string)

Sync tensorflowVersions state from GCP

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

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

List tensorflowVersions resources

Argument	Type	Required	Description
filter?	string	no	List filter.
orderBy?	string	no	Sort results.
pageSize?	number	no	The maximum number of items to return.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— A tensorflow version that a Node can be configured with.

04Previous Versions19

2026.10.23.1AGPL-3.0-or-later(was none)Oct 24, 2026

Updated: locations, acceleratortypes, nodes, queuedresources, runtimeversions, tensorflowversions

2026.10.13.1Oct 13, 2026

Updated: locations, acceleratortypes, nodes, queuedresources, runtimeversions, tensorflowversions

2026.10.06.1Oct 6, 2026

Updated: locations, nodes, queuedresources

2026.10.04.1Oct 4, 2026

Updated: locations, nodes, queuedresources

2026.08.12.2Aug 12, 2026

Updated: locations, acceleratortypes, nodes, queuedresources, runtimeversions, tensorflowversions

2026.07.29.1Jul 30, 2026

Updated: locations, acceleratortypes, nodes, queuedresources, runtimeversions, tensorflowversions

2026.07.21.4Jul 21, 2026

Added: tensorflowversions

2026.07.21.1Jul 21, 2026

Updated: nodes, queuedresources

2026.07.20.2Jul 20, 2026

Added: tensorflowversions

Added 1 behaviors

2026.07.20.1Jul 20, 2026

Updated: locations, acceleratortypes, nodes, queuedresources, runtimeversions

Removed 1 behaviors

2026.07.19.2Jul 19, 2026

Updated: locations

2026.07.19.1Jul 19, 2026

Updated: locations, acceleratortypes, nodes, queuedresources, runtimeversions, tensorflowversions

2026.07.18.2Jul 18, 2026

Updated: locations, acceleratortypes, nodes, queuedresources, runtimeversions, tensorflowversions

2026.07.17.2Jul 17, 2026

Updated: nodes

2026.07.17.1Jul 17, 2026

Updated: acceleratortypes, nodes, queuedresources, runtimeversions, tensorflowversions

2026.06.08.2Jun 8, 2026

Updated: locations, acceleratortypes, nodes, queuedresources, runtimeversions, tensorflowversions

2026.06.07.1Jun 7, 2026

Updated: locations, acceleratortypes, nodes, queuedresources, runtimeversions, tensorflowversions

2026.06.05.1Jun 5, 2026

Added: tensorflowversions

Added 1 behaviors

2026.05.25.1May 25, 2026

Updated: locations, acceleratortypes, nodes, queuedresources, runtimeversions

Modified 5 behaviors

05Stats

100 / 100

Downloads

Archive size

59.7 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
Docs keep secrets in a vault1/1earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License2/2earned
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 #tpu #cloud #infrastructure