Gcp/run

@swamp/gcp/runv2026.04.23.1· 8d agoMODELS

01README

Google Cloud run infrastructure models

02Models8

@swamp/gcp/run/instancesv2026.04.23.1instances.ts

Global Arguments

Argument	Type	Required	Description
annotations?	record	no
binaryAuthorization?	object	no	Settings for Binary Authorization feature.
client?	string	no	Arbitrary identifier for the API client.
clientVersion?	string	no	Arbitrary version identifier for the API client.
containers?	array	no	Required. Holds the single container that defines the unit of execution for this Instance.
description?	string	no	User-provided description of the Instance. This field currently has a 512-character limit.
encryptionKey?	string	no	A reference to a customer managed encryption key (CMEK) to use to encrypt this container image. For more information, go to https://cloud.google.com/run/docs/securing/using-cmek
encryptionKeyRevocationAction?	enum	no	The action to take if the encryption key is revoked.
encryptionKeyShutdownDuration?	string	no	If encryption_key_revocation_action is SHUTDOWN, the duration before shutting down all instances. The minimum increment is 1 hour.
gpuZonalRedundancyDisabled?	boolean	no	Optional. True if GPU zonal redundancy is disabled on this instance.
iapEnabled?	boolean	no	Optional. IAP settings on the Instance.
ingress?	enum	no	Optional. Provides the ingress settings for this Instance. On output, returns the currently observed ingress settings, or INGRESS_TRAFFIC_UNSPECIFIED if no revision is active.
invokerIamDisabled?	boolean	no	Optional. Disables IAM permission check for run.routes.invoke for callers of this Instance. For more information, visit https://cloud.google.com/run/docs/securing/managing-access#invoker_check.
labels?	record	no
launchStage?	enum	no	The launch stage as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features. For example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be BETA on output.
name?	string	no	The fully qualified name of this Instance. In CreateInstanceRequest, this field is ignored, and instead composed from CreateInstanceRequest.parent and CreateInstanceRequest.instance_id. Format: projects/{project}/locations/{location}/instances/{instance_id}
nodeSelector?	object	no	Hardware constraints configuration.
serviceAccount?	string	no
terminalCondition?	object	no	Defines a status condition for a resource.
timeout?	string	no	Optional. Duration the instance may be active before the system will shut it down.
volumes?	array	no	A list of Volumes to make available to containers.
vpcAccess?	object	no	VPC Access settings. For more information on sending traffic to a VPC network, visit https://cloud.google.com/run/docs/configuring/connecting-vpc.
instanceId?	string	no	Optional. The unique identifier for the Instance. It must begin with letter, and cannot end with hyphen; must contain fewer than 50 characters. The name of the instance becomes {parent}/instances/{instance_id}. If not provided, the server will generate a unique `instance_id`.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a instances

fn get(identifier: string)

Get a instances

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

fn update()

Update instances attributes

fn delete(identifier: string)

Delete the instances

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

fn sync()

Sync instances state from GCP

fn start(etag?: any, validateOnly?: any)

start

Argument	Type	Required	Description
etag?	any	no
validateOnly?	any	no

fn stop(etag?: any, validateOnly?: any)

stop

Argument	Type	Required	Description
etag?	any	no
validateOnly?	any	no

Resources

state(infinite)— A Cloud Run Instance represents a single group of containers running in a reg...

@swamp/gcp/run/jobsv2026.04.23.1jobs.ts

Global Arguments

Argument	Type	Required	Description
annotations?	record	no	Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects. Cloud Run API v2 does not support annotations with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected on new resources. All system annotations in v1 now have a corresponding field in v2 Job. This field follows Kubernetes annotations' namespacing, lim
binaryAuthorization?	object	no	Settings for Binary Authorization feature.
client?	string	no	Arbitrary identifier for the API client.
clientVersion?	string	no	Arbitrary version identifier for the API client.
labels?	record	no	Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels. Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis.com`, `se
latestCreatedExecution?	object	no	Reference to an Execution. Use /Executions.GetExecution with the given name to get full execution including the latest status.
launchStage?	enum	no	The launch stage as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features. For example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be BETA on output.
name?	string	no	The fully qualified name of this Job. Format: projects/{project}/locations/{location}/jobs/{job}
runExecutionToken?	string	no	A unique string used as a suffix for creating a new execution. The Job will become ready when the execution is successfully completed. The sum of job name and token length must be fewer than 63 characters.
startExecutionToken?	string	no	A unique string used as a suffix creating a new execution. The Job will become ready when the execution is successfully started. The sum of job name and token length must be fewer than 63 characters.
template?	object	no	ExecutionTemplate describes the data an execution should have when created from a template.
terminalCondition?	object	no	Defines a status condition for a resource.
jobId?	string	no	Optional. The unique identifier for the Job. The name of the job becomes {parent}/jobs/{job_id}. If not provided, the server will generate a unique `job_id`.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a jobs

