Skip to main content

Gcp/sqladmin

@swamp/gcp/sqladminv2026.10.24.1· AGPL-3.0-or-later· 2d agoBEHAVIORS
01README

Google Cloud sqladmin infrastructure models

02Release Notes
  • Updated: workloadcaptures
03Behaviors10
backupruns.tsv2026.10.23.1

Global Arguments

ArgumentTypeDescription
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP 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?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
backupKind?enumSpecifies the kind of backup, PHYSICAL or DEFAULT_SNAPSHOT.
description?stringThe description of this run, only applicable to on-demand backups.
diskEncryptionConfiguration?objectOptional. Whether to enforce CMEK log encryption at source. When enforced, transaction logs are encrypted prior to being uploaded to Cloud Storage. If not enforced, then CMEK logs are encrypted by the Cloud Storage service.
diskEncryptionStatus?objectThis is always `sql#diskEncryptionStatus`.
endTime?stringThe time the backup operation completed in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
enqueuedTime?stringThe time the run was enqueued in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
error?objectIdentifies the specific error that occurred.
id?stringThe identifier for this backup run. Unique only for a specific Cloud SQL instance.
instance?stringName of the database instance.
location?stringLocation of the backups.
startTime?stringThe time the backup operation actually started in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
status?enumThe status of this run.
timeZone?stringBackup time zone to prevent restores to an instance with a different time zone. Now relevant only for SQL Server.
type?enumThe type of this run; can be either "AUTOMATED" or "ON_DEMAND" or "FINAL". This field defaults to "ON_DEMAND" and is ignored, when specified for insert requests.
windowStartTime?stringThe start time of the backup window during which this the backup was attempted in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
fn create(waitForReady?: boolean)
Create a backupRuns
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after creation (default: true)
fn get(identifier: string)
Get a backupRuns
ArgumentTypeDescription
identifierstringThe id of the backupRuns
fn delete(identifier: string)
Delete the backupRuns
ArgumentTypeDescription
identifierstringThe id of the backupRuns
fn sync(identifier?: string)
Sync backupRuns state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific backupRuns by id (e.g. one discovered by list)
fn list(maxResults?: number, maxPages?: number)
List backupRuns resources
ArgumentTypeDescription
maxResults?numberMaximum number of backup runs per response.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— A BackupRun resource.
bluegreendeployments.tsv2026.10.23.1

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP 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?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
description?stringOptional. User-provided description for the deployment. The description can be up to 255 characters long.
requestedConfig?objectOptional. The target database major version for the upgrade. For example, `MYSQL_8_0` or `POSTGRES_15`.
sourceInstance?stringRequired. Immutable. Required on create, and immutable. The full resource name of the source instance (the "blue" instance). Format: projects/{project}/instances/{instance}
blueGreenDeploymentId?stringRequired. The ID to use for the blue-green deployment, which will become the final component of the deployment's resource name. The ID must be unique within the given project and location and between 2-63 characters.
parent?stringThe parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456)
fn create()
Create a blueGreenDeployments
fn get(identifier: string)
Get a blueGreenDeployments
ArgumentTypeDescription
identifierstringThe name of the blueGreenDeployments
fn delete(identifier: string)
Delete the blueGreenDeployments
ArgumentTypeDescription
identifierstringThe name of the blueGreenDeployments
fn sync(identifier?: string)
Sync blueGreenDeployments state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific blueGreenDeployments by name (e.g. one discovered by list)
fn list(filter?: string, orderBy?: string, pageSize?: number, maxPages?: number)
List blueGreenDeployments resources
ArgumentTypeDescription
filter?stringOptional. A filter expression that filters the results.
orderBy?stringOptional. A comma-separated list of fields to order the results by.
pageSize?numberOptional. The maximum number of deployments to return. The service may return fewer deployments than this value. If unspecified, at most 500 deployments are returned. The maximum value is 1000; values above 1000 are treated as 1000.
maxPages?numberMaximum number of pages to fetch (default: 10)
fn switchover()
switchover

Resources

