@maxim_mazurok/gapi.client.sqladmin-v1 0.0.20250717 → 0.1.20250807

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://sqladmin.googleapis.com/$discovery/rest?version=v1
-// Revision: 20250717
+// Revision: 20250807
 
 /// <reference types="gapi.client" />
 
@@ -231,12 +231,22 @@ declare namespace gapi.client {
       preferredSecondaryZone?: string;
       /** Optional. Copy clone and point-in-time recovery clone of an instance to the specified zone. If no zone is specified, clone to the same primary zone as the source instance. This field applies to all DB types. */
       preferredZone?: string;
+      /** The timestamp used to identify the time when the source instance is deleted. If this instance is deleted, then you must set the timestamp. */
+      sourceInstanceDeletionTime?: string;
+    }
+    interface Column {
+      /** Name of the column. */
+      name?: string;
+      /** Datatype of the column. */
+      type?: string;
     }
     interface ConnectionPoolConfig {
       /** Whether managed connection pooling is enabled. */
       connectionPoolingEnabled?: boolean;
       /** Optional. List of connection pool configuration flags. */
       flags?: ConnectionPoolFlags[];
+      /** Output only. Number of connection poolers. */
+      poolerCount?: number;
     }
     interface ConnectionPoolFlags {
       /** Required. The name of the flag. */
@@ -269,6 +279,8 @@ declare namespace gapi.client {
       ipAddresses?: IpMapping[];
       /** This is always `sql#connectSettings`. */
       kind?: string;
+      /** Optional. Output only. mdx_protocol_support controls how the client uses metadata exchange when connecting to the instance. The values in the list representing parts of the MDX protocol that are supported by this instance. When the list is empty, the instance does not support MDX, so the client must not send an MDX request. The default is empty. */
+      mdxProtocolSupport?: string[];
       /** The number of read pool nodes in a read pool. */
       nodeCount?: number;
       /** Output only. Entries containing information about each read pool node of the read pool. */
@@ -312,8 +324,6 @@ declare namespace gapi.client {
       availableMaintenanceVersions?: string[];
       /** The 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. */
       backendType?: string;
-      /** Clears private network settings when the instance is restored. */
-      clearNetwork?: boolean;
       /** Connection name of the Cloud SQL instance used in connection strings. */
       connectionName?: string;
       /** Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. */
@@ -494,6 +504,16 @@ declare namespace gapi.client {
       name?: string;
     }
     interface Empty {}
+    interface ExecuteSqlPayload {
+      /** Optional. When set to true, the API caller identity associated with the request is used for database authentication. The API caller must be an IAM user in the database. */
+      autoIamAuthn?: boolean;
+      /** Optional. Name of the database on which the statement will be executed. */
+      database?: string;
+      /** Optional. The maximum number of rows returned per SQL statement. */
+      rowLimit?: string;
+      /** Required. SQL statements to run on the database. It can be a single statement or a sequence of statements separated by semicolons. */
+      sqlStatement?: string;
+    }
     interface ExportContext {
       /** Options for exporting BAK files (SQL Server-only) */
       bakExportOptions?: {
@@ -580,6 +600,12 @@ declare namespace gapi.client {
       /** The current settings version of this instance. Request will be rejected if this version doesn't match the current settings version. */
       settingsVersion?: string;
     }
+    interface FinalBackupConfig {
+      /** Whether the final backup is enabled for the instance. */
+      enabled?: boolean;
+      /** The number of days to retain the final backup after the instance deletion. The final backup will be purged at (time_of_instance_deletion + retention_days). */
+      retentionDays?: number;
+    }
     interface Flag {
       /** Use this field if only certain integers are accepted. Can be combined with min_value and max_value to add additional values. */
       allowedIntValues?: string[];
@@ -805,6 +831,8 @@ declare namespace gapi.client {
       backupdrBackup?: string;
       /** Parameters required to perform the restore backup operation. */
       restoreBackupContext?: RestoreBackupContext;
+      /** Optional. This field has the same purpose as restore_instance_settings, changes any instance settings stored in the backup you are restoring from. With the difference that these fields are cleared in the settings. */
+      restoreInstanceClearOverridesFieldNames?: string[];
       /** Optional. By using this parameter, Cloud SQL overrides any instance settings stored in the backup you are restoring from. You can't change the instance's major database version and you can only increase the disk size. You can use this field to restore new instances only. This field is not applicable for restore to existing instances. */
       restoreInstanceSettings?: DatabaseInstance;
     }
@@ -886,6 +914,10 @@ declare namespace gapi.client {
       /** Maintenance timing settings: `canary`, `stable`, or `week5`. For more information, see [About maintenance on Cloud SQL instances](https://cloud.google.com/sql/docs/mysql/maintenance). */
       updateTrack?: string;
     }
+    interface Metadata {
+      /** The time taken to execute the SQL statements. */
+      sqlStatementExecutionTime?: string;
+    }
     interface MySqlReplicaConfiguration {
       /** PEM representation of the trusted CA's x509 certificate. */
       caCertificate?: string;
@@ -1042,7 +1074,7 @@ declare namespace gapi.client {
       targetSizeGb?: string;
     }
     interface PointInTimeRestoreContext {
-      /** Optional. The name of the allocated IP range for the internal IP Cloud SQL instance. For example: "google-managed-services-default". If you set this, then Cloud SQL creates the IP address for the cloned instance in the allocated range. This range must comply with [RFC 1035](https://tools.ietf.org/html/rfc1035) standards. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. Reserved for future use. http://go/speckle-subnet-picker-clone */
+      /** Optional. The name of the allocated IP range for the internal IP Cloud SQL instance. For example: "google-managed-services-default". If you set this, then Cloud SQL creates the IP address for the cloned instance in the allocated range. This range must comply with [RFC 1035](https://tools.ietf.org/html/rfc1035) standards. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. Reserved for future use. */
       allocatedIpRange?: string;
       /** The Google Cloud Backup and Disaster Recovery Datasource URI. Format: projects/{project}/locations/{region}/backupVaults/{backupvault}/dataSources/{datasource}. */
       datasource?: string;
@@ -1093,6 +1125,16 @@ declare namespace gapi.client {
       /** Whether PSC connectivity is enabled for this instance. */
       pscEnabled?: boolean;
     }
+    interface QueryResult {
+      /** List of columns included in the result. This also includes the data type of the column. */
+      columns?: Column[];
+      /** Message related to the SQL execution result. */
+      message?: string;
+      /** Set to true if the SQL execution's result is truncated due to size limits. */
+      partialResult?: boolean;
+      /** Rows returned by the SQL statement. */
+      rows?: Row[];
+    }
     interface ReplicaConfiguration {
       /** Optional. 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. */
       cascadableReplica?: boolean;
@@ -1139,6 +1181,10 @@ declare namespace gapi.client {
       /** The fingerprint of the next version to be rotated to. If left unspecified, will be rotated to the most recently added server certificate version. */
       nextVersion?: string;
     }
+    interface Row {
+      /** The values for the row. */
+      values?: Value[];
+    }
     interface SelectedObjects {
       /** Required. The name of the database to migrate. */
       database?: string;
@@ -1188,6 +1234,8 @@ declare namespace gapi.client {
       enableDataplexIntegration?: boolean;
       /** Optional. When this parameter is set to true, Cloud SQL instances can connect to Vertex AI to pass requests for real-time predictions and insights to the AI. The default value is false. This applies only to Cloud SQL for MySQL and Cloud SQL for PostgreSQL instances. */
       enableGoogleMlIntegration?: boolean;
+      /** Optional. The final backup configuration for the instance. */
+      finalBackupConfig?: FinalBackupConfig;
       /** Insights configuration, for now relevant only for Postgres. */
       insightsConfig?: InsightsConfig;
       /** The settings for IP Management. This allows to enable or disable the instance IP and manage which external networks can connect to the instance. The IPv4 address cannot be disabled for Second Generation instances. */
@@ -1224,10 +1272,18 @@ declare namespace gapi.client {
       userLabels?: {[P in string]: string};
     }
     interface SqlActiveDirectoryConfig {
+      /** Optional. The secret manager key storing the administrator credential. (e.g., projects/{project}/secrets/{secret}). */
+      adminCredentialSecretName?: string;
+      /** Optional. Domain controller IPv4 addresses used to bootstrap Active Directory. */
+      dnsServers?: string[];
       /** The name of the domain (e.g., mydomain.com). */
       domain?: string;
       /** This is always sql#activeDirectoryConfig. */
       kind?: string;
+      /** Optional. The mode of the Active Directory configuration. */
+      mode?: string;
+      /** Optional. The organizational unit distinguished name. This is the full hierarchical path to the organizational unit. */
+      organizationalUnit?: string;
     }
     interface SqlExternalSyncSettingError {
       /** Additional information about the error encountered. */
@@ -1241,6 +1297,12 @@ declare namespace gapi.client {
       /** The unique identifier for this operation. */
       operationId?: string;
     }
+    interface SqlInstancesExecuteSqlResponse {
+      /** The additional metadata information regarding the execution of the SQL statements. */
+      metadata?: Metadata;
+      /** The list of results after executing all the SQL statements. */
+      results?: QueryResult[];
+    }
     interface SqlInstancesGetDiskShrinkConfigResponse {
       /** This is always `sql#getDiskShrinkConfig`. */
       kind?: string;
@@ -1269,6 +1331,8 @@ declare namespace gapi.client {
       migrationType?: string;
       /** MySQL-specific settings for start external sync. */
       mysqlSyncConfig?: MySqlSyncConfig;
+      /** Optional. MySQL only. True if end-user has confirmed that this SES call will wipe replica databases overlapping with the proposed selected_objects. If this field is not set and there are both overlapping and additional databases proposed, an error will be returned. */
+      replicaOverwriteEnabled?: boolean;
       /** Whether to skip the verification step (VESS). */
       skipVerification?: boolean;
       /** External sync mode. */
@@ -1466,6 +1530,12 @@ declare namespace gapi.client {
       /** Unused. */
       nextPageToken?: string;
     }
+    interface Value {
+      /** If cell value is null, then this flag will be set to true. */
+      nullValue?: boolean;
+      /** The cell value in string format. */
+      value?: string;
+    }
     interface BackupRunsResource {
       /** Deletes the backup taken by a backup run. */
       delete(request?: {
@@ -2591,6 +2661,68 @@ declare namespace gapi.client {
         },
         body: InstancesDemoteMasterRequest,
       ): Request<Operation>;
+      /** Execute SQL statements. */
+      executeSql(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Required. Database instance ID. This does not include the project ID. */
+        instance: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Required. Project ID of the project that contains the instance. */
+        project: string;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: ExecuteSqlPayload;
+      }): Request<SqlInstancesExecuteSqlResponse>;
+      executeSql(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** Required. Database instance ID. This does not include the project ID. */
+          instance: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Required. Project ID of the project that contains the instance. */
+          project: string;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: ExecuteSqlPayload,
+      ): Request<SqlInstancesExecuteSqlResponse>;
       /** Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump or CSV file. */
       export(request: {
         /** V1 error format. */
@@ -3802,6 +3934,8 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
+        /** The timestamp used to identify the time when the source instance is deleted. If this instance is deleted, then you must set the timestamp. */
+        sourceInstanceDeletionTime?: string;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.sqladmin-v1",
-  "version": "0.0.20250717",
+  "version": "0.1.20250807",
   "description": "TypeScript typings for Cloud SQL Admin API v1",
   "repository": {
     "type": "git",

package/readme.md

@@ -257,6 +257,14 @@ await gapi.client.sql.instances.demoteMaster({
   project: 'project',
 });
 
+/*
+Execute SQL statements.
+*/
+await gapi.client.sql.instances.executeSql({
+  instance: 'instance',
+  project: 'project',
+});
+
 /*
 Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump or CSV file.
 */
@@ -523,3 +531,5 @@ Updates an existing user in a Cloud SQL instance.
 */
 await gapi.client.sql.users.update({instance: 'instance', project: 'project'});
 ```
+
+For provenance information see [Provenance section on NPM](https://www.npmjs.com/package/@maxim_mazurok/gapi.client.sqladmin-v1#Provenance:~:text=none-,Provenance,-Built%20and%20signed)