@googleapis/alloydb 19.1.0 → 21.0.0

package/build/v1beta.d.ts

@@ -605,13 +605,9 @@ export declare namespace alloydb_v1beta {
      */
     export interface Schema$ConnectionPoolConfig {
         /**
-         * Optional. Deprecated. Use 'flags' instead. The default pool size. Defaults to 20. Note: This field should not be added to client libraries if not present already.
+         * Output only. The number of running AuthProxy poolers per instance.
          */
-        defaultPoolSize?: string | null;
-        /**
-         * Optional. Deprecated; Prefer 'enabled' as this will be removed soon.
-         */
-        enable?: boolean | null;
+        authproxyPoolerCount?: number | null;
         /**
          * Optional. Whether to enable Managed Connection Pool (MCP).
          */
@@ -622,42 +618,10 @@ export declare namespace alloydb_v1beta {
         flags?: {
             [key: string]: string;
         } | null;
-        /**
-         * Optional. Deprecated. Use 'flags' instead. The list of startup parameters to ignore. Defaults to ["extra_float_digits"] Note: This field should not be added to client libraries if not present already.
-         */
-        ignoreStartupParameters?: string[] | null;
-        /**
-         * Optional. Deprecated. Use 'flags' instead. The maximum number of client connections allowed. Note: This field should not be added to client libraries if not present already.
-         */
-        maxClientConn?: string | null;
-        /**
-         * Optional. Deprecated. Use 'flags' instead. The maximum number of prepared statements allowed. MCP makes sure that any statement prepared by a client, up to this limit, is available on the backing server connection in transaction and statement pooling mode. Even if the statement was originally prepared on another server connection. Defaults to 0. Note: This field should not be added to client libraries if not present already.
-         */
-        maxPreparedStatements?: string | null;
-        /**
-         * Optional. Deprecated. Use 'flags' instead. The minimum pool size. Defaults to 0. Note: This field should not be added to client libraries if not present already.
-         */
-        minPoolSize?: string | null;
         /**
          * Output only. The number of running poolers per instance.
          */
         poolerCount?: number | null;
-        /**
-         * Optional. Deprecated. Use 'flags' instead. The pool mode. Defaults to `POOL_MODE_TRANSACTION`. Note: This field should not be added to client libraries if not present already.
-         */
-        poolMode?: string | null;
-        /**
-         * Optional. Deprecated. Use 'flags' instead. The maximum number of seconds queries are allowed to spend waiting for execution. If the query is not assigned to a server during that time, the client is disconnected. 0 disables. Note: This field should not be added to client libraries if not present already.
-         */
-        queryWaitTimeout?: string | null;
-        /**
-         * Optional. Deprecated. Use 'flags' instead. The maximum number of seconds a server is allowed to be idle before it is disconnected. 0 disables. Note: This field should not be added to client libraries if not present already.
-         */
-        serverIdleTimeout?: string | null;
-        /**
-         * Optional. Deprecated. Use 'flags' instead. The list of users that are allowed to connect to the MCP stats console. The users must exist in the database. Note: This field should not be added to client libraries if not present already.
-         */
-        statsUsers?: string[] | null;
     }
     /**
      * ContinuousBackupConfig describes the continuous backups recovery configurations of a cluster.
@@ -791,6 +755,19 @@ export declare namespace alloydb_v1beta {
          */
         time?: Schema$GoogleTypeTimeOfDay;
     }
+    /**
+     * The DNS config for the endpoint, containing the DNS record name, type and targets.
+     */
+    export interface Schema$DNSConfig {
+        /**
+         * The fully qualified domain name (FQDN) of the DNS record, e.g., ".location.alloydb-psa.goog".
+         */
+        dnsName?: string | null;
+        /**
+         * The type of the DNS record, e.g., "A", "AAAA", "CNAME".
+         */
+        dnsRecordType?: string | null;
+    }
     /**
      * A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); \}
      */
@@ -818,6 +795,69 @@ export declare namespace alloydb_v1beta {
          */
         kmsKeyVersions?: string[] | null;
     }
+    /**
+     * Endpoint resource.
+     */
+    export interface Schema$Endpoint {
+        /**
+         * Annotations to allow client tools to store small amount of arbitrary data. This is distinct from labels. https://google.aip.dev/128
+         */
+        annotations?: {
+            [key: string]: string;
+        } | null;
+        /**
+         * Output only. Create time stamp
+         */
+        createTime?: string | null;
+        /**
+         * Output only. Delete time stamp
+         */
+        deleteTime?: string | null;
+        /**
+         * User-settable and human-readable display name for the Endpoint.
+         */
+        displayName?: string | null;
+        /**
+         * Output only. The DNS config for the endpoint. Each endpoint is associated with a specific DNS name and the DNS type. The DNS targets are the IP addresses of the target instances. The dns_type is the type of the DNS record, eg. Type "A" or Type "CNAME". This field is not configurable by the user, and it is updated when user specifies the target instances.
+         */
+        dnsConfig?: Schema$DNSConfig;
+        /**
+         * Output only. The effective target instances that the endpoint is associated with. This is a list of target instance names, e.g. projects/{project_number\}/locations/{location\}/clusters/{cluster_id\}/instances/{instance_id\} For write endpoint, there is only one effective target instance which has to be a primary instance. Effective target instances are only different from target instances after a switchover or cross-region failover operation. Otherwise, effective_target_instances are the same as target_instances. Note that after a cross-region failover operation, the effective_target_instances can be stale until the operation to update the endpoint is complete.
+         */
+        effectiveTargetInstances?: string[] | null;
+        /**
+         * The type of the endpoint, either write or read.
+         */
+        endpointType?: string | null;
+        /**
+         * For Resource freshness validation (https://google.aip.dev/154)
+         */
+        etag?: string | null;
+        /**
+         * Output only. Identifier. The name of the endpoint resource with the format: * projects/{project\}/locations/{region\}/endpoints/{endpoint_id\} where the endpoint ID segment should satisfy the regex expression `[a-z0-9-]+`. For more details see https://google.aip.dev/122. The prefix of the endpoint resource name is the name of the parent resource: * projects/{project\}/locations/{region\}
+         */
+        name?: string | null;
+        /**
+         * Output only. Reconciling (https://google.aip.dev/128#reconciliation). Set to true if the current state of Endpoint does not match the user's intended state, and the service is actively updating the Endpoint to reconcile them. This can happen due to user-triggered updates or system actions like failover or maintenance.
+         */
+        reconciling?: boolean | null;
+        /**
+         * Output only. The state of the endpoint.
+         */
+        state?: string | null;
+        /**
+         * The names of the target instances for the endpoint, should be of format projects/{project\}/locations/{region\}/clusters/{cluster\}/instances/{instance\}. For write endpoint, there is only one target instance which has to be a primary instance. For read endpoint, there can be multiple target instances which can be read or secondary instances. After a cross-region failover or switchover operation, the endpoint will be associated with a different target instance. This change will be reflected in the effective_target_instances field.
+         */
+        targetInstances?: string[] | null;
+        /**
+         * Output only. The system-generated UID of the resource. The UID is assigned when the resource is created, and it is retained until it is deleted.
+         */
+        uid?: string | null;
+        /**
+         * Output only. Update time stamp
+         */
+        updateTime?: string | null;
+    }
     /**
      * Export cluster request.
      */
@@ -1166,7 +1206,7 @@ export declare namespace alloydb_v1beta {
      */
     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])?.
