@googleapis/sqladmin 34.2.1 → 35.1.0

package/v1.ts

@@ -1118,9 +1118,13 @@ export namespace sqladmin_v1 {
      */
     dnsScope?: string | null;
     /**
-     * The DNS name.
+     * Output only. The DNS name.
      */
     name?: string | null;
+    /**
+     * Output only. The manager for this DNS record.
+     */
+    recordManager?: string | null;
   }
   /**
    * A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); \}
@@ -1130,6 +1134,10 @@ export namespace sqladmin_v1 {
    * The request payload used to execute SQL statements.
    */
   export interface Schema$ExecuteSqlPayload {
+    /**
+     * Optional. Specifies the name of the application that is making the request. This field is used for telemetry. Only alphanumeric characters, dashes, and underscores are allowed. The maximum length is 32 characters.
+     */
+    application?: string | null;
     /**
      * 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.
      */
@@ -1460,6 +1468,10 @@ export namespace sqladmin_v1 {
    * Insights configuration. This specifies when Cloud SQL Insights feature is enabled and optional configuration.
    */
   export interface Schema$InsightsConfig {
+    /**
+     * Optional. Whether enhanced query insights feature is enabled.
+     */
+    enhancedQueryInsightsEnabled?: boolean | null;
     /**
      * Whether Query Insights feature is enabled.
      */
@@ -2160,7 +2172,7 @@ export namespace sqladmin_v1 {
     passwordExpirationTime?: string | null;
   }
   /**
-   * Database instance local user password validation policy
+   * Database instance local user password validation policy. This message defines the password policy for local database users. When enabled, it enforces constraints on password complexity, length, and reuse. Keep this policy enabled to help prevent unauthorized access.
    */
   export interface Schema$PasswordValidationPolicy {
     /**
@@ -2176,7 +2188,7 @@ export namespace sqladmin_v1 {
      */
     disallowUsernameSubstring?: boolean | null;
     /**
-     * Whether the password policy is enabled or not.
+     * Whether to enable the password policy or not. When enabled, passwords must meet complexity requirements. Keep this policy enabled to help prevent unauthorized access. Disabling this policy allows weak passwords.
      */
     enablePasswordPolicy?: boolean | null;
     /**
@@ -2192,6 +2204,35 @@ export namespace sqladmin_v1 {
      */
     reuseInterval?: number | null;
   }
+  /**
+   * Performance Capture configuration.
+   */
+  export interface Schema$PerformanceCaptureConfig {
+    /**
+     * Optional. Enable or disable the Performance Capture feature.
+     */
+    enabled?: boolean | null;
+    /**
+     * Optional. The minimum number of consecutive readings above threshold that triggers instance state capture.
+     */
+    probeThreshold?: number | null;
+    /**
+     * Optional. The time interval in seconds between any two probes.
+     */
+    probingIntervalSeconds?: number | null;
+    /**
+     * Optional. The minimum number of server threads running to trigger the capture on primary.
+     */
+    runningThreadsThreshold?: number | null;
+    /**
+     * Optional. The minimum number of seconds replica must be lagging behind primary to trigger capture on replica.
+     */
+    secondsBehindSourceThreshold?: number | null;
+    /**
+     * Optional. The amount of time in seconds that a transaction needs to have been open before the watcher starts recording it.
+     */
+    transactionDurationThreshold?: number | null;
+  }
   /**
    * Perform disk shrink context.
    */
@@ -2258,6 +2299,14 @@ export namespace sqladmin_v1 {
      * Output only. The name of the read pool node, to be used for retrieving metrics and logs.
      */
     name?: string | null;
+    /**
+     * Output only. The list of settings for requested automatically-setup Private Service Connect (PSC) consumer endpoints that can be used to connect to this read pool node.
+     */
+    pscAutoConnections?: Schema$PscAutoConnectionConfig[];
+    /**
+     * Output only. The Private Service Connect (PSC) service attachment of the read pool node.
+     */
+    pscServiceAttachmentLink?: string | null;
     /**
      * Output only. The current state of the read pool node.
      */
@@ -2659,6 +2708,10 @@ export namespace sqladmin_v1 {
      * The local user password validation policy of the instance.
      */
     passwordValidationPolicy?: Schema$PasswordValidationPolicy;
+    /**
+     * Optional. Configuration for Performance Capture, provides diagnostic metrics during high load situations.
+     */
+    performanceCaptureConfig?: Schema$PerformanceCaptureConfig;
     /**
      * The pricing plan for this instance. This can be either `PER_USE` or `PACKAGE`. Only `PER_USE` is supported for Second Generation instances.
      */
@@ -6735,6 +6788,169 @@ export namespace sqladmin_v1 {
       }
     }
 
+    /**
+     * Adds a new Entra ID certificate for the specified instance. If an Entra ID certificate was previously added but never used in a certificate rotation, this operation replaces that version.
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/sqladmin.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const sqladmin = google.sqladmin('v1');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: [
+     *       'https://www.googleapis.com/auth/cloud-platform',
+     *       'https://www.googleapis.com/auth/sqlservice.admin',
+     *     ],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await sql.instances.addEntraIdCertificate({
+     *     // Required. Cloud SQL instance ID. This does not include the project ID.
+     *     instance: 'placeholder-value',
+     *     // Required. Project ID of the project that contains the instance.
+     *     project: 'placeholder-value',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "acquireSsrsLeaseContext": {},
+     *   //   "apiWarning": {},
+     *   //   "backupContext": {},
+     *   //   "endTime": "my_endTime",
+     *   //   "error": {},
+     *   //   "exportContext": {},
+     *   //   "importContext": {},
+     *   //   "insertTime": "my_insertTime",
+     *   //   "kind": "my_kind",
+     *   //   "name": "my_name",
+     *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
+     *   //   "selfLink": "my_selfLink",
+     *   //   "startTime": "my_startTime",
+     *   //   "status": "my_status",
+     *   //   "subOperationType": {},
+     *   //   "targetId": "my_targetId",
+     *   //   "targetLink": "my_targetLink",
+     *   //   "targetProject": "my_targetProject",
+     *   //   "user": "my_user"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
+     *
+     * @param params - Parameters for request
+     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+     * @param callback - Optional callback that handles the response.
+     * @returns A promise if used with async/await, or void if used with a callback.
+     */
+    addEntraIdCertificate(
+      params: Params$Resource$Instances$Addentraidcertificate,
+      options: StreamMethodOptions
+    ): Promise<GaxiosResponseWithHTTP2<Readable>>;
+    addEntraIdCertificate(
+      params?: Params$Resource$Instances$Addentraidcertificate,
+      options?: MethodOptions
+    ): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+    addEntraIdCertificate(
+      params: Params$Resource$Instances$Addentraidcertificate,
+      options: StreamMethodOptions | BodyResponseCallback<Readable>,
+      callback: BodyResponseCallback<Readable>
+    ): void;
+    addEntraIdCertificate(
+      params: Params$Resource$Instances$Addentraidcertificate,
+      options: MethodOptions | BodyResponseCallback<Schema$Operation>,
+      callback: BodyResponseCallback<Schema$Operation>
+    ): void;
+    addEntraIdCertificate(
+      params: Params$Resource$Instances$Addentraidcertificate,
+      callback: BodyResponseCallback<Schema$Operation>
+    ): void;
+    addEntraIdCertificate(
+      callback: BodyResponseCallback<Schema$Operation>
+    ): void;
+    addEntraIdCertificate(
+      paramsOrCallback?:
+        | Params$Resource$Instances$Addentraidcertificate
+        | BodyResponseCallback<Schema$Operation>
+        | BodyResponseCallback<Readable>,
+      optionsOrCallback?:
+        | MethodOptions
+        | StreamMethodOptions
+        | BodyResponseCallback<Schema$Operation>
+        | BodyResponseCallback<Readable>,
+      callback?:
+        | BodyResponseCallback<Schema$Operation>
+        | BodyResponseCallback<Readable>
+    ):
+      | void
+      | Promise<GaxiosResponseWithHTTP2<Schema$Operation>>
+      | Promise<GaxiosResponseWithHTTP2<Readable>> {
+      let params = (paramsOrCallback ||
+        {}) as Params$Resource$Instances$Addentraidcertificate;
+      let options = (optionsOrCallback || {}) as MethodOptions;
+
+      if (typeof paramsOrCallback === 'function') {
+        callback = paramsOrCallback;
+        params = {} as Params$Resource$Instances$Addentraidcertificate;
+        options = {};
+      }
+
+      if (typeof optionsOrCallback === 'function') {
+        callback = optionsOrCallback;
+        options = {};
+      }
+
+      const rootUrl = options.rootUrl || 'https://sqladmin.googleapis.com/';
+      const parameters = {
+        options: Object.assign(
+          {
+            url: (
+              rootUrl +
+              '/v1/projects/{project}/instances/{instance}/addEntraIdCertificate'
+            ).replace(/([^:]\/)\/+/g, '$1'),
+            method: 'POST',
+            apiVersion: '',
+          },
+          options
+        ),
+        params,
+        requiredParams: ['project', 'instance'],
+        pathParams: ['instance', 'project'],
+        context: this.context,
+      };
+      if (callback) {
+        createAPIRequest<Schema$Operation>(
+          parameters,
+          callback as BodyResponseCallback<unknown>
+        );
+      } else {
+        return createAPIRequest<Schema$Operation>(parameters);
+      }
+    }
+
     /**
      * Adds a new trusted Certificate Authority (CA) version for the specified instance. Required to prepare for a certificate rotation. If a CA version was previously added but never used in a certificate rotation, this operation replaces that version. There cannot be more than one CA version waiting to be rotated in. For instances that have enabled Certificate Authority Service (CAS) based server CA, use AddServerCertificate to add a new server certificate.
      * @example
@@ -7772,6 +7988,7 @@ export namespace sqladmin_v1 {
      *     requestBody: {
      *       // request body parameters
      *       // {
+     *       //   "application": "my_application",
      *       //   "autoIamAuthn": false,
      *       //   "database": "my_database",
      *       //   "partialResultMode": "my_partialResultMode",
@@ -12340,6 +12557,16 @@ export namespace sqladmin_v1 {
      */
     requestBody?: Schema$InstancesAcquireSsrsLeaseRequest;
   }
+  export interface Params$Resource$Instances$Addentraidcertificate extends StandardParameters {
+    /**
+     * Required. Cloud SQL instance ID. This does not include the project ID.
+     */
+    instance?: string;
+    /**
+     * Required. Project ID of the project that contains the instance.
+     */
+    project?: string;
+  }
   export interface Params$Resource$Instances$Addserverca extends StandardParameters {
     /**
      * Cloud SQL instance ID. This does not include the project ID.

package/v1beta4.ts

@@ -1121,9 +1121,13 @@ export namespace sqladmin_v1beta4 {
      */
     dnsScope?: string | null;
     /**
-     * The DNS name.
+     * Output only. The DNS name.
      */
     name?: string | null;
+    /**
+     * Output only. The manager for this DNS record.
+     */
+    recordManager?: string | null;
   }
   /**
    * A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); \}
@@ -1133,6 +1137,10 @@ export namespace sqladmin_v1beta4 {
    * The request payload used to execute SQL statements.
    */
   export interface Schema$ExecuteSqlPayload {
+    /**
+     * Optional. Specifies the name of the application that is making the request. This field is used for telemetry. Only alphanumeric characters, dashes, and underscores are allowed. The maximum length is 32 characters.
+     */
+    application?: string | null;
     /**
      * 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.
      */
@@ -1463,6 +1471,10 @@ export namespace sqladmin_v1beta4 {
    * Insights configuration. This specifies when Cloud SQL Insights feature is enabled and optional configuration.
    */
   export interface Schema$InsightsConfig {
+    /**
+     * Optional. Whether enhanced query insights feature is enabled.
+     */
+    enhancedQueryInsightsEnabled?: boolean | null;
     /**
      * Whether Query Insights feature is enabled.
      */
@@ -2163,7 +2175,7 @@ export namespace sqladmin_v1beta4 {
     passwordExpirationTime?: string | null;
   }
   /**
-   * Database instance local user password validation policy
+   * Database instance local user password validation policy. This message defines the password policy for local database users. When enabled, it enforces constraints on password complexity, length, and reuse. Keep this policy enabled to help prevent unauthorized access.
    */
   export interface Schema$PasswordValidationPolicy {
     /**
@@ -2179,7 +2191,7 @@ export namespace sqladmin_v1beta4 {
      */
     disallowUsernameSubstring?: boolean | null;
     /**
-     * Whether the password policy is enabled or not.
+     * Whether to enable the password policy or not. When enabled, passwords must meet complexity requirements. Keep this policy enabled to help prevent unauthorized access. Disabling this policy allows weak passwords.
      */
     enablePasswordPolicy?: boolean | null;
     /**
@@ -2195,6 +2207,35 @@ export namespace sqladmin_v1beta4 {
      */
     reuseInterval?: number | null;
   }
+  /**
+   * Performance Capture configuration.
+   */
+  export interface Schema$PerformanceCaptureConfig {
+    /**
+     * Optional. Enable or disable the Performance Capture.
+     */
+    enabled?: boolean | null;
+    /**
+     * Optional. The minimum number of consecutive readings above threshold that triggers instance state capture.
+     */
+    probeThreshold?: number | null;
+    /**
+     * Optional. The time interval in seconds between any two probes.
+     */
+    probingIntervalSeconds?: number | null;
+    /**
+     * Optional. The minimum number of server threads running to trigger the capture on primary.
+     */
+    runningThreadsThreshold?: number | null;
+    /**
+     * Optional. The minimum number of seconds replica must be lagging behind primary to trigger capture on replica.
+     */
+    secondsBehindSourceThreshold?: number | null;
+    /**
+     * Optional. The amount of time in seconds that a transaction needs to have been open before the watcher starts recording it.
+     */
+    transactionDurationThreshold?: number | null;
+  }
   /**
    * Perform disk shrink context.
    */
@@ -2261,6 +2302,14 @@ export namespace sqladmin_v1beta4 {
      * Output only. The name of the read pool node, to be used for retrieving metrics and logs.
      */
     name?: string | null;
+    /**
+     * Output only. The list of settings for requested automatically-setup Private Service Connect (PSC) consumer endpoints that can be used to connect to this read pool node.
+     */
+    pscAutoConnections?: Schema$PscAutoConnectionConfig[];
+    /**
+     * Output only. The Private Service Connect (PSC) service attachment of the read pool node.
+     */
+    pscServiceAttachmentLink?: string | null;
     /**
      * Output only. The current state of the read pool node.
      */
@@ -2662,6 +2711,10 @@ export namespace sqladmin_v1beta4 {
      * The local user password validation policy of the instance.
      */
     passwordValidationPolicy?: Schema$PasswordValidationPolicy;
+    /**
+     * Optional. Configuration for Performance Capture, provides diagnostic metrics during high load situations.
+     */
+    performanceCaptureConfig?: Schema$PerformanceCaptureConfig;
     /**
      * The pricing plan for this instance. This can be either `PER_USE` or `PACKAGE`. Only `PER_USE` is supported for Second Generation instances.
      */
@@ -2766,10 +2819,6 @@ export namespace sqladmin_v1beta4 {
      */
     operationId?: string | null;
   }
-  /**
-   * Request for AddEntraIdCertificate RPC.
-   */
-  export interface Schema$SqlInstancesAddEntraIdCertificateRequest {}
   /**
    * Execute SQL statements response.
    */
@@ -6787,12 +6836,6 @@ export namespace sqladmin_v1beta4 {
      *     instance: 'placeholder-value',
      *     // Required. Project ID of the project that contains the instance.
      *     project: 'placeholder-value',
-     *
-     *     // Request body metadata
-     *     requestBody: {
-     *       // request body parameters
-     *       // {}
-     *     },
      *   });
      *   console.log(res.data);
      *
@@ -7957,6 +8000,7 @@ export namespace sqladmin_v1beta4 {
      *     requestBody: {
      *       // request body parameters
      *       // {
+     *       //   "application": "my_application",
      *       //   "autoIamAuthn": false,
      *       //   "database": "my_database",
      *       //   "partialResultMode": "my_partialResultMode",
@@ -12538,11 +12582,6 @@ export namespace sqladmin_v1beta4 {
      * Required. Project ID of the project that contains the instance.
      */
     project?: string;
-
-    /**
-     * Request body metadata
-     */
-    requestBody?: Schema$SqlInstancesAddEntraIdCertificateRequest;
   }
   export interface Params$Resource$Instances$Addserverca extends StandardParameters {
     /**