@googleapis/sqladmin 33.0.0 → 34.2.0

package/v1.ts

@@ -550,7 +550,7 @@ export namespace sqladmin_v1 {
      */
     databaseNames?: string[] | null;
     /**
-     * Name of the Cloud SQL instance to be created as a clone.
+     * Required. Name of the Cloud SQL instance to be created as a clone.
      */
     destinationInstanceName?: string | null;
     /**
@@ -1139,7 +1139,7 @@ export namespace sqladmin_v1 {
      */
     database?: string | null;
     /**
-     * Optional. Controls how the API should respond when the SQL execution result exceeds 10 MB. The default mode is to throw an error.
+     * Optional. Controls how the API should respond when the SQL execution result is incomplete due to the size limit or another error. The default mode is to throw an error.
      */
     partialResultMode?: string | null;
     /**
@@ -1512,7 +1512,7 @@ export namespace sqladmin_v1 {
    */
   export interface Schema$InstancesCloneRequest {
     /**
-     * Contains details about the clone operation.
+     * Required. Contains details about the clone operation.
      */
     cloneContext?: Schema$CloneContext;
   }
@@ -1561,6 +1561,23 @@ export namespace sqladmin_v1 {
      */
     importContext?: Schema$ImportContext;
   }
+  /**
+   * Instances ListEntraIdCertificates response.
+   */
+  export interface Schema$InstancesListEntraIdCertificatesResponse {
+    /**
+     * The `sha1_fingerprint` of the active certificate from `certs`.
+     */
+    activeVersion?: string | null;
+    /**
+     * List of Entra ID certificates for the instance.
+     */
+    certs?: Schema$SslCert[];
+    /**
+     * This is always `sql#instancesListEntraIdCertificates`.
+     */
+    kind?: string | null;
+  }
   /**
    * Database instances list response.
    */
@@ -1660,6 +1677,15 @@ export namespace sqladmin_v1 {
      */
     restoreInstanceSettings?: Schema$DatabaseInstance;
   }
+  /**
+   * Rotate Entra ID certificate request.
+   */
+  export interface Schema$InstancesRotateEntraIdCertificateRequest {
+    /**
+     * Optional. Contains details about the rotate server certificate operation.
+     */
+    rotateEntraIdCertificateContext?: Schema$RotateEntraIdCertificateContext;
+  }
   /**
    * Rotate server CA request.
    */
@@ -1744,6 +1770,10 @@ export namespace sqladmin_v1 {
      * Optional. The resource name of the server CA pool for an instance with `CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects/{PROJECT\}/locations/{REGION\}/caPools/{CA_POOL_ID\}
      */
     serverCaPool?: string | null;
+    /**
+     * Optional. Controls the automatic server certificate rotation feature. This feature is disabled by default. When enabled, the server certificate will be automatically rotated during Cloud SQL scheduled maintenance or self-service maintenance updates up to six months before it expires. This setting can only be set if server_ca_mode is either GOOGLE_MANAGED_CAS_CA or CUSTOMER_MANAGED_CAS_CA.
+     */
+    serverCertificateRotationMode?: string | null;
     /**
      * Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections.
      */
@@ -2172,7 +2202,7 @@ export namespace sqladmin_v1 {
     targetSizeGb?: string | null;
   }
   /**
-   * The context to perform a point-in-time recovery of an instance managed by Google Cloud Backup and Disaster Recovery.
+   * The context to perform a point-in-time recovery of an instance managed by Backup and Disaster Recovery (DR) Service.
    */
   export interface Schema$PointInTimeRestoreContext {
     /**
@@ -2180,7 +2210,7 @@ export namespace sqladmin_v1 {
      */
     allocatedIpRange?: string | null;
     /**
-     * The Google Cloud Backup and Disaster Recovery Datasource URI. Format: projects/{project\}/locations/{region\}/backupVaults/{backupvault\}/dataSources/{datasource\}.
+     * The Backup and Disaster Recovery (DR) Service Datasource URI. Format: projects/{project\}/locations/{region\}/backupVaults/{backupvault\}/dataSources/{datasource\}.
      */
     datasource?: string | null;
     /**
@@ -2326,13 +2356,17 @@ export namespace sqladmin_v1 {
      */
     message?: string | null;
     /**
-     * Set to true if the SQL execution's result is truncated due to size limits.
+     * Set to true if the SQL execution's result is truncated due to size limits or an error retrieving results.
      */
     partialResult?: boolean | null;
     /**
      * Rows returned by the SQL statement.
      */
     rows?: Schema$Row[];
+    /**
+     * If results were truncated due to an error, details of that error.
+     */
+    status?: Schema$Status;
   }
   /**
    * The read pool auto-scale configuration.
@@ -2436,6 +2470,19 @@ export namespace sqladmin_v1 {
      */
     project?: string | null;
   }
+  /**
+   * Instance rotate Entra ID certificate context.
+   */
+  export interface Schema$RotateEntraIdCertificateContext {
+    /**
+     * Optional. This is always `sql#rotateEntraIdCertificateContext`.
+     */
+    kind?: string | null;
+    /**
+     * Optional. 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 | null;
+  }
   /**
    * Instance rotate server CA context.
    */
@@ -2500,6 +2547,10 @@ export namespace sqladmin_v1 {
      * The App Engine app IDs that can access this instance. (Deprecated) Applied to First Generation instances only.
      */
     authorizedGaeApplications?: string[] | null;
+    /**
+     * Optional. Cloud SQL for MySQL auto-upgrade configuration. When this parameter is set to true, auto-upgrade is enabled for MySQL 8.0 minor versions. The MySQL version must be 8.0.35 or higher.
+     */
+    autoUpgradeEnabled?: boolean | null;
     /**
      * Availability type. Potential values: * `ZONAL`: The instance serves data from only one zone. Outages in that zone affect data accessibility. * `REGIONAL`: The instance can serve data from more than one zone in a region (it is highly available)./ For more information, see [Overview of the High Availability Configuration](https://cloud.google.com/sql/docs/mysql/high-availability).
      */
@@ -2524,6 +2575,10 @@ export namespace sqladmin_v1 {
      * Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property was only applicable to First Generation instances.
      */
     crashSafeReplicationEnabled?: boolean | null;
+    /**
+     * This parameter controls whether to allow using ExecuteSql API to connect to the instance. Not allowed by default.
+     */
+    dataApiAccess?: string | null;
     /**
      * The database flags passed to the instance at startup.
      */
@@ -2572,6 +2627,10 @@ export namespace sqladmin_v1 {
      * 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 | null;
+    /**
+     * Optional. The Microsoft Entra ID configuration for the SQL Server instance.
+     */
+    entraidConfig?: Schema$SqlServerEntraIdConfig;
     /**
      * Optional. The final backup configuration for the instance.
      */
@@ -2720,6 +2779,10 @@ export namespace sqladmin_v1 {
      * The list of results after executing all the SQL statements.
      */
     results?: Schema$QueryResult[];
+    /**
+     * Contains the error from the database if the SQL execution failed.
+     */
+    status?: Schema$Status;
   }
   /**
    * Instance get disk shrink config response.
@@ -2921,6 +2984,23 @@ export namespace sqladmin_v1 {
      */
     recoveryModel?: string | null;
   }
+  /**
+   * SQL Server Entra ID configuration.
+   */
+  export interface Schema$SqlServerEntraIdConfig {
+    /**
+     * Optional. The application ID for the Entra ID configuration.
+     */
+    applicationId?: string | null;
+    /**
+     * Output only. This is always sql#sqlServerEntraIdConfig
+     */
+    kind?: string | null;
+    /**
+     * Optional. The tenant ID for the Entra ID configuration.
+     */
+    tenantId?: string | null;
+  }
   /**
    * Represents a Sql Server user on the Cloud SQL instance.
    */
@@ -3053,6 +3133,23 @@ export namespace sqladmin_v1 {
      */
     kind?: string | null;
   }
+  /**
+   * The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
+   */
+  export interface Schema$Status {
+    /**
+     * The status code, which should be an enum value of google.rpc.Code.
+     */
+    code?: number | null;
+    /**
+     * A list of messages that carry the error details. There is a common set of message types for APIs to use.
+     */
+    details?: Array<{[key: string]: any}> | null;
+    /**
+     * A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+     */
+    message?: string | null;
+  }
   /**
    * Initial sync flags for certain Cloud SQL APIs. Currently used for the MySQL external server initial dump.
    */
@@ -3134,6 +3231,10 @@ export namespace sqladmin_v1 {
    * A Cloud SQL user resource.
    */
   export interface Schema$User {
+    /**
+     * Optional. Role memberships of the user
+     */
+    databaseRoles?: string[] | null;
     /**
      * Dual password status for the user.
      */
@@ -3146,6 +3247,10 @@ export namespace sqladmin_v1 {
      * Optional. 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.
      */
     host?: string | null;
+    /**
+     * Optional. The full email for an IAM user. For normal database users, this will not be filled. Only applicable to MySQL database users.
+     */
+    iamEmail?: string | null;
     /**
      * Indicates if a group is active or inactive for IAM database authentication.
      */
@@ -6996,9 +7101,9 @@ export namespace sqladmin_v1 {
      *
      *   // Do the magic
      *   const res = await sql.instances.clone({
-     *     // The ID of the Cloud SQL instance to be cloned (source). This does not include the project ID.
+     *     // Required. The ID of the Cloud SQL instance to be cloned (source). This does not include the project ID.
      *     instance: 'placeholder-value',
-     *     // Project ID of the source as well as the clone Cloud SQL instance.
+     *     // Required. Project ID of the source as well as the clone Cloud SQL instance.
      *     project: 'placeholder-value',
      *
      *     // Request body metadata
@@ -7690,7 +7795,8 @@ export namespace sqladmin_v1 {
      *   // {
      *   //   "messages": [],
      *   //   "metadata": {},
-     *   //   "results": []
+     *   //   "results": [],
+     *   //   "status": {}
      *   // }
      * }
      *
@@ -8160,9 +8266,9 @@ export namespace sqladmin_v1 {
      *
      *   // Do the magic
      *   const res = await sql.instances.get({
-     *     // Database instance ID. This does not include the project ID.
+     *     // Required. Database instance ID. This does not include the project ID.
      *     instance: 'placeholder-value',
-     *     // Project ID of the project that contains the instance.
+     *     // Required. Project ID of the project that contains the instance.
      *     project: 'placeholder-value',
      *   });
      *   console.log(res.data);
@@ -8846,6 +8952,160 @@ export namespace sqladmin_v1 {
       }
     }
 
+    /**
+     * Lists all versions of EntraID certificates for the specified instance. There can be up to three sets of certificates listed: the certificate that is currently in use, a future that has been added but not yet used to sign a certificate, and a certificate that has been rotated out.
+     * @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.ListEntraIdCertificates({
+     *     // 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
+     *   // {
+     *   //   "activeVersion": "my_activeVersion",
+     *   //   "certs": [],
+     *   //   "kind": "my_kind"
+     *   // }
+     * }
+     *
+     * 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.
+     */
+    ListEntraIdCertificates(
+      params: Params$Resource$Instances$Listentraidcertificates,
+      options: StreamMethodOptions
+    ): Promise<GaxiosResponseWithHTTP2<Readable>>;
+    ListEntraIdCertificates(
+      params?: Params$Resource$Instances$Listentraidcertificates,
+      options?: MethodOptions
+    ): Promise<
+      GaxiosResponseWithHTTP2<Schema$InstancesListEntraIdCertificatesResponse>
+    >;
+    ListEntraIdCertificates(
+      params: Params$Resource$Instances$Listentraidcertificates,
+      options: StreamMethodOptions | BodyResponseCallback<Readable>,
+      callback: BodyResponseCallback<Readable>
+    ): void;
+    ListEntraIdCertificates(
+      params: Params$Resource$Instances$Listentraidcertificates,
+      options:
+        | MethodOptions
+        | BodyResponseCallback<Schema$InstancesListEntraIdCertificatesResponse>,
+      callback: BodyResponseCallback<Schema$InstancesListEntraIdCertificatesResponse>
+    ): void;
+    ListEntraIdCertificates(
+      params: Params$Resource$Instances$Listentraidcertificates,
+      callback: BodyResponseCallback<Schema$InstancesListEntraIdCertificatesResponse>
+    ): void;
+    ListEntraIdCertificates(
+      callback: BodyResponseCallback<Schema$InstancesListEntraIdCertificatesResponse>
+    ): void;
+    ListEntraIdCertificates(
+      paramsOrCallback?:
+        | Params$Resource$Instances$Listentraidcertificates
+        | BodyResponseCallback<Schema$InstancesListEntraIdCertificatesResponse>
+        | BodyResponseCallback<Readable>,
+      optionsOrCallback?:
+        | MethodOptions
+        | StreamMethodOptions
+        | BodyResponseCallback<Schema$InstancesListEntraIdCertificatesResponse>
+        | BodyResponseCallback<Readable>,
+      callback?:
+        | BodyResponseCallback<Schema$InstancesListEntraIdCertificatesResponse>
+        | BodyResponseCallback<Readable>
+    ):
+      | void
+      | Promise<
+          GaxiosResponseWithHTTP2<Schema$InstancesListEntraIdCertificatesResponse>
+        >
+      | Promise<GaxiosResponseWithHTTP2<Readable>> {
+      let params = (paramsOrCallback ||
+        {}) as Params$Resource$Instances$Listentraidcertificates;
+      let options = (optionsOrCallback || {}) as MethodOptions;
+
+      if (typeof paramsOrCallback === 'function') {
+        callback = paramsOrCallback;
+        params = {} as Params$Resource$Instances$Listentraidcertificates;
+        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}/listEntraIdCertificates'
+            ).replace(/([^:]\/)\/+/g, '$1'),
+            method: 'GET',
+            apiVersion: '',
+          },
+          options
+        ),
+        params,
+        requiredParams: ['project', 'instance'],
+        pathParams: ['instance', 'project'],
+        context: this.context,
+      };
+      if (callback) {
+        createAPIRequest<Schema$InstancesListEntraIdCertificatesResponse>(
+          parameters,
+          callback as BodyResponseCallback<unknown>
+        );
+      } else {
+        return createAPIRequest<Schema$InstancesListEntraIdCertificatesResponse>(
+          parameters
+        );
+      }
+    }
+
     /**
      * Lists all of the trusted Certificate Authorities (CAs) for the specified instance. There can be up to three CAs listed: the CA that was used to sign the certificate that is currently in use, a CA that has been added but not yet used to sign a certificate, and a CA used to sign a certificate that has previously rotated out.
      * @example
@@ -10691,6 +10951,177 @@ export namespace sqladmin_v1 {
       }
     }
 
+    /**
+     * Rotates the server certificate version to one previously added with the addEntraIdCertificate method.
+     * @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.RotateEntraIdCertificate({
+     *     // 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',
+     *
+     *     // Request body metadata
+     *     requestBody: {
+     *       // request body parameters
+     *       // {
+     *       //   "rotateEntraIdCertificateContext": {}
+     *       // }
+     *     },
+     *   });
+     *   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.
+     */
+    RotateEntraIdCertificate(
+      params: Params$Resource$Instances$Rotateentraidcertificate,
+      options: StreamMethodOptions
+    ): Promise<GaxiosResponseWithHTTP2<Readable>>;
+    RotateEntraIdCertificate(
+      params?: Params$Resource$Instances$Rotateentraidcertificate,
+      options?: MethodOptions
+    ): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+    RotateEntraIdCertificate(
+      params: Params$Resource$Instances$Rotateentraidcertificate,
+      options: StreamMethodOptions | BodyResponseCallback<Readable>,
+      callback: BodyResponseCallback<Readable>
+    ): void;
+    RotateEntraIdCertificate(
+      params: Params$Resource$Instances$Rotateentraidcertificate,
+      options: MethodOptions | BodyResponseCallback<Schema$Operation>,
+      callback: BodyResponseCallback<Schema$Operation>
+    ): void;
+    RotateEntraIdCertificate(
+      params: Params$Resource$Instances$Rotateentraidcertificate,
+      callback: BodyResponseCallback<Schema$Operation>
+    ): void;
+    RotateEntraIdCertificate(
+      callback: BodyResponseCallback<Schema$Operation>
+    ): void;
+    RotateEntraIdCertificate(
+      paramsOrCallback?:
+        | Params$Resource$Instances$Rotateentraidcertificate
+        | 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$Rotateentraidcertificate;
+      let options = (optionsOrCallback || {}) as MethodOptions;
+
+      if (typeof paramsOrCallback === 'function') {
+        callback = paramsOrCallback;
+        params = {} as Params$Resource$Instances$Rotateentraidcertificate;
+        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}/rotateEntraIdCertificate'
+            ).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);
+      }
+    }
+
     /**
      * Rotates the server certificate to one signed by the Certificate Authority (CA) version previously added with the addServerCA method. For instances that have enabled Certificate Authority Service (CAS) based server CA, use RotateServerCertificate to rotate the server certificate.
      * @example
@@ -11942,11 +12373,11 @@ export namespace sqladmin_v1 {
   }
   export interface Params$Resource$Instances$Clone extends StandardParameters {
     /**
-     * The ID of the Cloud SQL instance to be cloned (source). This does not include the project ID.
+     * Required. The ID of the Cloud SQL instance to be cloned (source). This does not include the project ID.
      */
     instance?: string;
     /**
-     * Project ID of the source as well as the clone Cloud SQL instance.
+     * Required. Project ID of the source as well as the clone Cloud SQL instance.
      */
     project?: string;
 
@@ -12061,11 +12492,11 @@ export namespace sqladmin_v1 {
   }
   export interface Params$Resource$Instances$Get extends StandardParameters {
     /**
-     * Database instance ID. This does not include the project ID.
+     * Required. Database instance ID. This does not include the project ID.
      */
     instance?: string;
     /**
-     * Project ID of the project that contains the instance.
+     * Required. Project ID of the project that contains the instance.
      */
     project?: string;
   }
@@ -12113,6 +12544,17 @@ export namespace sqladmin_v1 {
      */
     project?: string;
   }
+  export interface Params$Resource$Instances$Listentraidcertificates
+    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$Listservercas
     extends StandardParameters {
     /**
@@ -12262,6 +12704,22 @@ export namespace sqladmin_v1 {
      */
     requestBody?: Schema$InstancesRestoreBackupRequest;
   }
+  export interface Params$Resource$Instances$Rotateentraidcertificate
+    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;
+
+    /**
+     * Request body metadata
+     */
+    requestBody?: Schema$InstancesRotateEntraIdCertificateRequest;
+  }
   export interface Params$Resource$Instances$Rotateserverca
     extends StandardParameters {
     /**
@@ -12542,9 +13000,9 @@ export namespace sqladmin_v1 {
      *
      *   // Do the magic
      *   const res = await sql.operations.get({
-     *     // Instance operation ID.
+     *     // Required. Instance operation ID.
      *     operation: 'placeholder-value',
-     *     // Project ID of the project that contains the instance.
+     *     // Required. Project ID of the project that contains the instance.
      *     project: 'placeholder-value',
      *   });
      *   console.log(res.data);
@@ -12830,11 +13288,11 @@ export namespace sqladmin_v1 {
   }
   export interface Params$Resource$Operations$Get extends StandardParameters {
     /**
-     * Instance operation ID.
+     * Required. Instance operation ID.
      */
     operation?: string;
     /**
-     * Project ID of the project that contains the instance.
+     * Required. Project ID of the project that contains the instance.
      */
     project?: string;
   }
@@ -15355,9 +15813,11 @@ export namespace sqladmin_v1 {
      *
      *   // Example response
      *   // {
+     *   //   "databaseRoles": [],
      *   //   "dualPasswordType": "my_dualPasswordType",
      *   //   "etag": "my_etag",
      *   //   "host": "my_host",
+     *   //   "iamEmail": "my_iamEmail",
      *   //   "iamStatus": "my_iamStatus",
      *   //   "instance": "my_instance",
      *   //   "kind": "my_kind",
@@ -15507,9 +15967,11 @@ export namespace sqladmin_v1 {
      *     requestBody: {
      *       // request body parameters
      *       // {
+     *       //   "databaseRoles": [],
      *       //   "dualPasswordType": "my_dualPasswordType",
      *       //   "etag": "my_etag",
      *       //   "host": "my_host",
+     *       //   "iamEmail": "my_iamEmail",
      *       //   "iamStatus": "my_iamStatus",
      *       //   "instance": "my_instance",
      *       //   "kind": "my_kind",
@@ -15818,6 +16280,8 @@ export namespace sqladmin_v1 {
      *
      *   // Do the magic
      *   const res = await sql.users.update({
+     *     // Optional. List of database roles to grant to the user. body.database_roles will be ignored for update request.
+     *     databaseRoles: 'placeholder-value',
      *     // Optional. Host of the user in the instance.
      *     host: 'placeholder-value',
      *     // Database instance ID. This does not include the project ID.
@@ -15831,9 +16295,11 @@ export namespace sqladmin_v1 {
      *     requestBody: {
      *       // request body parameters
      *       // {
+     *       //   "databaseRoles": [],
      *       //   "dualPasswordType": "my_dualPasswordType",
      *       //   "etag": "my_etag",
      *       //   "host": "my_host",
+     *       //   "iamEmail": "my_iamEmail",
      *       //   "iamStatus": "my_iamStatus",
      *       //   "instance": "my_instance",
      *       //   "kind": "my_kind",
@@ -16029,6 +16495,10 @@ export namespace sqladmin_v1 {
     project?: string;
   }
   export interface Params$Resource$Users$Update extends StandardParameters {
+    /**
+     * Optional. List of database roles to grant to the user. body.database_roles will be ignored for update request.
+     */
+    databaseRoles?: string[];
     /**
      * Optional. Host of the user in the instance.
      */