fn get(identifier: string)

Get a jobs

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

fn update()

Update jobs attributes

fn delete(identifier: string)

Delete the jobs

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

fn sync()

Sync jobs state from GCP

fn run(etag?: any, overrides?: any, validateOnly?: any)

run

Argument	Type	Required
etag?	any	no
overrides?	any	no
validateOnly?	any	no

Resources

state(infinite)— Job represents the configuration of a single job, which references a containe...

@swamp/gcp/run/jobs-executionsv2026.04.23.1jobs_executions.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn get(identifier: string)

Get a executions

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

fn delete(identifier: string)

Delete the executions

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

fn sync()

Sync executions state from GCP

fn cancel(etag?: any, validateOnly?: any)

cancel

Argument	Type	Required	Description
etag?	any	no
validateOnly?	any	no

fn export_status()

export status

Resources

state(infinite)— Execution represents the configuration of a single execution. A execution an ...

@swamp/gcp/run/jobs-executions-tasksv2026.04.23.1jobs_executions_tasks.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn get(identifier: string)

Get a tasks

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

fn sync()

Sync tasks state from GCP

Resources

state(infinite)— Task represents a single run of a container to completion.

@swamp/gcp/run/servicesv2026.04.23.1services.ts

Global Arguments

Argument	Type	Required	Description
annotations?	record	no	Optional. Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects. Cloud Run API v2 does not support annotations with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected in new resources. All system annotations in v1 now have a corresponding field in v2 Service. This field follows Kubernetes annotations' na
binaryAuthorization?	object	no	Settings for Binary Authorization feature.
buildConfig?	object	no	Describes the Build step of the function that builds a container from the given source.
client?	string	no	Arbitrary identifier for the API client.
clientVersion?	string	no	Arbitrary version identifier for the API client.
customAudiences?	array	no	One or more custom audiences that you want this service to support. Specify each custom audience as the full URL in a string. The custom audiences are encoded in the token and used to authenticate requests. For more information, see https://cloud.google.com/run/docs/configuring/custom-audiences.
defaultUriDisabled?	boolean	no	Optional. Disables public resolution of the default URI of this service.
description?	string	no	User-provided description of the Service. This field currently has a 512-character limit.
iapEnabled?	boolean	no	Optional. IAP settings on the Service.
ingress?	enum	no	Optional. Provides the ingress settings for this Service. On output, returns the currently observed ingress settings, or INGRESS_TRAFFIC_UNSPECIFIED if no revision is active.
invokerIamDisabled?	boolean	no	Optional. Disables IAM permission check for run.routes.invoke for callers of this service. For more information, visit https://cloud.google.com/run/docs/securing/managing-access#invoker_check.
labels?	record	no	Optional. Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels. Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis
launchStage?	enum	no	Optional. The launch stage as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features. For example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be BETA o
multiRegionSettings?	object	no	Settings for multi-region deployment.
name?	string	no	Identifier. The fully qualified name of this Service. In CreateServiceRequest, this field is ignored, and instead composed from CreateServiceRequest.parent and CreateServiceRequest.service_id. Format: projects/{project}/locations/{location}/services/{service_id}
scaling?	object	no	Scaling settings applied at the service level rather than at the revision level.
template?	object	no	RevisionTemplate describes the data a revision should have when created from a template.
terminalCondition?	object	no	Defines a status condition for a resource.
traffic?	array	no	Optional. Specifies how to distribute traffic over a collection of Revisions belonging to the Service. If traffic is empty or not provided, defaults to 100% traffic to the latest `Ready` Revision.
serviceId?	string	no	Optional. The unique identifier for the Service. It must begin with letter, and cannot end with hyphen; must contain fewer than 50 characters. The name of the service becomes {parent}/services/{service_id}. If not provided, the server will generate a unique `service_id`.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a services