+         * 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](https://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;
         /**
@@ -1250,6 +1290,23 @@ export declare namespace alloydb_v1beta {
          */
         unreachable?: string[] | null;
     }
+    /**
+     * Message for response to listing Endpoints
+     */
+    export interface Schema$ListEndpointsResponse {
+        /**
+         * The list of Endpoints
+         */
+        endpoints?: Schema$Endpoint[];
+        /**
+         * A token identifying a page of results the server should return.
+         */
+        nextPageToken?: string | null;
+        /**
+         * Locations that could not be reached.
+         */
+        unreachable?: string[] | null;
+    }
     /**
      * Message for response to listing Instances
      */
@@ -1404,6 +1461,10 @@ export declare namespace alloydb_v1beta {
          * Output only. The private IP address of the VM e.g. "10.57.0.34".
          */
         ip?: string | null;
+        /**
+         * Output only. Indicates whether the node set up to be configured as a hot standby.
+         */
+        isHotStandby?: boolean | null;
         /**
          * Output only. Determined by state of the compute VM and postgres-service health. Compute VM state can have values listed in https://cloud.google.com/compute/docs/instances/instance-life-cycle and postgres-service health can have values: HEALTHY and UNHEALTHY.
          */
@@ -1445,6 +1506,10 @@ export declare namespace alloydb_v1beta {
          * Track actively running queries on the instance. If not set, this flag is "off" by default.
          */
         trackActiveQueries?: boolean | null;
+        /**
+         * Indicates whether to track active query plans for an instance. If not set, the default value is "off". Can only be enabled if track_active_queries is enabled.
+         */
+        trackActiveQueryPlan?: boolean | null;
         /**
          * Track client address for an instance. If not set, default value is "off".
          */
@@ -1562,6 +1627,10 @@ export declare namespace alloydb_v1beta {
          * 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?: string | null;
+        /**
+         * Optional. If set, the promote operation will attempt to recreate the original primary cluster as a secondary cluster when it comes back online. Otherwise, the promoted cluster will be a standalone cluster. Currently only supported when there is a single secondary cluster.
+         */
+        failover?: boolean | null;
         /**
          * 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 original operation with the same request ID was received, and if so, will ignore 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).
          */
@@ -2196,7 +2265,7 @@ export declare namespace alloydb_v1beta {
         uniqueId?: string | null;
     }
     /**
-     * Common model for database resource instance metadata. Next ID: 30
+     * Common model for database resource instance metadata. Next ID: 32
      */
     export interface Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata {
         /**
@@ -2267,6 +2336,10 @@ export declare namespace alloydb_v1beta {
          * Optional. Maintenance info for the resource.
          */
         maintenanceInfo?: Schema$StorageDatabasecenterPartnerapiV1mainResourceMaintenanceInfo;
+        /**
+         * Optional. The modes of the database resource.
+         */
+        modes?: string[] | null;
         /**
          * Identifier for this resource's immediate parent/primary resource if the current resource is a replica or derived form of another Database resource. Else it would be NULL. REQUIRED if the immediate parent exists when first time resource is getting ingested, otherwise optional.
          */
@@ -2283,6 +2356,10 @@ export declare namespace alloydb_v1beta {
          * Closest parent Cloud Resource Manager container of this resource. It must be resource name of a Cloud Resource Manager project with the format of "/", such as "projects/123". For GCP provided resources, number should be project number.
          */
         resourceContainer?: string | null;
+        /**
+         * Optional. List of resource flags for the database resource.
+         */
+        resourceFlags?: Schema$StorageDatabasecenterPartnerapiV1mainResourceFlags[];
         /**
          * Required. Different from DatabaseResourceId.unique_id, a resource name can be reused over time. That is, after a resource named "ABC" is deleted, the name "ABC" can be used to to create a new resource within the same source. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel
          */
@@ -2348,9 +2425,13 @@ export declare namespace alloydb_v1beta {
         signalType?: string | null;
     }
     /**
-     * Database resource signal data. This is used to send signals to Condor which are based on the DB/Instance/Fleet level configurations. These will be used to send signals for all inventory types. Next ID: 7
+     * Database resource signal data. This is used to send signals to Condor which are based on the DB/Instance/Fleet level configurations. These will be used to send signals for all inventory types. Next ID: 10
      */
     export interface Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceSignalData {
+        /**
+         * Deprecated: Use signal_metadata_list instead.
+         */
+        backupRun?: Schema$StorageDatabasecenterPartnerapiV1mainBackupRun;
         /**
          * Required. Full Resource name of the source resource.
          */
@@ -2359,14 +2440,22 @@ export declare namespace alloydb_v1beta {
          * Required. Last time signal was refreshed
          */
         lastRefreshTime?: string | null;
+        /**
+         * Required. Resource location.
+         */
+        location?: string | null;
         /**
          * Database resource id.
          */
         resourceId?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId;
         /**
-         * Signal data for boolean signals.
+         * Deprecated: Use signal_metadata_list instead.
          */
         signalBoolValue?: boolean | null;
+        /**
+         * This will support array of OneOf signal metadata information for a given signal type.
+         */
+        signalMetadataList?: Schema$StorageDatabasecenterPartnerapiV1mainSignalMetadata[];
         /**
          * Required. Output only. Signal state of the signal
          */
@@ -2486,6 +2575,19 @@ export declare namespace alloydb_v1beta {
          */
         message?: string | null;
     }
+    /**
+     * Message type for storing resource flags.
+     */
+    export interface Schema$StorageDatabasecenterPartnerapiV1mainResourceFlags {
+        /**
+         * Optional. Key of the resource flag.
+         */
+        key?: string | null;
+        /**
+         * Optional. Value of the resource flag.
+         */
+        value?: string | null;
+    }
     /**
      * Deny maintenance period for the database resource. It specifies the time range during which the maintenance cannot start. This is configured by the customer.
      */
@@ -2507,10 +2609,18 @@ export declare namespace alloydb_v1beta {
      * MaintenanceInfo to capture the maintenance details of database resource.
      */
     export interface Schema$StorageDatabasecenterPartnerapiV1mainResourceMaintenanceInfo {
+        /**
+         * Optional. The date when the current maintenance version was released.
+         */
+        currentVersionReleaseDate?: Schema$GoogleTypeDate;
         /**
          * Optional. List of Deny maintenance period for the database resource.
          */
         denyMaintenanceSchedules?: Schema$StorageDatabasecenterPartnerapiV1mainResourceMaintenanceDenySchedule[];
+        /**
+         * Optional. Whether the instance is in stopped state. This information is temporarily being captured in maintenanceInfo, till STOPPED state is supported by DB Center.
+         */
+        isInstanceStopped?: boolean | null;
         /**
          * Optional. Maintenance window for the database resource.
          */
@@ -2561,6 +2671,19 @@ export declare namespace alloydb_v1beta {
          */
         timestampBasedRetentionTime?: string | null;
     }
+    /**
+     * SignalMetadata contains one of the signal metadata proto messages associated with a SignalType. This proto will be mapped to SignalMetadata message in storage.proto. Next ID: 3
+     */
+    export interface Schema$StorageDatabasecenterPartnerapiV1mainSignalMetadata {
+        /**
+         * Signal data for backup runs.
+         */
+        backupRun?: Schema$StorageDatabasecenterPartnerapiV1mainBackupRun;
+        /**
+         * Signal data for boolean signals.
+         */
+        signalBoolValue?: boolean | null;
+    }
     /**
      * Message type for storing tags. Tags provide a way to create annotations for resources, and in some cases conditionally allow or deny policies based on whether a resource has a specific tag.
      */
@@ -2865,6 +2988,7 @@ export declare namespace alloydb_v1beta {
         context: APIRequestContext;
         backups: Resource$Projects$Locations$Backups;
         clusters: Resource$Projects$Locations$Clusters;
+        endpoints: Resource$Projects$Locations$Endpoints;
         operations: Resource$Projects$Locations$Operations;
         supportedDatabaseFlags: Resource$Projects$Locations$Supporteddatabaseflags;
         constructor(context: APIRequestContext);
@@ -2933,7 +3057,7 @@ export declare namespace alloydb_v1beta {
         get(params: Params$Resource$Projects$Locations$Get, callback: BodyResponseCallback<Schema$GoogleCloudLocationLocation>): void;
         get(callback: BodyResponseCallback<Schema$GoogleCloudLocationLocation>): void;
         /**
-         * Lists information about the supported locations for this service.
+         * Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project\}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.
          * @example
          * ```js
          * // Before running the sample:
@@ -2963,7 +3087,7 @@ export declare namespace alloydb_v1beta {
          *
          *   // Do the magic
          *   const res = await alloydb.projects.locations.list({
-         *     // Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
+         *     // Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.
          *     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',
@@ -3010,7 +3134,7 @@ export declare namespace alloydb_v1beta {
     }
     export interface Params$Resource$Projects$Locations$List extends StandardParameters {
         /**
-         * Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
+         * Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.
          */
         extraLocationTypes?: string[];
         /**
@@ -4361,6 +4485,7 @@ export declare namespace alloydb_v1beta {
          *       // request body parameters
          *       // {
          *       //   "etag": "my_etag",
+         *       //   "failover": false,
          *       //   "requestId": "my_requestId",
          *       //   "validateOnly": false
          *       // }
@@ -6377,6 +6502,501 @@ export declare namespace alloydb_v1beta {
          */
         requestBody?: Schema$User;
     }
+    export class Resource$Projects$Locations$Endpoints {
+        context: APIRequestContext;
+        constructor(context: APIRequestContext);
+        /**
+         * Creates a new Endpoint 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('v1beta');
+         *
+         * 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.endpoints.create({
+         *     // Required. ID of the requesting object.
+         *     endpointId: 'placeholder-value',
+         *     // Required. The location of the new endpoint. For the required format, see the comment on the Endpoint.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, the backend validates the request, but doesn't actually execute it.
+         *     validateOnly: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "annotations": {},
+         *       //   "createTime": "my_createTime",
+         *       //   "deleteTime": "my_deleteTime",
+         *       //   "displayName": "my_displayName",
+         *       //   "dnsConfig": {},
+         *       //   "effectiveTargetInstances": [],
+         *       //   "endpointType": "my_endpointType",
+         *       //   "etag": "my_etag",
+         *       //   "name": "my_name",
+         *       //   "reconciling": false,
+         *       //   "state": "my_state",
+         *       //   "targetInstances": [],
+         *       //   "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`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        create(params: Params$Resource$Projects$Locations$Endpoints$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        create(params?: Params$Resource$Projects$Locations$Endpoints$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        create(params: Params$Resource$Projects$Locations$Endpoints$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        create(params: Params$Resource$Projects$Locations$Endpoints$Create, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        create(params: Params$Resource$Projects$Locations$Endpoints$Create, callback: BodyResponseCallback<Schema$Operation>): void;
+        create(callback: BodyResponseCallback<Schema$Operation>): void;
+        /**
+         * Deletes a single Endpoint.
+         * @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('v1beta');
+         *
+         * 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.endpoints.delete({
+         *     // Optional. The current etag of the Endpoint. If an etag is provided and does not match the current etag of the Endpoint, 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 Endpoint.name field.
+         *     name: 'projects/my-project/locations/my-location/endpoints/my-endpoint',
+         *     // 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 after 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`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        delete(params: Params$Resource$Projects$Locations$Endpoints$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        delete(params?: Params$Resource$Projects$Locations$Endpoints$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        delete(params: Params$Resource$Projects$Locations$Endpoints$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        delete(params: Params$Resource$Projects$Locations$Endpoints$Delete, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        delete(params: Params$Resource$Projects$Locations$Endpoints$Delete, callback: BodyResponseCallback<Schema$Operation>): void;
+        delete(callback: BodyResponseCallback<Schema$Operation>): void;
+        /**
+         * Gets details of a single Endpoint.
+         * @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('v1beta');
+         *
+         * 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.endpoints.get({
+         *     // Required. The name of the resource. For the required format, see the comment on the Endpoint.name field.
+         *     name: 'projects/my-project/locations/my-location/endpoints/my-endpoint',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "annotations": {},
+         *   //   "createTime": "my_createTime",
+         *   //   "deleteTime": "my_deleteTime",
+         *   //   "displayName": "my_displayName",
+         *   //   "dnsConfig": {},
+         *   //   "effectiveTargetInstances": [],
+         *   //   "endpointType": "my_endpointType",
+         *   //   "etag": "my_etag",
+         *   //   "name": "my_name",
+         *   //   "reconciling": false,
+         *   //   "state": "my_state",
+         *   //   "targetInstances": [],
+         *   //   "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`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        get(params: Params$Resource$Projects$Locations$Endpoints$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        get(params?: Params$Resource$Projects$Locations$Endpoints$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Endpoint>>;
+        get(params: Params$Resource$Projects$Locations$Endpoints$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        get(params: Params$Resource$Projects$Locations$Endpoints$Get, options: MethodOptions | BodyResponseCallback<Schema$Endpoint>, callback: BodyResponseCallback<Schema$Endpoint>): void;
+        get(params: Params$Resource$Projects$Locations$Endpoints$Get, callback: BodyResponseCallback<Schema$Endpoint>): void;
+        get(callback: BodyResponseCallback<Schema$Endpoint>): void;
+        /**
+         * Lists Endpoints 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('v1beta');
+         *
+         * 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.endpoints.list({
+         *     // Optional. Filtering results. This field is currently not supported, its value will be ignored if passed.
+         *     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 page token, received from a previous `ListEndpoints` call. This should be provided to retrieve the subsequent page. This field is currently not supported, its value will be ignored if passed.
+         *     pageToken: 'placeholder-value',
+         *     // Required. The name of the parent resource. For the required format, see the comment on the Endpoint.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
+         *   // {
+         *   //   "endpoints": [],
+         *   //   "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`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        list(params: Params$Resource$Projects$Locations$Endpoints$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        list(params?: Params$Resource$Projects$Locations$Endpoints$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListEndpointsResponse>>;
+        list(params: Params$Resource$Projects$Locations$Endpoints$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        list(params: Params$Resource$Projects$Locations$Endpoints$List, options: MethodOptions | BodyResponseCallback<Schema$ListEndpointsResponse>, callback: BodyResponseCallback<Schema$ListEndpointsResponse>): void;
+        list(params: Params$Resource$Projects$Locations$Endpoints$List, callback: BodyResponseCallback<Schema$ListEndpointsResponse>): void;
+        list(callback: BodyResponseCallback<Schema$ListEndpointsResponse>): void;
+        /**
+         * Updates the parameters of a single Endpoint.
+         * @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('v1beta');
+         *
+         * 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.endpoints.patch({
+         *     // Optional. If set to true, update succeeds even if endpoint is not found. In that case, a new endpoint is created and `update_mask` is ignored.
+         *     allowMissing: 'placeholder-value',
+         *     // Output only. Identifier. The name of the endpoint resource with the format: * projects/{project\}/locations/{region\}/endpoints/{endpoint_id\} where the endpoint ID segment should satisfy the regex expression `[a-z0-9-]+`. For more details see https://google.aip.dev/122. The prefix of the endpoint resource name is the name of the parent resource: * projects/{project\}/locations/{region\}
+         *     name: 'projects/my-project/locations/my-location/endpoints/my-endpoint',
+         *     // 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 Endpoint 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": {},
+         *       //   "createTime": "my_createTime",
+         *       //   "deleteTime": "my_deleteTime",
+         *       //   "displayName": "my_displayName",
+         *       //   "dnsConfig": {},
+         *       //   "effectiveTargetInstances": [],
+         *       //   "endpointType": "my_endpointType",
+         *       //   "etag": "my_etag",
+         *       //   "name": "my_name",
+         *       //   "reconciling": false,
+         *       //   "state": "my_state",
+         *       //   "targetInstances": [],
+         *       //   "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`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        patch(params: Params$Resource$Projects$Locations$Endpoints$Patch, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        patch(params?: Params$Resource$Projects$Locations$Endpoints$Patch, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        patch(params: Params$Resource$Projects$Locations$Endpoints$Patch, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        patch(params: Params$Resource$Projects$Locations$Endpoints$Patch, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        patch(params: Params$Resource$Projects$Locations$Endpoints$Patch, callback: BodyResponseCallback<Schema$Operation>): void;
+        patch(callback: BodyResponseCallback<Schema$Operation>): void;
+    }
+    export interface Params$Resource$Projects$Locations$Endpoints$Create extends StandardParameters {
+        /**
+         * Required. ID of the requesting object.
+         */
+        endpointId?: string;
+        /**
+         * Required. The location of the new endpoint. For the required format, see the comment on the Endpoint.name field.
+         */
+        parent?: string;
+        /**
+         * 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?: string;
+        /**
+         * Optional. If set, the backend validates the request, but doesn't actually execute it.
+         */
+        validateOnly?: boolean;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$Endpoint;
+    }
+    export interface Params$Resource$Projects$Locations$Endpoints$Delete extends StandardParameters {
+        /**
+         * Optional. The current etag of the Endpoint. If an etag is provided and does not match the current etag of the Endpoint, deletion will be blocked and an ABORTED error will be returned.
+         */
+        etag?: string;
+        /**
+         * Required. The name of the resource. For the required format, see the comment on the Endpoint.name field.
+         */
+        name?: string;
+        /**
+         * 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 after 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?: string;
+        /**
+         * Optional. If set, the backend validates the request, but doesn't actually execute it.
+         */
+        validateOnly?: boolean;
+    }
+    export interface Params$Resource$Projects$Locations$Endpoints$Get extends StandardParameters {
+        /**
+         * Required. The name of the resource. For the required format, see the comment on the Endpoint.name field.
+         */
+        name?: string;
+    }
+    export interface Params$Resource$Projects$Locations$Endpoints$List extends StandardParameters {
+        /**
+         * Optional. Filtering results. This field is currently not supported, its value will be ignored if passed.
+         */
+        filter?: string;
+        /**
+         * Optional. Hint for how to order the results
+         */
+        orderBy?: string;
+        /**
+         * Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
+         */
+        pageSize?: number;
+        /**
+         * Optional. A page token, received from a previous `ListEndpoints` call. This should be provided to retrieve the subsequent page. This field is currently not supported, its value will be ignored if passed.
+         */
+        pageToken?: string;
+        /**
+         * Required. The name of the parent resource. For the required format, see the comment on the Endpoint.name field. Additionally, you can perform an aggregated list operation by specifying a value with the following format: * projects/{project\}/locations/-
+         */
+        parent?: string;
+    }
+    export interface Params$Resource$Projects$Locations$Endpoints$Patch extends StandardParameters {
+        /**
+         * Optional. If set to true, update succeeds even if endpoint is not found. In that case, a new endpoint is created and `update_mask` is ignored.
+         */
+        allowMissing?: boolean;
+        /**
+         * Output only. Identifier. The name of the endpoint resource with the format: * projects/{project\}/locations/{region\}/endpoints/{endpoint_id\} where the endpoint ID segment should satisfy the regex expression `[a-z0-9-]+`. For more details see https://google.aip.dev/122. The prefix of the endpoint resource name is the name of the parent resource: * projects/{project\}/locations/{region\}
+         */
+        name?: string;
+        /**
+         * 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?: string;
+        /**
+         * Optional. Field mask is used to specify the fields to be overwritten in the Endpoint 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?: string;
+        /**
+         * Optional. If set, the backend validates the request, but doesn't actually execute it.
+         */
+        validateOnly?: boolean;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$Endpoint;
+    }
     export class Resource$Projects$Locations$Operations {
         context: APIRequestContext;
         constructor(context: APIRequestContext);