state(infinite)— A `BlueGreenDeployment` resource represents a Cloud SQL blue-green deployment...
connect.tsv2026.10.23.1

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP 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?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
fn get(identifier: string)
Get a connect
ArgumentTypeDescription
identifierstringThe name of the connect
fn sync(identifier?: string)
Sync connect state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific connect by name (e.g. one discovered by list)
fn generate_ephemeral_cert(access_token?: any, public_key?: any, readTime?: any, validDuration?: any)
generate ephemeral cert
ArgumentTypeDescription
access_token?any
public_key?any
readTime?any
validDuration?any
fn resolve()
resolve

Resources

state(infinite)— Connect settings retrieval response.
databases.tsv2026.10.23.1

Global Arguments

ArgumentTypeDescription
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP 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?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
charset?stringThe Cloud SQL charset value.
collation?stringThe Cloud SQL collation value.
instance?stringThe name of the Cloud SQL instance. This does not include the project ID.
name?stringThe name of the database in the Cloud SQL instance. This does not include the project ID or instance name.
project?stringThe project ID of the project containing the Cloud SQL database. The Google apps domain is prefixed if applicable.
sqlserverDatabaseDetails?objectThe version of SQL Server with which the database is to be made compatible
location?stringOptional. Region of the Cloud SQL instance.
fn create()
Create a databases
fn get(identifier: string)
Get a databases
ArgumentTypeDescription
identifierstringThe name of the databases
fn update(identifier?: string)
Update databases attributes
ArgumentTypeDescription
identifier?stringTarget a specific databases by name (e.g. one discovered by list)
fn delete(identifier: string)
Delete the databases
ArgumentTypeDescription
identifierstringThe name of the databases
fn sync(identifier?: string)
Sync databases state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific databases by name (e.g. one discovered by list)
fn list(location?: string, maxPages?: number)
List databases resources
ArgumentTypeDescription
location?stringOptional. Region of the Cloud SQL instance.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— Represents a SQL database on the Cloud SQL instance.
flags.tsv2026.10.23.1

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP 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?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
fn get(identifier: string)
Get a flags
ArgumentTypeDescription
identifierstringThe name of the flags
fn sync(identifier?: string)
Sync flags state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific flags by name (e.g. one discovered by list)
fn list(databaseVersion?: string, flagScope?: string, maxPages?: number)
List flags resources
ArgumentTypeDescription
databaseVersion?stringDatabase type and version you want to retrieve flags for. By default, this method returns flags for all database types and versions.
flagScope?stringOptional. Specify the scope of flags to be returned by SqlFlagsListService. Return list of database flags if unspecified.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— A flag resource.
instances.tsv2026.10.23.1

Global Arguments