fn get(identifier: string)

Get a services

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

fn update()

Update services attributes

fn delete(identifier: string)

Delete the services

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

fn sync()

Sync services state from GCP

Resources

state(infinite)— Service acts as a top-level container that manages a set of configurations an...

@swamp/gcp/run/services-revisionsv2026.04.23.1services_revisions.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn get(identifier: string)

Get a revisions

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

fn delete(identifier: string)

Delete the revisions

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

fn sync()

Sync revisions state from GCP

fn export_status()

export status

Resources

state(infinite)— A Revision is an immutable snapshot of code and configuration. A Revision ref...

@swamp/gcp/run/workerpoolsv2026.04.23.1workerpools.ts

Global Arguments

Argument	Type	Required	Description
annotations?	record	no	Optional. Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects. Cloud Run API v2 does not support annotations with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected in new resources. All system annotations in v1 now have a corresponding field in v2 WorkerPool. This field follows Kubernetes annotations'
binaryAuthorization?	object	no	Settings for Binary Authorization feature.
client?	string	no	Arbitrary identifier for the API client.
clientVersion?	string	no	Arbitrary version identifier for the API client.
description?	string	no	User-provided description of the WorkerPool. This field currently has a 512-character limit.
instanceSplits?	array	no	Optional. Specifies how to distribute instances over a collection of Revisions belonging to the WorkerPool. If instance split is empty or not provided, defaults to 100% instances assigned to the latest `Ready` Revision.
labels?	record	no	Optional. Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels. Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis
launchStage?	enum	no	Optional. The launch stage as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features. For example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be BETA o
name?	string	no	The fully qualified name of this WorkerPool. In CreateWorkerPoolRequest, this field is ignored, and instead composed from CreateWorkerPoolRequest.parent and CreateWorkerPoolRequest.worker_id. Format: `projects/{project}/locations/{location}/workerPools/{worker_id}`
scaling?	object	no	Worker pool scaling settings.
template?	object	no	WorkerPoolRevisionTemplate describes the data a worker pool revision should have when created from a template.
terminalCondition?	object	no	Defines a status condition for a resource.
workerPoolId?	string	no	Optional. The unique identifier for the WorkerPool. It must begin with letter, and cannot end with hyphen; must contain fewer than 50 characters. The name of the worker pool becomes `{parent}/workerPools/{worker_pool_id}`. If not provided, the server will generate a unique `worker_pool_id`.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a workerPools

fn get(identifier: string)

Get a workerPools

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

fn update()

Update workerPools attributes

fn delete(identifier: string)

Delete the workerPools

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

fn sync()

Sync workerPools state from GCP

Resources

state(infinite)— WorkerPool acts as a top-level container that manages a set of configurations...

@swamp/gcp/run/workerpools-revisionsv2026.04.23.1workerpools_revisions.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn get(identifier: string)

Get a revisions

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

fn delete(identifier: string)

Delete the revisions

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

fn sync()

Sync revisions state from GCP

Resources

state(infinite)— A Revision is an immutable snapshot of code and configuration. A Revision ref...

03Previous Versions6

2026.04.11.1Apr 11, 2026

Updated: instances, services, workerpools

Modified 1 models

2026.04.04.1Apr 4, 2026

Updated: instances, jobs, jobs_executions, jobs_executions_tasks, services, services_revisions, workerpools, workerpools_revisions

2026.04.03.3Apr 3, 2026

Updated: instances, jobs, jobs_executions, jobs_executions_tasks, services, services_revisions, workerpools, workerpools_revisions

2026.04.03.1Apr 3, 2026

Updated: instances, jobs, jobs_executions, jobs_executions_tasks, services, services_revisions, workerpools, workerpools_revisions

2026.04.02.2Apr 2, 2026

2026.03.27.1Mar 27, 2026

Added: instances, jobs, jobs_executions, jobs_executions_tasks, services, services_revisions, workerpools, workerpools_revisions

04Stats

100 / 100

Downloads

Archive size

154.1 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 types1/1earned
Has description1/1earned
At least one platform tag (or universal)1/1earned
Two or more platform tags (or universal)1/1earned
License declared1/1earned
Verified public repository2/2earned

Repository

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

05Platforms

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

06Labels

#gcp #google-cloud #run #cloud #infrastructure