@googleapis/alloydb 13.0.1 → 14.0.1

package/build/v1.d.ts

@@ -503,7 +503,7 @@ export declare namespace alloydb_v1 {
      */
     export interface Schema$ContinuousBackupInfo {
         /**
-         * Output only. The earliest restorable time that can be restored to. Output only field.
+         * Output only. The earliest restorable time that can be restored to. If continuous backups and recovery was recently enabled, the earliest restorable time is the creation time of the earliest eligible backup within this cluster's continuous backup recovery window. After a cluster has had continuous backups enabled for the duration of its recovery window, the earliest restorable time becomes "now minus the recovery window". For example, assuming a point in time recovery is attempted at 04/16/2025 3:23:00PM with a 14d recovery window, the earliest restorable time would be 04/02/2025 3:23:00PM. This field is only visible if the CLUSTER_VIEW_CONTINUOUS_BACKUP cluster view is provided.
          */
         earliestRestorableTime?: string | null;
         /**
@@ -515,7 +515,7 @@ export declare namespace alloydb_v1 {
          */
         encryptionInfo?: Schema$EncryptionInfo;
         /**
-         * Output only. Days of the week on which a continuous backup is taken. Output only field. Ignored if passed into the request.
+         * Output only. Days of the week on which a continuous backup is taken.
          */
         schedule?: string[] | null;
     }
@@ -936,6 +936,10 @@ export declare namespace alloydb_v1 {
      * Metadata related to instance-level network configuration.
      */
     export interface Schema$InstanceNetworkConfig {
+        /**
+         * Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.
+         */
+        allocatedIpRangeOverride?: string | null;
         /**
          * Optional. A list of external network authorized to access this instance.
          */
@@ -954,7 +958,7 @@ export declare namespace alloydb_v1 {
         network?: string | null;
     }
     /**
-     * Details regarding the upgrade of instaces associated with a cluster.
+     * Details regarding the upgrade of instances associated with a cluster.
      */
     export interface Schema$InstanceUpgradeDetails {
         /**
@@ -1700,7 +1704,7 @@ export declare namespace alloydb_v1 {
         internalResourceMetadata?: Schema$StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata[];
     }
     /**
-     * DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform.
+     * DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 8
      */
     export interface Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed {
         /**
@@ -1746,6 +1750,10 @@ export declare namespace alloydb_v1 {
          * The external-uri of the signal, using which more information about this signal can be obtained. In GCP, this will take user to SCC page to get more details about signals.
          */
         externalUri?: string | null;
+        /**
+         * This is used to identify the location of the resource. Example: "us-central1"
+         */
+        location?: string | null;
         /**
          * Required. The name of the signal, ex: PUBLIC_SQL_INSTANCE, SQL_LOG_ERROR_VERBOSITY etc.
          */
@@ -1793,7 +1801,7 @@ export declare namespace alloydb_v1 {
          */
         providerDescription?: string | null;
         /**
-         * Required. The type of resource this ID is identifying. Ex redis.googleapis.com/Instance, redis.googleapis.com/Cluster, alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, spanner.googleapis.com/Instance, spanner.googleapis.com/Database, firestore.googleapis.com/Database, sqladmin.googleapis.com/Instance, bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance REQUIRED Please refer go/condor-common-datamodel
+         * Required. The type of resource this ID is identifying. Ex go/keep-sorted start alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance compute.googleapis.com/Instance firestore.googleapis.com/Database, redis.googleapis.com/Instance, redis.googleapis.com/Cluster, oracledatabase.googleapis.com/CloudExadataInfrastructure oracledatabase.googleapis.com/CloudVmCluster oracledatabase.googleapis.com/AutonomousDatabase spanner.googleapis.com/Instance, spanner.googleapis.com/Database, sqladmin.googleapis.com/Instance, go/keep-sorted end REQUIRED Please refer go/condor-common-datamodel
          */
         resourceType?: string | null;
         /**
@@ -2338,6 +2346,56 @@ export declare namespace alloydb_v1 {
         constructor(context: APIRequestContext);
         /**
          * Gets information about a location.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.get({
+         *     // Resource name for the location.
+         *     name: 'projects/my-project/locations/my-location',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "displayName": "my_displayName",
+         *   //   "labels": {},
+         *   //   "locationId": "my_locationId",
+         *   //   "metadata": {},
+         *   //   "name": "my_name"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2352,6 +2410,61 @@ export declare namespace alloydb_v1 {
         get(callback: BodyResponseCallback<Schema$GoogleCloudLocationLocation>): void;
         /**
          * Lists information about the supported locations for this service.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.list({
+         *     // Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.
+         *     extraLocationTypes: 'placeholder-value',
+         *     // A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
+         *     filter: 'placeholder-value',
+         *     // The resource that owns the locations collection, if applicable.
+         *     name: 'projects/my-project',
+         *     // The maximum number of results to return. If not set, the service selects a default.
+         *     pageSize: 'placeholder-value',
+         *     // A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.
+         *     pageToken: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "locations": [],
+         *   //   "nextPageToken": "my_nextPageToken"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2398,6 +2511,93 @@ export declare namespace alloydb_v1 {
         constructor(context: APIRequestContext);
         /**
          * Creates a new Backup in a given project and location.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.backups.create({
+         *     // Required. ID of the requesting object.
+         *     backupId: 'placeholder-value',
+         *     // Required. Value for parent.
+         *     parent: 'projects/my-project/locations/my-location',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Optional. If set, the backend validates the request, but doesn't actually execute it.
+         *     validateOnly: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "annotations": {},
+         *       //   "clusterName": "my_clusterName",
+         *       //   "clusterUid": "my_clusterUid",
+         *       //   "createCompletionTime": "my_createCompletionTime",
+         *       //   "createTime": "my_createTime",
+         *       //   "databaseVersion": "my_databaseVersion",
+         *       //   "deleteTime": "my_deleteTime",
+         *       //   "description": "my_description",
+         *       //   "displayName": "my_displayName",
+         *       //   "encryptionConfig": {},
+         *       //   "encryptionInfo": {},
+         *       //   "etag": "my_etag",
+         *       //   "expiryQuantity": {},
+         *       //   "expiryTime": "my_expiryTime",
+         *       //   "labels": {},
+         *       //   "name": "my_name",
+         *       //   "reconciling": false,
+         *       //   "satisfiesPzs": false,
+         *       //   "sizeBytes": "my_sizeBytes",
+         *       //   "state": "my_state",
+         *       //   "tags": {},
+         *       //   "type": "my_type",
+         *       //   "uid": "my_uid",
+         *       //   "updateTime": "my_updateTime"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2412,6 +2612,62 @@ export declare namespace alloydb_v1 {
         create(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Deletes a single Backup.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.backups.delete({
+         *     // Optional. The current etag of the Backup. If an etag is provided and does not match the current etag of the Backup, deletion will be blocked and an ABORTED error will be returned.
+         *     etag: 'placeholder-value',
+         *     // Required. Name of the resource. For the required format, see the comment on the Backup.name field.
+         *     name: 'projects/my-project/locations/my-location/backups/my-backup',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Optional. If set, the backend validates the request, but doesn't actually execute it.
+         *     validateOnly: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2426,6 +2682,75 @@ export declare namespace alloydb_v1 {
         delete(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Gets details of a single Backup.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.backups.get({
+         *     // Required. Name of the resource
+         *     name: 'projects/my-project/locations/my-location/backups/my-backup',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "annotations": {},
+         *   //   "clusterName": "my_clusterName",
+         *   //   "clusterUid": "my_clusterUid",
+         *   //   "createCompletionTime": "my_createCompletionTime",
+         *   //   "createTime": "my_createTime",
+         *   //   "databaseVersion": "my_databaseVersion",
+         *   //   "deleteTime": "my_deleteTime",
+         *   //   "description": "my_description",
+         *   //   "displayName": "my_displayName",
+         *   //   "encryptionConfig": {},
+         *   //   "encryptionInfo": {},
+         *   //   "etag": "my_etag",
+         *   //   "expiryQuantity": {},
+         *   //   "expiryTime": "my_expiryTime",
+         *   //   "labels": {},
+         *   //   "name": "my_name",
+         *   //   "reconciling": false,
+         *   //   "satisfiesPzs": false,
+         *   //   "sizeBytes": "my_sizeBytes",
+         *   //   "state": "my_state",
+         *   //   "tags": {},
+         *   //   "type": "my_type",
+         *   //   "uid": "my_uid",
+         *   //   "updateTime": "my_updateTime"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2440,6 +2765,62 @@ export declare namespace alloydb_v1 {
         get(callback: BodyResponseCallback<Schema$Backup>): void;
         /**
          * Lists Backups in a given project and location.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.backups.list({
+         *     // Filtering results
+         *     filter: 'placeholder-value',
+         *     // Hint for how to order the results
+         *     orderBy: 'placeholder-value',
+         *     // Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
+         *     pageSize: 'placeholder-value',
+         *     // A token identifying a page of results the server should return.
+         *     pageToken: 'placeholder-value',
+         *     // Required. Parent value for ListBackupsRequest
+         *     parent: 'projects/my-project/locations/my-location',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "backups": [],
+         *   //   "nextPageToken": "my_nextPageToken",
+         *   //   "unreachable": []
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2454,6 +2835,95 @@ export declare namespace alloydb_v1 {
         list(callback: BodyResponseCallback<Schema$ListBackupsResponse>): void;
         /**
          * Updates the parameters of a single Backup.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.backups.patch({
+         *     // Optional. If set to true, update succeeds even if instance is not found. In that case, a new backup is created and `update_mask` is ignored.
+         *     allowMissing: 'placeholder-value',
+         *     // Output only. The name of the backup resource with the format: * projects/{project\}/locations/{region\}/backups/{backup_id\} where the cluster and backup ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the backup resource name is the name of the parent resource: * projects/{project\}/locations/{region\}
+         *     name: 'projects/my-project/locations/my-location/backups/my-backup',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Optional. Field mask is used to specify the fields to be overwritten in the Backup resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
+         *     updateMask: 'placeholder-value',
+         *     // Optional. If set, the backend validates the request, but doesn't actually execute it.
+         *     validateOnly: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "annotations": {},
+         *       //   "clusterName": "my_clusterName",
+         *       //   "clusterUid": "my_clusterUid",
+         *       //   "createCompletionTime": "my_createCompletionTime",
+         *       //   "createTime": "my_createTime",
+         *       //   "databaseVersion": "my_databaseVersion",
+         *       //   "deleteTime": "my_deleteTime",
+         *       //   "description": "my_description",
+         *       //   "displayName": "my_displayName",
+         *       //   "encryptionConfig": {},
+         *       //   "encryptionInfo": {},
+         *       //   "etag": "my_etag",
+         *       //   "expiryQuantity": {},
+         *       //   "expiryTime": "my_expiryTime",
+         *       //   "labels": {},
+         *       //   "name": "my_name",
+         *       //   "reconciling": false,
+         *       //   "satisfiesPzs": false,
+         *       //   "sizeBytes": "my_sizeBytes",
+         *       //   "state": "my_state",
+         *       //   "tags": {},
+         *       //   "type": "my_type",
+         *       //   "uid": "my_uid",
+         *       //   "updateTime": "my_updateTime"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2568,6 +3038,103 @@ export declare namespace alloydb_v1 {
         constructor(context: APIRequestContext);
         /**
          * Creates a new Cluster in a given project and location.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.create({
+         *     // Required. ID of the requesting object.
+         *     clusterId: 'placeholder-value',
+         *     // Required. The location of the new cluster. For the required format, see the comment on the Cluster.name field.
+         *     parent: 'projects/my-project/locations/my-location',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
+         *     validateOnly: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "annotations": {},
+         *       //   "automatedBackupPolicy": {},
+         *       //   "backupSource": {},
+         *       //   "cloudsqlBackupRunSource": {},
+         *       //   "clusterType": "my_clusterType",
+         *       //   "continuousBackupConfig": {},
+         *       //   "continuousBackupInfo": {},
+         *       //   "createTime": "my_createTime",
+         *       //   "databaseVersion": "my_databaseVersion",
+         *       //   "deleteTime": "my_deleteTime",
+         *       //   "displayName": "my_displayName",
+         *       //   "encryptionConfig": {},
+         *       //   "encryptionInfo": {},
+         *       //   "etag": "my_etag",
+         *       //   "initialUser": {},
+         *       //   "labels": {},
+         *       //   "maintenanceSchedule": {},
+         *       //   "maintenanceUpdatePolicy": {},
+         *       //   "migrationSource": {},
+         *       //   "name": "my_name",
+         *       //   "network": "my_network",
+         *       //   "networkConfig": {},
+         *       //   "primaryConfig": {},
+         *       //   "pscConfig": {},
+         *       //   "reconciling": false,
+         *       //   "satisfiesPzs": false,
+         *       //   "secondaryConfig": {},
+         *       //   "sslConfig": {},
+         *       //   "state": "my_state",
+         *       //   "subscriptionType": "my_subscriptionType",
+         *       //   "tags": {},
+         *       //   "trialMetadata": {},
+         *       //   "uid": "my_uid",
+         *       //   "updateTime": "my_updateTime"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2582,6 +3149,103 @@ export declare namespace alloydb_v1 {
         create(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Creates a cluster of type SECONDARY in the given location using the primary cluster as the source.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.createsecondary({
+         *     // Required. ID of the requesting object (the secondary cluster).
+         *     clusterId: 'placeholder-value',
+         *     // Required. The location of the new cluster. For the required format, see the comment on the Cluster.name field.
+         *     parent: 'projects/my-project/locations/my-location',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
+         *     validateOnly: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "annotations": {},
+         *       //   "automatedBackupPolicy": {},
+         *       //   "backupSource": {},
+         *       //   "cloudsqlBackupRunSource": {},
+         *       //   "clusterType": "my_clusterType",
+         *       //   "continuousBackupConfig": {},
+         *       //   "continuousBackupInfo": {},
+         *       //   "createTime": "my_createTime",
+         *       //   "databaseVersion": "my_databaseVersion",
+         *       //   "deleteTime": "my_deleteTime",
+         *       //   "displayName": "my_displayName",
+         *       //   "encryptionConfig": {},
+         *       //   "encryptionInfo": {},
+         *       //   "etag": "my_etag",
+         *       //   "initialUser": {},
+         *       //   "labels": {},
+         *       //   "maintenanceSchedule": {},
+         *       //   "maintenanceUpdatePolicy": {},
+         *       //   "migrationSource": {},
+         *       //   "name": "my_name",
+         *       //   "network": "my_network",
+         *       //   "networkConfig": {},
+         *       //   "primaryConfig": {},
+         *       //   "pscConfig": {},
+         *       //   "reconciling": false,
+         *       //   "satisfiesPzs": false,
+         *       //   "secondaryConfig": {},
+         *       //   "sslConfig": {},
+         *       //   "state": "my_state",
+         *       //   "subscriptionType": "my_subscriptionType",
+         *       //   "tags": {},
+         *       //   "trialMetadata": {},
+         *       //   "uid": "my_uid",
+         *       //   "updateTime": "my_updateTime"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2596,6 +3260,64 @@ export declare namespace alloydb_v1 {
         createsecondary(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Deletes a single Cluster.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.delete({
+         *     // Optional. The current etag of the Cluster. If an etag is provided and does not match the current etag of the Cluster, deletion will be blocked and an ABORTED error will be returned.
+         *     etag: 'placeholder-value',
+         *     // Optional. Whether to cascade delete child instances for given cluster.
+         *     force: 'placeholder-value',
+         *     // Required. The name of the resource. For the required format, see the comment on the Cluster.name field.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
+         *     validateOnly: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2610,6 +3332,67 @@ export declare namespace alloydb_v1 {
         delete(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Exports data from the cluster. Imperative only.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.export({
+         *     // Required. The resource name of the cluster.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "csvExportOptions": {},
+         *       //   "database": "my_database",
+         *       //   "gcsDestination": {},
+         *       //   "sqlExportOptions": {}
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2624,6 +3407,87 @@ export declare namespace alloydb_v1 {
         export(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Gets details of a single Cluster.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.get({
+         *     // Required. The name of the resource. For the required format, see the comment on the Cluster.name field.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *     // Optional. The view of the cluster to return. Returns all default fields if not set.
+         *     view: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "annotations": {},
+         *   //   "automatedBackupPolicy": {},
+         *   //   "backupSource": {},
+         *   //   "cloudsqlBackupRunSource": {},
+         *   //   "clusterType": "my_clusterType",
+         *   //   "continuousBackupConfig": {},
+         *   //   "continuousBackupInfo": {},
+         *   //   "createTime": "my_createTime",
+         *   //   "databaseVersion": "my_databaseVersion",
+         *   //   "deleteTime": "my_deleteTime",
+         *   //   "displayName": "my_displayName",
+         *   //   "encryptionConfig": {},
+         *   //   "encryptionInfo": {},
+         *   //   "etag": "my_etag",
+         *   //   "initialUser": {},
+         *   //   "labels": {},
+         *   //   "maintenanceSchedule": {},
+         *   //   "maintenanceUpdatePolicy": {},
+         *   //   "migrationSource": {},
+         *   //   "name": "my_name",
+         *   //   "network": "my_network",
+         *   //   "networkConfig": {},
+         *   //   "primaryConfig": {},
+         *   //   "pscConfig": {},
+         *   //   "reconciling": false,
+         *   //   "satisfiesPzs": false,
+         *   //   "secondaryConfig": {},
+         *   //   "sslConfig": {},
+         *   //   "state": "my_state",
+         *   //   "subscriptionType": "my_subscriptionType",
+         *   //   "tags": {},
+         *   //   "trialMetadata": {},
+         *   //   "uid": "my_uid",
+         *   //   "updateTime": "my_updateTime"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2638,6 +3502,68 @@ export declare namespace alloydb_v1 {
         get(callback: BodyResponseCallback<Schema$Cluster>): void;
         /**
          * Imports data to the cluster. Imperative only.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.import({
+         *     // Required. The resource name of the cluster.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "csvImportOptions": {},
+         *       //   "database": "my_database",
+         *       //   "gcsUri": "my_gcsUri",
+         *       //   "sqlImportOptions": {},
+         *       //   "user": "my_user"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2652,6 +3578,62 @@ export declare namespace alloydb_v1 {
         import(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Lists Clusters in a given project and location.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.list({
+         *     // Optional. Filtering results
+         *     filter: 'placeholder-value',
+         *     // Optional. Hint for how to order the results
+         *     orderBy: 'placeholder-value',
+         *     // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
+         *     pageSize: 'placeholder-value',
+         *     // A token identifying a page of results the server should return.
+         *     pageToken: 'placeholder-value',
+         *     // Required. The name of the parent resource. For the required format, see the comment on the Cluster.name field. Additionally, you can perform an aggregated list operation by specifying a value with the following format: * projects/{project\}/locations/-
+         *     parent: 'projects/my-project/locations/my-location',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "clusters": [],
+         *   //   "nextPageToken": "my_nextPageToken",
+         *   //   "unreachable": []
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2666,6 +3648,105 @@ export declare namespace alloydb_v1 {
         list(callback: BodyResponseCallback<Schema$ListClustersResponse>): void;
         /**
          * Updates the parameters of a single Cluster.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.patch({
+         *     // Optional. If set to true, update succeeds even if cluster is not found. In that case, a new cluster is created and `update_mask` is ignored.
+         *     allowMissing: 'placeholder-value',
+         *     // Output only. The name of the cluster resource with the format: * projects/{project\}/locations/{region\}/clusters/{cluster_id\} where the cluster ID segment should satisfy the regex expression `[a-z0-9-]+`. For more details see https://google.aip.dev/122. The prefix of the cluster resource name is the name of the parent resource: * projects/{project\}/locations/{region\}
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Optional. Field mask is used to specify the fields to be overwritten in the Cluster resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
+         *     updateMask: 'placeholder-value',
+         *     // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
+         *     validateOnly: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "annotations": {},
+         *       //   "automatedBackupPolicy": {},
+         *       //   "backupSource": {},
+         *       //   "cloudsqlBackupRunSource": {},
+         *       //   "clusterType": "my_clusterType",
+         *       //   "continuousBackupConfig": {},
+         *       //   "continuousBackupInfo": {},
+         *       //   "createTime": "my_createTime",
+         *       //   "databaseVersion": "my_databaseVersion",
+         *       //   "deleteTime": "my_deleteTime",
+         *       //   "displayName": "my_displayName",
+         *       //   "encryptionConfig": {},
+         *       //   "encryptionInfo": {},
+         *       //   "etag": "my_etag",
+         *       //   "initialUser": {},
+         *       //   "labels": {},
+         *       //   "maintenanceSchedule": {},
+         *       //   "maintenanceUpdatePolicy": {},
+         *       //   "migrationSource": {},
+         *       //   "name": "my_name",
+         *       //   "network": "my_network",
+         *       //   "networkConfig": {},
+         *       //   "primaryConfig": {},
+         *       //   "pscConfig": {},
+         *       //   "reconciling": false,
+         *       //   "satisfiesPzs": false,
+         *       //   "secondaryConfig": {},
+         *       //   "sslConfig": {},
+         *       //   "state": "my_state",
+         *       //   "subscriptionType": "my_subscriptionType",
+         *       //   "tags": {},
+         *       //   "trialMetadata": {},
+         *       //   "uid": "my_uid",
+         *       //   "updateTime": "my_updateTime"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2680,6 +3761,66 @@ export declare namespace alloydb_v1 {
         patch(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Promotes a SECONDARY cluster. This turns down replication from the PRIMARY cluster and promotes a secondary cluster into its own standalone cluster. Imperative only.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.promote({
+         *     // Required. The name of the resource. For the required format, see the comment on the Cluster.name field
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "etag": "my_etag",
+         *       //   "requestId": "my_requestId",
+         *       //   "validateOnly": false
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2694,6 +3835,69 @@ export declare namespace alloydb_v1 {
         promote(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Creates a new Cluster in a given project and location, with a volume restored from the provided source, either a backup ID or a point-in-time and a source cluster.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.restore({
+         *     // Required. The name of the parent resource. For the required format, see the comment on the Cluster.name field.
+         *     parent: 'projects/my-project/locations/my-location',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "backupSource": {},
+         *       //   "cluster": {},
+         *       //   "clusterId": "my_clusterId",
+         *       //   "continuousBackupSource": {},
+         *       //   "requestId": "my_requestId",
+         *       //   "validateOnly": false
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2708,6 +3912,66 @@ export declare namespace alloydb_v1 {
         restore(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Restores an AlloyDB cluster from a CloudSQL resource.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.restoreFromCloudSQL({
+         *     // Required. The location of the new cluster. For the required format, see the comment on Cluster.name field.
+         *     parent: 'projects/my-project/locations/my-location',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "cloudsqlBackupRunSource": {},
+         *       //   "cluster": {},
+         *       //   "clusterId": "my_clusterId"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2722,6 +3986,65 @@ export declare namespace alloydb_v1 {
         restoreFromCloudSQL(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Switches the roles of PRIMARY and SECONDARY clusters without any data loss. This promotes the SECONDARY cluster to PRIMARY and sets up the original PRIMARY cluster to replicate from this newly promoted cluster.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.switchover({
+         *     // Required. The name of the resource. For the required format, see the comment on the Cluster.name field
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "requestId": "my_requestId",
+         *       //   "validateOnly": false
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2736,6 +4059,67 @@ export declare namespace alloydb_v1 {
         switchover(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Upgrades a single Cluster. Imperative only.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.upgrade({
+         *     // Required. The resource name of the cluster.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "etag": "my_etag",
+         *       //   "requestId": "my_requestId",
+         *       //   "validateOnly": false,
+         *       //   "version": "my_version"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2948,6 +4332,98 @@ export declare namespace alloydb_v1 {
         constructor(context: APIRequestContext);
         /**
          * Creates a new Instance in a given project and location.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.instances.create({
+         *     // Required. ID of the requesting object.
+         *     instanceId: 'placeholder-value',
+         *     // Required. The name of the parent resource. For the required format, see the comment on the Instance.name field.
+         *     parent: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
+         *     validateOnly: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "activationPolicy": "my_activationPolicy",
+         *       //   "annotations": {},
+         *       //   "availabilityType": "my_availabilityType",
+         *       //   "clientConnectionConfig": {},
+         *       //   "createTime": "my_createTime",
+         *       //   "databaseFlags": {},
+         *       //   "deleteTime": "my_deleteTime",
+         *       //   "displayName": "my_displayName",
+         *       //   "etag": "my_etag",
+         *       //   "gceZone": "my_gceZone",
+         *       //   "instanceType": "my_instanceType",
+         *       //   "ipAddress": "my_ipAddress",
+         *       //   "labels": {},
+         *       //   "machineConfig": {},
+         *       //   "name": "my_name",
+         *       //   "networkConfig": {},
+         *       //   "nodes": [],
+         *       //   "observabilityConfig": {},
+         *       //   "outboundPublicIpAddresses": [],
+         *       //   "pscInstanceConfig": {},
+         *       //   "publicIpAddress": "my_publicIpAddress",
+         *       //   "queryInsightsConfig": {},
+         *       //   "readPoolConfig": {},
+         *       //   "reconciling": false,
+         *       //   "satisfiesPzs": false,
+         *       //   "state": "my_state",
+         *       //   "uid": "my_uid",
+         *       //   "updateTime": "my_updateTime",
+         *       //   "writableNode": {}
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2962,6 +4438,99 @@ export declare namespace alloydb_v1 {
         create(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Creates a new SECONDARY Instance in a given project and location.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.instances.createsecondary({
+         *       // Required. ID of the requesting object.
+         *       instanceId: 'placeholder-value',
+         *       // Required. The name of the parent resource. For the required format, see the comment on the Instance.name field.
+         *       parent: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *       // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *       requestId: 'placeholder-value',
+         *       // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
+         *       validateOnly: 'placeholder-value',
+         *
+         *       // Request body metadata
+         *       requestBody: {
+         *         // request body parameters
+         *         // {
+         *         //   "activationPolicy": "my_activationPolicy",
+         *         //   "annotations": {},
+         *         //   "availabilityType": "my_availabilityType",
+         *         //   "clientConnectionConfig": {},
+         *         //   "createTime": "my_createTime",
+         *         //   "databaseFlags": {},
+         *         //   "deleteTime": "my_deleteTime",
+         *         //   "displayName": "my_displayName",
+         *         //   "etag": "my_etag",
+         *         //   "gceZone": "my_gceZone",
+         *         //   "instanceType": "my_instanceType",
+         *         //   "ipAddress": "my_ipAddress",
+         *         //   "labels": {},
+         *         //   "machineConfig": {},
+         *         //   "name": "my_name",
+         *         //   "networkConfig": {},
+         *         //   "nodes": [],
+         *         //   "observabilityConfig": {},
+         *         //   "outboundPublicIpAddresses": [],
+         *         //   "pscInstanceConfig": {},
+         *         //   "publicIpAddress": "my_publicIpAddress",
+         *         //   "queryInsightsConfig": {},
+         *         //   "readPoolConfig": {},
+         *         //   "reconciling": false,
+         *         //   "satisfiesPzs": false,
+         *         //   "state": "my_state",
+         *         //   "uid": "my_uid",
+         *         //   "updateTime": "my_updateTime",
+         *         //   "writableNode": {}
+         *         // }
+         *       },
+         *     });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2976,6 +4545,62 @@ export declare namespace alloydb_v1 {
         createsecondary(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Deletes a single Instance.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.instances.delete({
+         *     // Optional. The current etag of the Instance. If an etag is provided and does not match the current etag of the Instance, deletion will be blocked and an ABORTED error will be returned.
+         *     etag: 'placeholder-value',
+         *     // Required. The name of the resource. For the required format, see the comment on the Instance.name field.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
+         *     validateOnly: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -2990,6 +4615,65 @@ export declare namespace alloydb_v1 {
         delete(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Forces a Failover for a highly available instance. Failover promotes the HA standby instance as the new primary. Imperative only.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.instances.failover({
+         *     // Required. The name of the resource. For the required format, see the comment on the Instance.name field.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "requestId": "my_requestId",
+         *       //   "validateOnly": false
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3004,6 +4688,82 @@ export declare namespace alloydb_v1 {
         failover(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Gets details of a single Instance.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.instances.get({
+         *     // Required. The name of the resource. For the required format, see the comment on the Instance.name field.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
+         *     // The view of the instance to return.
+         *     view: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "activationPolicy": "my_activationPolicy",
+         *   //   "annotations": {},
+         *   //   "availabilityType": "my_availabilityType",
+         *   //   "clientConnectionConfig": {},
+         *   //   "createTime": "my_createTime",
+         *   //   "databaseFlags": {},
+         *   //   "deleteTime": "my_deleteTime",
+         *   //   "displayName": "my_displayName",
+         *   //   "etag": "my_etag",
+         *   //   "gceZone": "my_gceZone",
+         *   //   "instanceType": "my_instanceType",
+         *   //   "ipAddress": "my_ipAddress",
+         *   //   "labels": {},
+         *   //   "machineConfig": {},
+         *   //   "name": "my_name",
+         *   //   "networkConfig": {},
+         *   //   "nodes": [],
+         *   //   "observabilityConfig": {},
+         *   //   "outboundPublicIpAddresses": [],
+         *   //   "pscInstanceConfig": {},
+         *   //   "publicIpAddress": "my_publicIpAddress",
+         *   //   "queryInsightsConfig": {},
+         *   //   "readPoolConfig": {},
+         *   //   "reconciling": false,
+         *   //   "satisfiesPzs": false,
+         *   //   "state": "my_state",
+         *   //   "uid": "my_uid",
+         *   //   "updateTime": "my_updateTime",
+         *   //   "writableNode": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3018,6 +4778,59 @@ export declare namespace alloydb_v1 {
         get(callback: BodyResponseCallback<Schema$Instance>): void;
         /**
          * Get instance metadata used for a connection.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.instances.getConnectionInfo({
+         *       // Required. The name of the parent resource. The required format is: projects/{project\}/locations/{location\}/clusters/{cluster\}/instances/{instance\}
+         *       parent:
+         *         'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
+         *       // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *       requestId: 'placeholder-value',
+         *     });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "instanceUid": "my_instanceUid",
+         *   //   "ipAddress": "my_ipAddress",
+         *   //   "name": "my_name",
+         *   //   "publicIpAddress": "my_publicIpAddress"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3032,6 +4845,66 @@ export declare namespace alloydb_v1 {
         getConnectionInfo(callback: BodyResponseCallback<Schema$ConnectionInfo>): void;
         /**
          * Injects fault in an instance. Imperative only.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.instances.injectFault({
+         *     // Required. The name of the resource. For the required format, see the comment on the Instance.name field.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "faultType": "my_faultType",
+         *       //   "requestId": "my_requestId",
+         *       //   "validateOnly": false
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3046,6 +4919,62 @@ export declare namespace alloydb_v1 {
         injectFault(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Lists Instances in a given project and location.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.instances.list({
+         *     // Optional. Filtering results
+         *     filter: 'placeholder-value',
+         *     // Optional. Hint for how to order the results
+         *     orderBy: 'placeholder-value',
+         *     // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
+         *     pageSize: 'placeholder-value',
+         *     // A token identifying a page of results the server should return.
+         *     pageToken: 'placeholder-value',
+         *     // Required. The name of the parent resource. For the required format, see the comment on the Instance.name field. Additionally, you can perform an aggregated list operation by specifying a value with one of the following formats: * projects/{project\}/locations/-/clusters/- * projects/{project\}/locations/{region\}/clusters/-
+         *     parent: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "instances": [],
+         *   //   "nextPageToken": "my_nextPageToken",
+         *   //   "unreachable": []
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3060,6 +4989,100 @@ export declare namespace alloydb_v1 {
         list(callback: BodyResponseCallback<Schema$ListInstancesResponse>): void;
         /**
          * Updates the parameters of a single Instance.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.instances.patch({
+         *     // Optional. If set to true, update succeeds even if instance is not found. In that case, a new instance is created and `update_mask` is ignored.
+         *     allowMissing: 'placeholder-value',
+         *     // Output only. The name of the instance resource with the format: * projects/{project\}/locations/{region\}/clusters/{cluster_id\}/instances/{instance_id\} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project\}/locations/{region\}/clusters/{cluster_id\}
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Optional. Field mask is used to specify the fields to be overwritten in the Instance resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
+         *     updateMask: 'placeholder-value',
+         *     // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
+         *     validateOnly: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "activationPolicy": "my_activationPolicy",
+         *       //   "annotations": {},
+         *       //   "availabilityType": "my_availabilityType",
+         *       //   "clientConnectionConfig": {},
+         *       //   "createTime": "my_createTime",
+         *       //   "databaseFlags": {},
+         *       //   "deleteTime": "my_deleteTime",
+         *       //   "displayName": "my_displayName",
+         *       //   "etag": "my_etag",
+         *       //   "gceZone": "my_gceZone",
+         *       //   "instanceType": "my_instanceType",
+         *       //   "ipAddress": "my_ipAddress",
+         *       //   "labels": {},
+         *       //   "machineConfig": {},
+         *       //   "name": "my_name",
+         *       //   "networkConfig": {},
+         *       //   "nodes": [],
+         *       //   "observabilityConfig": {},
+         *       //   "outboundPublicIpAddresses": [],
+         *       //   "pscInstanceConfig": {},
+         *       //   "publicIpAddress": "my_publicIpAddress",
+         *       //   "queryInsightsConfig": {},
+         *       //   "readPoolConfig": {},
+         *       //   "reconciling": false,
+         *       //   "satisfiesPzs": false,
+         *       //   "state": "my_state",
+         *       //   "uid": "my_uid",
+         *       //   "updateTime": "my_updateTime",
+         *       //   "writableNode": {}
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3074,6 +5097,66 @@ export declare namespace alloydb_v1 {
         patch(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Restart an Instance in a cluster. Imperative only.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.instances.restart({
+         *     // Required. The name of the resource. For the required format, see the comment on the Instance.name field.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "nodeIds": [],
+         *       //   "requestId": "my_requestId",
+         *       //   "validateOnly": false
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3252,6 +5335,74 @@ export declare namespace alloydb_v1 {
         constructor(context: APIRequestContext);
         /**
          * Creates a new User in a given project, location, and cluster.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.users.create({
+         *     // Required. Value for parent.
+         *     parent: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Required. ID of the requesting object.
+         *     userId: 'placeholder-value',
+         *     // Optional. If set, the backend validates the request, but doesn't actually execute it.
+         *     validateOnly: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "databaseRoles": [],
+         *       //   "keepExtraRoles": false,
+         *       //   "name": "my_name",
+         *       //   "password": "my_password",
+         *       //   "userType": "my_userType"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "databaseRoles": [],
+         *   //   "keepExtraRoles": false,
+         *   //   "name": "my_name",
+         *   //   "password": "my_password",
+         *   //   "userType": "my_userType"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3266,6 +5417,54 @@ export declare namespace alloydb_v1 {
         create(callback: BodyResponseCallback<Schema$User>): void;
         /**
          * Deletes a single User.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.users.delete({
+         *     // Required. The name of the resource. For the required format, see the comment on the User.name field.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster/users/my-user',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Optional. If set, the backend validates the request, but doesn't actually execute it.
+         *     validateOnly: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {}
+         * }
+         *
+         * 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`.
@@ -3280,6 +5479,56 @@ export declare namespace alloydb_v1 {
         delete(callback: BodyResponseCallback<Schema$Empty>): void;
         /**
          * Gets details of a single User.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.users.get({
+         *     // Required. The name of the resource. For the required format, see the comment on the User.name field.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster/users/my-user',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "databaseRoles": [],
+         *   //   "keepExtraRoles": false,
+         *   //   "name": "my_name",
+         *   //   "password": "my_password",
+         *   //   "userType": "my_userType"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3294,6 +5543,62 @@ export declare namespace alloydb_v1 {
         get(callback: BodyResponseCallback<Schema$User>): void;
         /**
          * Lists Users in a given project and location.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.users.list({
+         *     // Optional. Filtering results
+         *     filter: 'placeholder-value',
+         *     // Optional. Hint for how to order the results
+         *     orderBy: 'placeholder-value',
+         *     // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
+         *     pageSize: 'placeholder-value',
+         *     // Optional. A token identifying a page of results the server should return.
+         *     pageToken: 'placeholder-value',
+         *     // Required. Parent value for ListUsersRequest
+         *     parent: 'projects/my-project/locations/my-location/clusters/my-cluster',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "nextPageToken": "my_nextPageToken",
+         *   //   "unreachable": [],
+         *   //   "users": []
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3308,6 +5613,76 @@ export declare namespace alloydb_v1 {
         list(callback: BodyResponseCallback<Schema$ListUsersResponse>): void;
         /**
          * Updates the parameters of a single User.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.clusters.users.patch({
+         *     // Optional. Allow missing fields in the update mask.
+         *     allowMissing: 'placeholder-value',
+         *     // Output only. Name of the resource in the form of projects/{project\}/locations/{location\}/cluster/{cluster\}/users/{user\}.
+         *     name: 'projects/my-project/locations/my-location/clusters/my-cluster/users/my-user',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Optional. Field mask is used to specify the fields to be overwritten in the User resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
+         *     updateMask: 'placeholder-value',
+         *     // Optional. If set, the backend validates the request, but doesn't actually execute it.
+         *     validateOnly: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "databaseRoles": [],
+         *       //   "keepExtraRoles": false,
+         *       //   "name": "my_name",
+         *       //   "password": "my_password",
+         *       //   "userType": "my_userType"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "databaseRoles": [],
+         *   //   "keepExtraRoles": false,
+         *   //   "name": "my_name",
+         *   //   "password": "my_password",
+         *   //   "userType": "my_userType"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3416,6 +5791,56 @@ export declare namespace alloydb_v1 {
         constructor(context: APIRequestContext);
         /**
          * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.operations.cancel({
+         *     // The name of the operation resource to be cancelled.
+         *     name: 'projects/my-project/locations/my-location/operations/my-operation',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {}
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {}
+         * }
+         *
+         * 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`.
@@ -3430,6 +5855,50 @@ export declare namespace alloydb_v1 {
         cancel(callback: BodyResponseCallback<Schema$Empty>): void;
         /**
          * Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.operations.delete({
+         *     // The name of the operation resource to be deleted.
+         *     name: 'projects/my-project/locations/my-location/operations/my-operation',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {}
+         * }
+         *
+         * 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`.
@@ -3444,6 +5913,56 @@ export declare namespace alloydb_v1 {
         delete(callback: BodyResponseCallback<Schema$Empty>): void;
         /**
          * Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.operations.get({
+         *     // The name of the operation resource.
+         *     name: 'projects/my-project/locations/my-location/operations/my-operation',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3458,6 +5977,59 @@ export declare namespace alloydb_v1 {
         get(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.operations.list({
+         *     // The standard list filter.
+         *     filter: 'placeholder-value',
+         *     // The name of the operation's parent resource.
+         *     name: 'projects/my-project/locations/my-location',
+         *     // The standard list page size.
+         *     pageSize: 'placeholder-value',
+         *     // The standard list page token.
+         *     pageToken: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "nextPageToken": "my_nextPageToken",
+         *   //   "operations": []
+         *   // }
+         * }
+         *
+         * 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`.
@@ -3516,6 +6088,59 @@ export declare namespace alloydb_v1 {
         constructor(context: APIRequestContext);
         /**
          * Lists SupportedDatabaseFlags for a given project and location.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/alloydb.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 alloydb = google.alloydb('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'],
+         *   });
+         *
+         *   // 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 alloydb.projects.locations.supportedDatabaseFlags.list({
+         *     // Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
+         *     pageSize: 'placeholder-value',
+         *     // A token identifying a page of results the server should return.
+         *     pageToken: 'placeholder-value',
+         *     // Required. The name of the parent resource. The required format is: * projects/{project\}/locations/{location\} Regardless of the parent specified here, as long it is contains a valid project and location, the service will return a static list of supported flags resources. Note that we do not yet support region-specific flags.
+         *     parent: 'projects/my-project/locations/my-location',
+         *     // Optional. The scope for which supported flags are requested. If not specified, default is DATABASE.
+         *     scope: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "nextPageToken": "my_nextPageToken",
+         *   //   "supportedDatabaseFlags": []
+         *   // }
+         * }
+         *
+         * 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`.