Gcp/saasservicemgmt

@swamp/gcp/saasservicemgmtv2026.10.23.1· AGPL-3.0-or-later· 3d agoBEHAVIORS

01README

Google Cloud saasservicemgmt infrastructure models

02Release Notes

Updated: locations, releases, rolloutkinds, rollouts, saas, tenants, unitkinds, units

03Behaviors8

@swamp/gcp/saasservicemgmt/locationsv2026.10.23.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)

Resources

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

@swamp/gcp/saasservicemgmt/releasesv2026.10.23.1releases.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.
annotations?	record	no	Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations
blueprint?	object	no	Optional. Blueprints are OCI Images that contain all of the artifacts needed to provision a unit.
inputVariableDefaults?	array	no	Optional. Mapping of input variables to default values. Maximum 100
labels?	record	no	Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels.
name?	string	no	Identifier. The resource name (full URI of the resource) following the standard naming scheme: "projects/{project}/locations/{location}/releases/{release}"
releaseRequirements?	object	no	Optional. Set of requirements to be fulfilled on the Unit when using this Release.
unitKind?	string	no	Required. Immutable. Reference to the UnitKind this Release corresponds to (required and immutable once created).
releaseId?	string	no	Required. The ID value for the new release.
requestId?	string	no	An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was receive
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a releases

fn get(identifier: string)

Get a releases

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

fn update(identifier?: string)

Update releases attributes

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

fn delete(identifier: string)

Delete the releases

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

fn sync(identifier?: string)

Sync releases state from GCP

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

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

List releases resources

Argument	Type	Required	Description
filter?	string	no	Filter the list as specified in https://google.aip.dev/160.
orderBy?	string	no	Order results as specified in https://google.aip.dev/132.
pageSize?	number	no	The maximum number of releases to send per page.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— A new version to be propagated and deployed to units. This includes pointers ...