ArgumentTypeDescription
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP 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?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
backendType?enumThe backend type. `SECOND_GEN`: Cloud SQL database instance. `EXTERNAL`: A database server that is not managed by Google. This property is read-only; use the `tier` property in the `settings` object to determine the database type.
connectionName?stringConnection name of the Cloud SQL instance used in connection strings.
databaseCenterIntegration?enumOptional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default.
databaseCenterIntegrationEnabled?booleanOptional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center.
databaseVersion?enumThe database engine type and version. The `databaseVersion` field cannot be changed after instance creation.
diskEncryptionConfiguration?objectOptional. Whether to enforce CMEK log encryption at source. When enforced, transaction logs are encrypted prior to being uploaded to Cloud Storage. If not enforced, then CMEK logs are encrypted by the Cloud Storage service.
diskEncryptionStatus?objectThis is always `sql#diskEncryptionStatus`.
failoverReplica?objectThe availability status of the failover replica. A false status indicates that the failover replica is out of sync. The primary instance can only failover to the failover replica when the status is true.
gceZone?stringThe Compute Engine zone that the instance is currently serving from. This value could be different from the zone that was specified when the instance was created if the instance has failed over to its secondary zone. WARNING: Changing this might restart the instance.
geminiConfig?objectOutput only. Whether the active query is enabled.
includeReplicasForMajorVersionUpgrade?booleanInput only. Determines whether an in-place major version upgrade of replicas happens when an in-place major version upgrade of a primary instance is initiated.
instanceType?enumThe instance type.
ipAddresses?arrayThe IP address assigned.
maintenanceVersion?stringThe current software version on the instance.
masterInstanceName?stringThe name of the instance which will act as primary in the replication setup.
name?stringName of the Cloud SQL instance. This does not include the project ID.
nodeCount?numberThe number of read pool nodes in a read pool.
onPremisesConfiguration?objectPEM representation of the trusted CA's x509 certificate.
outOfDiskReport?objectThe minimum recommended increase size in GigaBytes This field is consumed by the frontend * Writers: * the proactive database wellness job for OOD. * Readers:
project?stringThe project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.
region?stringThe geographical region of the Cloud SQL instance. It can be one of the [regions](https://cloud.google.com/sql/docs/mysql/locations#location-r) where Cloud SQL operates: For example, `asia-east1`, `europe-west1`, and `us-central1`. The default value is `us-central1`.
replicaConfiguration?objectOptional. Specifies if a SQL Server replica is a cascadable replica. A cascadable replica is a SQL Server cross region replica that supports replica(s) under it.
replicaNames?arrayThe replicas of the instance.
replicationCluster?objectOutput only. Read-only field that indicates whether the replica is a DR replica. This field is not set if the instance is a primary instance.
rootPassword?stringInitial root password. Use only on creation. You must set root passwords before you can connect to PostgreSQL instances.
satisfiesPzs?booleanThis status indicates whether the instance satisfies PZS. The status is reserved for future use.
scheduledMaintenance?objectIf the scheduled maintenance can be rescheduled.
secondaryGceZone?stringThe Compute Engine zone that the failover instance is currently serving from for a regional instance. This value could be different from the zone that was specified when the instance was created if the instance has failed over to its secondary/failover zone.
serverCaCert?objectPEM representation.
serviceAccountEmailAddress?stringThe service account email address assigned to the instance.\\This property is read-only.
settings?objectOptional. Whether the replica is in accelerated mode. This feature is in private preview and requires allowlisting to take effect.
skipPrecheck?booleanOptional. Input only. Determines whether the precheck step is skipped during a major version upgrade.
sqlNetworkArchitecture?enum
state?enumThe current serving state of the Cloud SQL instance.
suspensionReason?arrayIf the instance state is SUSPENDED, the reason for the suspension.
switchTransactionLogsToCloudStorageEnabled?booleanInput only. Whether Cloud SQL is enabled to switch storing point-in-time recovery log files from a data disk to Cloud Storage.
tags?recordOptional. Input only. Immutable. Tag keys and tag values that are bound to this instance. You must represent each item in the map as: `"": ""`. For example, a single resource can have the following tags: ` "123/environment": "production", "123/costCenter": "marketing", ` For more information on tag creation and management, see https://cloud.google.com/resource-manager/docs/tags/tags-overview.
location?stringOptional. Region of the Cloud SQL instance.
reconcilePscNetworking?stringOptional. Set PSC config to the same value as the existing config to reconcile the PSC networking.
reconcilePscNetworkingForce?stringOptional. Set PSC config to the same value as the existing config and force reconcile the PSC networking.
fn create(waitForReady?: boolean)
Create a instances
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after creation (default: true)
fn get(identifier: string)
Get a instances
ArgumentTypeDescription
identifierstringThe name of the instances
fn update(identifier?: string, waitForReady?: boolean)
Update instances attributes
ArgumentTypeDescription
identifier?stringTarget a specific instances by name (e.g. one discovered by list)
waitForReady?booleanWait for the resource to reach a ready state after update (default: true)
fn delete(identifier: string)
Delete the instances
ArgumentTypeDescription
identifierstringThe name of the instances
fn sync(identifier?: string)
Sync instances state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific instances by name (e.g. one discovered by list)
fn list(filter?: string, location?: string, maxResults?: number, maxPages?: number)
List instances resources
ArgumentTypeDescription
filter?stringA filter expression that filters resources listed in the response. The expression is in the form of field:value. For example, 'instanceType:CLOUD_SQL_INSTANCE'. Fields can be nested as needed as per their JSON representation, such as 'settings.userLabels.auto_start:true'. Multiple filter queries are space-separated. For example. 'state:RUNNABLE instanceType:CLOUD_SQL_INSTANCE'. By default, each expression is an AND expression. However, you can include AND and OR expressions explicitly.
location?stringOptional. Region of the Cloud SQL instance.
maxResults?numberThe maximum number of instances to return. The service may return fewer than this value. If unspecified, at most 500 instances are returned. The maximum value is 1000; values above 1000 are coerced to 1000.
maxPages?numberMaximum number of pages to fetch (default: 10)
fn acquire_ssrs_lease(acquireSsrsLeaseContext?: any, location?: any)
acquire ssrs lease
ArgumentTypeDescription
acquireSsrsLeaseContext?any
location?any
fn add_entra_id_certificate(location?: any)
add entra id certificate
ArgumentTypeDescription
location?any
fn add_server_ca(location?: any)
add server ca
ArgumentTypeDescription
location?any
fn add_server_certificate(location?: any)
add server certificate
ArgumentTypeDescription
location?any
fn clone(cloneContext?: any, location?: any)
clone
ArgumentTypeDescription
cloneContext?any
location?any
fn demote(demoteContext?: any, location?: any)
demote
ArgumentTypeDescription
demoteContext?any
location?any
fn demote_master(demoteMasterContext?: any, location?: any)
demote master
ArgumentTypeDescription
demoteMasterContext?any
location?any
fn execute_sql(application?: any, autoIamAuthn?: any, database?: any, partialResultMode?: any, passwordSecretVersion?: any, rowLimit?: any, sqlStatement?: any, user?: any, location?: any)
execute sql
ArgumentTypeDescription
application?any
autoIamAuthn?any
database?any
partialResultMode?any
passwordSecretVersion?any
rowLimit?any
sqlStatement?any
user?any
location?any
fn export(exportContext?: any, location?: any)
export
ArgumentTypeDescription
exportContext?any
location?any
fn failover(failoverContext?: any, location?: any)
failover
ArgumentTypeDescription
failoverContext?any
location?any
fn import(importContext?: any, location?: any)
import
ArgumentTypeDescription
importContext?any
location?any
fn list_entra_id_certificates(location?: any)
list entra id certificates
ArgumentTypeDescription
location?any
fn list_server_cas(location?: any)
list server cas
ArgumentTypeDescription
location?any
fn list_server_certificates(location?: any)
list server certificates
ArgumentTypeDescription
location?any
fn point_in_time_restore(allocatedIpRange?: any, datasource?: any, pointInTime?: any, preferredSecondaryZone?: any, preferredZone?: any, privateNetwork?: any, region?: any, targetInstance?: any, targetInstanceClearSettingsFieldNames?: any, targetInstanceSettings?: any)
point in time restore
ArgumentTypeDescription
allocatedIpRange?any
datasource?any
pointInTime?any
preferredSecondaryZone?any
preferredZone?any
privateNetwork?any
region?any
targetInstance?any
targetInstanceClearSettingsFieldNames?any
targetInstanceSettings?any
fn pre_check_major_version_upgrade(preCheckMajorVersionUpgradeContext?: any, location?: any)
pre check major version upgrade
ArgumentTypeDescription
preCheckMajorVersionUpgradeContext?any
location?any
fn promote_replica(failover?: any, location?: any)
promote replica
ArgumentTypeDescription
failover?any
location?any
fn reencrypt(backupReencryptionConfig?: any, location?: any)
reencrypt
ArgumentTypeDescription
backupReencryptionConfig?any
location?any
fn release_ssrs_lease(location?: any)
release ssrs lease
ArgumentTypeDescription
location?any
fn reset_ssl_config(location?: any, mode?: any)
reset ssl config
ArgumentTypeDescription
location?any
mode?any
fn restart(location?: any)
restart
ArgumentTypeDescription
location?any
fn restore_backup(backup?: any, backupdrBackup?: any, ignoreMaintenanceVersion?: any, restoreBackupContext?: any, restoreInstanceClearOverridesFieldNames?: any, restoreInstanceSettings?: any, location?: any)
restore backup
ArgumentTypeDescription
backup?any
backupdrBackup?any
ignoreMaintenanceVersion?any
restoreBackupContext?any
restoreInstanceClearOverridesFieldNames?any
restoreInstanceSettings?any
location?any
fn rotate_entra_id_certificate(rotateEntraIdCertificateContext?: any, location?: any)
rotate entra id certificate
ArgumentTypeDescription
rotateEntraIdCertificateContext?any
location?any
fn rotate_server_ca(rotateServerCaContext?: any, location?: any)
rotate server ca
ArgumentTypeDescription
rotateServerCaContext?any
location?any
fn rotate_server_certificate(rotateServerCertificateContext?: any, location?: any)
rotate server certificate
ArgumentTypeDescription
rotateServerCertificateContext?any
location?any
fn start_replica(location?: any)
start replica
ArgumentTypeDescription
location?any
fn stop_replica(location?: any)
stop replica
ArgumentTypeDescription
location?any
fn switchover(dbTimeout?: any, location?: any)
switchover
ArgumentTypeDescription
dbTimeout?any
location?any
fn truncate_log(truncateLogContext?: any, location?: any)
truncate log
ArgumentTypeDescription
truncateLogContext?any
location?any

Resources

state(infinite)— A Cloud SQL instance resource.
sslcerts.tsv2026.10.23.1

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP 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?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
commonName?stringUser supplied name. Must be a distinct name from the other certificates for this instance.
instancestringCloud SQL instance ID. This does not include the project ID.
fn create()
Create a sslCerts
fn get(identifier: string)
Get a sslCerts
ArgumentTypeDescription
identifierstringThe name of the sslCerts
fn delete(identifier: string)
Delete the sslCerts
ArgumentTypeDescription
identifierstringThe name of the sslCerts
fn sync(identifier?: string)
Sync sslCerts state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific sslCerts by name (e.g. one discovered by list)
fn list(maxPages?: number)
List sslCerts resources
ArgumentTypeDescription
maxPages?numberMaximum number of pages to fetch (default: 10)
fn create_ephemeral(access_token?: any, public_key?: any, location?: any)
create ephemeral
ArgumentTypeDescription
access_token?any
public_key?any
location?any

Resources

state(infinite)— SslCerts Resource
tiers.tsv2026.10.23.1

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP 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?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
fn get(identifier: string)
Get a tiers
ArgumentTypeDescription
identifierstringThe name of the tiers
fn sync(identifier?: string)
Sync tiers state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific tiers by name (e.g. one discovered by list)
fn list(maxPages?: number)
List tiers resources
ArgumentTypeDescription
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— A Google Cloud SQL service tier resource.
users.tsv2026.10.23.1

Global Arguments

ArgumentTypeDescription
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP 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?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
databaseRoles?arrayOptional. Role memberships of the user
dualPasswordType?enumDual password status for the user.
host?stringOptional. The host from which the user can connect. For `insert` operations, host defaults to an empty string. For `update` operations, host is specified as part of the request URL. The host name cannot be updated after insertion. For a MySQL instance, it's required; for a PostgreSQL or SQL Server instance, it's optional.
iamEmail?stringOptional. The full email for an IAM user. For normal database users, this will not be filled. Only applicable to MySQL database users.
iamStatus?enumIndicates if a group is active or inactive for IAM database authentication.
instance?stringThe name of the Cloud SQL instance. This does not include the project ID. Can be omitted for `update` because it is already specified on the URL.
name?stringThe name of the user in the Cloud SQL instance. Can be omitted for `update` because it is already specified in the URL.
password?stringThe password for the user.
passwordPolicy?objectNumber of failed login attempts allowed before user get locked.
project?stringThe project ID of the project containing the Cloud SQL database. The Google apps domain is prefixed if applicable. Can be omitted for `update` because it is already specified on the URL.
serverRoles?arrayOptional. The server roles for the SQL Server login.
sqlserverUserDetails?objectIndicates if the user has been disabled.
type?enumThe user type. It determines the method to authenticate the user during login. The default is the database's built-in user type.
location?stringOptional. Region of the Cloud SQL instance.
revokeExistingRoles?stringOptional. Specifies whether to revoke existing roles that are not present in the `database_roles` field. If `false` or unset, the database roles specified in `database_roles` are added to the user's existing roles.
revokeExistingServerRoles?stringOptional. Specifies whether to revoke existing roles that are not present in the `server_roles` field. If `false` or unset, the server roles specified in `server_roles` are added to the user's existing server roles.
fn create()
Create a users
fn get(identifier: string)
Get a users
ArgumentTypeDescription
identifierstringThe name of the users
fn update(identifier?: string)
Update users attributes
ArgumentTypeDescription
identifier?stringTarget a specific users by name (e.g. one discovered by list)
fn delete(identifier: string)
Delete the users
ArgumentTypeDescription
identifierstringThe name of the users
fn sync(identifier?: string)
Sync users state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific users by name (e.g. one discovered by list)
fn list(location?: string, maxPages?: number)
List users resources
ArgumentTypeDescription
location?stringOptional. Region of the Cloud SQL instance.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— A Cloud SQL user resource.
workloadcaptures.tsv2026.10.24.1

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP 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?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
instancestringRequired. Cloud SQL instance ID. This does not include the project ID.
fn get(identifier: string)
Get a workloadCaptures
ArgumentTypeDescription
identifierstringThe name of the workloadCaptures
fn sync(identifier?: string)
Sync workloadCaptures state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific workloadCaptures by name (e.g. one discovered by list)
fn list(maxPages?: number)
List workloadCaptures resources
ArgumentTypeDescription
maxPages?numberMaximum number of pages to fetch (default: 10)
fn start(startWorkloadCaptureContext?: any)
start
ArgumentTypeDescription
startWorkloadCaptureContext?any
fn start_replay(startWorkloadReplayContext?: any)
start replay
ArgumentTypeDescription
startWorkloadReplayContext?any
fn stop(stopWorkloadCaptureContext?: any)
stop
ArgumentTypeDescription
stopWorkloadCaptureContext?any
fn stop_replay(stopWorkloadReplayContext?: any)
stop replay
ArgumentTypeDescription
stopWorkloadReplayContext?any

Resources

state(infinite)— Captured workload for an instance.
04Previous Versions19
2026.10.23.2AGPL-3.0-or-later
  • Updated: backupruns, bluegreendeployments, connect, databases, flags, instances, sslcerts, tiers, users, workloadcaptures
2026.10.23.1AGPL-3.0-or-later
  • Updated: workloadcaptures
2026.10.21.1AGPL-3.0-or-later
  • Updated: workloadcaptures
2026.10.14.1AGPL-3.0-or-later(was none)
  • Updated: instances, workloadcaptures
2026.10.13.1
  • Updated: backupruns, bluegreendeployments, connect, databases, flags, instances, sslcerts, tiers, users, workloadcaptures
2026.10.06.1
  • Updated: connect, databases, instances, sslcerts, users, workloadcaptures
2026.09.29.1
  • Updated: databases, instances
2026.09.20.1
  • Added: workloadcaptures
  • Updated: backupruns, instances

Modified 1 behaviors

2026.09.18.1
  • Updated: backupruns, instances

Modified 1 behaviors

2026.09.17.1
  • Added: workloadcaptures
  • Updated: backupruns, instances

Modified 1 behaviors

2026.09.07.1
  • Updated: instances, sslcerts, users
2026.08.29.1
  • Added: bluegreendeployments
  • Updated: backupruns, databases, instances, sslcerts, users
2026.08.12.3
  • Updated: users
2026.08.12.2
  • Updated: backupruns, connect, databases, flags, instances, sslcerts, tiers, users
2026.08.03.1
  • Updated: instances, users
2026.07.29.1
  • Updated: backupruns, connect, databases, flags, instances, sslcerts, tiers, users
2026.07.21.4
  • Updated: connect, instances, users
2026.07.21.1
  • Updated: backupruns, instances, sslcerts, users
2026.07.20.2
  • Updated: connect, instances, users
05Stats
A
100 / 100
Downloads
254
Archive size
148.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
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned
06Platforms
07Labels