@swamp/gcp/saasservicemgmt/rolloutkindsv2026.10.23.1rolloutkinds.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.
annotations?	record	no	Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations
allowedCount?	number	no	Optional. The maximum number of failed units allowed in a location without pausing the rollout.
allowedPercentage?	number	no	Optional. The maximum percentage of units allowed to fail (0, 100] within a location without pausing the rollout.
labels?	record	no	Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels.
name?	string	no	Identifier. The resource name (full URI of the resource) following the standard naming scheme: "projects/{project}/locations/{location}/rolloutKinds/{rollout_kind_id}"
rolloutOrchestrationStrategy?	string	no	Optional. The strategy used for executing a Rollout. This is a required field. There are two supported values strategies which are used to control - "Google.Cloud.Simple.AllAtOnce" - "Google.Cloud.Simple.OneLocationAtATime" A rollout with one of these simple strategies will rollout across all locations defined in the associated UnitKind\
unitFilter?	string	no	Optional. [CEL](https://github.com/google/cel-spec) formatted filter string against Unit. The filter will be applied to determine the eligible unit population. This filter can only reduce, but not expand the scope of the rollout.
unitKind?	string	no	Optional. Immutable. UnitKind that this rollout kind corresponds to. Rollouts stemming from this rollout kind will target the units of this unit kind. In other words, this defines the population of target units to be upgraded by rollouts.
unitUpdatePacing?	object	no	Optional. Settings for controlling the pacing of rollouts i.e. the number of units to be rolled out in parallel in a region.
updateUnitKindStrategy?	enum	no	Optional. The config for updating the unit kind. By default, the unit kind will be updated on the rollout start.
requestId?	string	no	An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was receive
rolloutKindId?	string	no	Required. The ID value for the new rollout kind.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a rolloutKinds

fn get(identifier: string)

Get a rolloutKinds

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

fn update(identifier?: string)

Update rolloutKinds attributes

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

fn delete(identifier: string)

Delete the rolloutKinds

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

fn sync(identifier?: string)

Sync rolloutKinds state from GCP

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

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

List rolloutKinds resources

Argument	Type	Required	Description
filter?	string	no	Filter the list as specified in https://google.aip.dev/160.
orderBy?	string	no	Order results as specified in https://google.aip.dev/132.
pageSize?	number	no	The maximum number of rollout kinds to send per page.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— An object that describes various settings of Rollout execution. Includes buil...

@swamp/gcp/saasservicemgmt/rolloutsv2026.10.23.1rollouts.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.
annotations?	record	no	Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations
control?	object	no	Optional. Requested change to the execution of this rollout. Default RolloutControl.action is ROLLOUT_ACTION_RUN meaning the rollout will be executed to completion while progressing through all natural Rollout States (such as RUNNING -> SUCCEEDED or RUNNING -> FAILED). Requests can only be made when the Rollout is in a non-terminal state.
labels?	record	no	Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels.
name?	string	no	Identifier. The resource name (full URI of the resource) following the standard naming scheme: "projects/{project}/locations/{location}/rollout/{rollout_id}"
release?	string	no	Optional. Immutable. Name of the Release that gets rolled out to target Units. Required if no other type of release is specified.
rolloutKind?	string	no	Required. Immutable. Name of the RolloutKind this rollout is stemming from and adhering to.
rolloutOrchestrationStrategy?	string	no	Optional. The strategy used for executing this Rollout. This strategy will override whatever strategy is specified in the RolloutKind. If not specified on creation, the strategy from RolloutKind will be used. There are two supported values strategies which are used to control - "Google.Cloud.Simple.AllAtOnce" - "Google.Cloud.Simple.OneLocationAtATime" A rollout with one of these simple strategies will rollout across all locations defined in the targeted UnitKind\
unitFilter?	string	no	Optional. CEL(https://github.com/google/cel-spec) formatted filter string against Unit. The filter will be applied to determine the eligible unit population. This filter can only reduce, but not expand the scope of the rollout. If not provided, the unit_filter from the RolloutKind will be used.
requestId?	string	no	An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was receive
rolloutId?	string	no	Required. The ID value for the new rollout.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a rollouts

fn get(identifier: string)

Get a rollouts

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

fn update(identifier?: string)

Update rollouts attributes

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

fn delete(identifier: string)

Delete the rollouts

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

fn sync(identifier?: string)

Sync rollouts state from GCP

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

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

List rollouts resources

Argument	Type	Required	Description
filter?	string	no	Filter the list as specified in https://google.aip.dev/160.
orderBy?	string	no	Order results as specified in https://google.aip.dev/132.
pageSize?	number	no	The maximum number of rollouts to send per page.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— Represents a single rollout execution and its results

@swamp/gcp/saasservicemgmt/saasv2026.10.23.1saas.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.
annotations?	record	no	Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations
applicationTemplate?	object	no	Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions.
labels?	record	no	Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels.
locations?	array	no	Optional. List of locations that the service is available in. Rollout refers to the list to generate a rollout plan.
name?	string	no	Identifier. The resource name (full URI of the resource) following the standard naming scheme: "projects/{project}/locations/{location}/saas/{saas}"
requestId?	string	no	An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was receive
saasId?	string	no	Required. The ID value for the new saas.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a saas

fn get(identifier: string)

Get a saas

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

fn update(identifier?: string)

Update saas attributes

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

fn delete(identifier: string)

Delete the saas

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

fn sync(identifier?: string)

Sync saas state from GCP

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

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

List saas resources

Argument	Type	Required	Description
filter?	string	no	Filter the list as specified in https://google.aip.dev/160.
orderBy?	string	no	Order results as specified in https://google.aip.dev/132.
pageSize?	number	no	The maximum number of saas to send per page.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— Saas is a representation of a SaaS service managed by the Producer.

@swamp/gcp/saasservicemgmt/tenantsv2026.10.23.1tenants.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.
annotations?	record	no	Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations
consumerResource?	string	no	Optional. Immutable. A reference to the consumer resource this SaaS Tenant is representing. The relationship with a consumer resource can be used by App Lifecycle Manager for retrieving consumer-defined settings and policies such as maintenance policies (using Unified Maintenance Policy API).
labels?	record	no	Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels.
name?	string	no	Identifier. The resource name (full URI of the resource) following the standard naming scheme: "projects/{project}/locations/{location}/tenants/{tenant}"
saas?	string	no	Required. Immutable. A reference to the Saas that defines the product (managed service) that the producer wants to manage with App Lifecycle Manager. Part of the App Lifecycle Manager common data model.
requestId?	string	no	An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was receive
tenantId?	string	no	Required. The ID value for the new tenant.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a tenants

fn get(identifier: string)

Get a tenants

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

fn update(identifier?: string)

Update tenants attributes

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

fn delete(identifier: string)

Delete the tenants

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

fn sync(identifier?: string)

Sync tenants state from GCP

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

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

List tenants resources

Argument	Type	Required	Description
filter?	string	no	Filter the list as specified in https://google.aip.dev/160.
orderBy?	string	no	Order results as specified in https://google.aip.dev/132.
pageSize?	number	no	The maximum number of tenants to send per page.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— Tenant represents the service producer side of an instance of the service cre...

@swamp/gcp/saasservicemgmt/unitkindsv2026.10.23.1unitkinds.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.
annotations?	record	no	Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations
appParams?	object	no	Optional. AppParams contains the parameters for creating an AppHub Application.
applicationTemplateComponent?	object	no	Optional. Reference to component and revision in a composite ApplicationTemplate.
defaultRelease?	string	no	Optional. A reference to the Release object to use as default for creating new units of this UnitKind (optional). If not specified, a new unit must explicitly reference which release to use for its creation.
dependencies?	array	no	Optional. Immutable. List of other unit kinds that this release will depend on. Dependencies will be automatically provisioned if not found. Maximum 10.
inputVariableMappings?	array	no	Optional. List of inputVariables for this release that will either be retrieved from a dependency's outputVariables, or will be passed on to a dependency's inputVariables. Maximum 100.
labels?	record	no	Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels.
name?	string	no	Identifier. The resource name (full URI of the resource) following the standard naming scheme: "projects/{project}/locations/{location}/unitKinds/{unitKind}"
outputVariableMappings?	array	no	Optional. List of outputVariables for this unit kind will be passed to this unit's outputVariables. Maximum 100.
saas?	string	no	Required. Immutable. A reference to the Saas that defines the product (managed service) that the producer wants to manage with App Lifecycle Manager. Part of the App Lifecycle Manager common data model. Immutable once set.
requestId?	string	no	An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was receive
unitKindId?	string	no	Required. The ID value for the new unit kind.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a unitKinds

fn get(identifier: string)

Get a unitKinds

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

fn update(identifier?: string)

Update unitKinds attributes

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

fn delete(identifier: string)

Delete the unitKinds

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

fn sync(identifier?: string)

Sync unitKinds state from GCP

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

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

List unitKinds resources

Argument	Type	Required	Description
filter?	string	no	Filter the list as specified in https://google.aip.dev/160.
orderBy?	string	no	Order results as specified in https://google.aip.dev/132.
pageSize?	number	no	The maximum number of unit kinds to send per page.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— Definition of a Unit. Units belonging to the same UnitKind are managed togeth...

@swamp/gcp/saasservicemgmt/unitsv2026.10.23.1units.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.
annotations?	record	no	Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations
application?	string	no	Optional. Reference to the AppHub Application this unit belongs to. All resources deployed in this Unit will be associated with the specified Application.
labels?	record	no	Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels.
maintenance?	object	no	Optional. Captures requested directives for performing future maintenance on the unit. This includes a request for the unit to skip maintenance for a period of time and remain pinned to its current release as well as controls for postponing maintenance scheduled in future.
managementMode?	enum	no	Optional. Immutable. Indicates whether the Unit life cycle is controlled by the user or by the system. Immutable once created.
name?	string	no	Identifier. The resource name (full URI of the resource) following the standard naming scheme: "projects/{project}/locations/{location}/units/{unit}"
tenant?	string	no	Optional. Reference to the Saas Tenant resource this unit belongs to. This for example informs the maintenance policies to use for scheduling future updates on a unit. (optional and immutable once created)
unitKind?	string	no	Optional. Reference to the UnitKind this Unit belongs to. Immutable once set.
requestId?	string	no	An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was receive
unitId?	string	no	Required. The ID value for the new unit.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a units

fn get(identifier: string)

Get a units

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

fn update(identifier?: string)

Update units attributes

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

fn delete(identifier: string)

Delete the units

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

fn sync(identifier?: string)

Sync units state from GCP

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

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

List units resources

Argument	Type	Required	Description
filter?	string	no	Filter the list as specified in https://google.aip.dev/160.
orderBy?	string	no	Order results as specified in https://google.aip.dev/132.
pageSize?	number	no	The maximum number of units to send per page.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— A unit of deployment that has its lifecycle via a CRUD API using an actuation...

04Previous Versions19

2026.10.15.1AGPL-3.0-or-later(was none)Oct 19, 2026

Updated: releases, rollouts, saas, unitkinds, units

2026.10.13.1Oct 13, 2026

Updated: locations, releases, rolloutkinds, rollouts, saas, tenants, unitkinds, units

2026.10.08.1Oct 8, 2026

Updated: releases, rolloutkinds, unitkinds, units

2026.09.26.1Sep 26, 2026

Updated: rolloutkinds

2026.08.12.2Aug 12, 2026

Updated: locations, releases, rolloutkinds, rollouts, saas, tenants, unitkinds, units

2026.07.29.1Jul 30, 2026

Updated: locations, releases, rolloutkinds, rollouts, saas, tenants, unitkinds, units

2026.07.21.4Jul 21, 2026

Updated: locations, releases, rolloutkinds, rollouts, saas, tenants, unitkinds, units

2026.07.21.1Jul 21, 2026

Updated: releases, rolloutkinds, rollouts, saas, unitkinds, units

2026.07.20.2Jul 20, 2026

Updated: locations, releases, rolloutkinds, rollouts, saas, tenants, unitkinds, units

2026.07.20.1Jul 20, 2026

Updated: locations, releases, rolloutkinds, rollouts, saas, tenants, unitkinds, units

2026.07.19.2Jul 19, 2026

Updated: locations

2026.07.19.1Jul 19, 2026

Updated: locations, releases, rolloutkinds, rollouts, saas, tenants, unitkinds, units

2026.07.18.2Jul 18, 2026

Updated: locations, releases, rolloutkinds, rollouts, saas, tenants, unitkinds, units

2026.07.17.2Jul 17, 2026

Updated: releases, rolloutkinds, rollouts, saas, tenants, unitkinds, units

2026.07.17.1Jul 17, 2026

Updated: releases, rolloutkinds, rollouts, saas, tenants, unitkinds, units

2026.06.24.1Jun 23, 2026

Updated: rolloutkinds, unitkinds, units

Removed 2 behaviors

2026.06.12.1Jun 12, 2026

Updated: rolloutkinds, saasreleases, unitgroups

2026.06.08.2Jun 8, 2026

Updated: locations, releases, rolloutkinds, rollouts, saas, saasreleases, tenants, unitgroups, unitkinds, units

2026.06.07.1Jun 7, 2026

Updated: locations, releases, rolloutkinds, rollouts, saas, saasreleases, tenants, unitgroups, unitkinds, units

05Stats

100 / 100

Downloads

Archive size

104.5 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 #saasservicemgmt #cloud #infrastructure