@googleapis/alloydb 7.0.0 → 10.0.0

package/v1beta.ts

@@ -419,6 +419,14 @@ export namespace alloydb_v1beta {
      * Output only. The current serving state of the cluster.
      */
     state?: string | null;
+    /**
+     * Optional. Subscription type of the cluster.
+     */
+    subscriptionType?: string | null;
+    /**
+     * Output only. Metadata for free trial clusters
+     */
+    trialMetadata?: Schema$TrialMetadata;
     /**
      * 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.
      */
@@ -717,6 +725,10 @@ export namespace alloydb_v1beta {
      * Configuration for observability.
      */
     observabilityConfig?: Schema$ObservabilityInstanceConfig;
+    /**
+     * Output only. All outbound public IP addresses configured for the instance.
+     */
+    outboundPublicIpAddresses?: string[] | null;
     /**
      * Optional. The configuration for Private Service Connect (PSC) for the instance.
      */
@@ -770,6 +782,10 @@ export namespace alloydb_v1beta {
      * Optional. A list of external network authorized to access this instance.
      */
     authorizedExternalNetworks?: Schema$AuthorizedNetwork[];
+    /**
+     * Optional. Enabling an outbound public IP address to support a database server sending requests out into the internet.
+     */
+    enableOutboundPublicIp?: boolean | null;
     /**
      * Optional. Enabling public ip for the instance.
      */
@@ -978,7 +994,7 @@ export namespace alloydb_v1beta {
    */
   export interface Schema$ObservabilityInstanceConfig {
     /**
-     * Observability feature status for an instance. This is a read-only flag and modifiable only by producer API. This flag is turned "off" by default.
+     * Observability feature status for an instance. This flag is turned "off" by default.
      */
     enabled?: boolean | null;
     /**
@@ -990,7 +1006,7 @@ export namespace alloydb_v1beta {
      */
     preserveComments?: boolean | null;
     /**
-     * Number of query execution plans captured by Insights per minute for all queries combined. The default value is 5. Any integer between 0 to 20 is considered valid.
+     * Number of query execution plans captured by Insights per minute for all queries combined. The default value is 200. Any integer between 0 to 200 is considered valid.
      */
     queryPlansPerMinute?: number | null;
     /**
@@ -1356,6 +1372,7 @@ export namespace alloydb_v1beta {
     /**
      * More feed data would be added in subsequent CLs
      */
+    observabilityMetricData?: Schema$StorageDatabasecenterPartnerapiV1mainObservabilityMetricData;
     recommendationSignalData?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalData;
     resourceHealthSignalData?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData;
     /**
@@ -1487,6 +1504,10 @@ export namespace alloydb_v1beta {
      * The resource location. REQUIRED
      */
     location?: string | null;
+    /**
+     * Machine configuration for this resource.
+     */
+    machineConfiguration?: Schema$StorageDatabasecenterPartnerapiV1mainMachineConfiguration;
     /**
      * 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.
      */
@@ -1507,10 +1528,6 @@ export namespace alloydb_v1beta {
      * The time at which the resource was updated and recorded at partner service.
      */
     updationTime?: string | null;
-    /**
-     * User-provided labels, represented as a dictionary where each label is a single key value pair.
-     */
-    userLabels?: {[key: string]: string} | null;
     /**
      * User-provided labels associated with the resource
      */
@@ -1566,6 +1583,41 @@ export namespace alloydb_v1beta {
      */
     type?: string | null;
   }
+  /**
+   * MachineConfiguration describes the configuration of a machine specific to Database Resource.
+   */
+  export interface Schema$StorageDatabasecenterPartnerapiV1mainMachineConfiguration {
+    /**
+     * The number of CPUs. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
+     */
+    cpuCount?: number | null;
+    /**
+     * Memory size in bytes. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
+     */
+    memorySizeInBytes?: string | null;
+  }
+  export interface Schema$StorageDatabasecenterPartnerapiV1mainObservabilityMetricData {
+    /**
+     * Required. Type of aggregation performed on the metric.
+     */
+    aggregationType?: string | null;
+    /**
+     * Required. Type of metric like CPU, Memory, etc.
+     */
+    metricType?: string | null;
+    /**
+     * Required. The time the metric value was observed.
+     */
+    observationTime?: string | null;
+    /**
+     * Required. Database resource name associated with the signal. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel
+     */
+    resourceName?: string | null;
+    /**
+     * Required. Value of the metric type.
+     */
+    value?: Schema$StorageDatabasecenterProtoCommonTypedValue;
+  }
   /**
    * An error that occurred during a backup creation operation.
    */
@@ -1611,6 +1663,27 @@ export namespace alloydb_v1beta {
      */
     version?: string | null;
   }
+  /**
+   * TypedValue represents the value of a metric type. It can either be a double, an int64, a string or a bool.
+   */
+  export interface Schema$StorageDatabasecenterProtoCommonTypedValue {
+    /**
+     * For boolean value
+     */
+    boolValue?: boolean | null;
+    /**
+     * For double value
+     */
+    doubleValue?: number | null;
+    /**
+     * For integer value
+     */
+    int64Value?: string | null;
+    /**
+     * For string value
+     */
+    stringValue?: string | null;
+  }
   /**
    * Restrictions on STRING type values
    */
@@ -1654,6 +1727,19 @@ export namespace alloydb_v1beta {
     supportedDbVersions?: string[] | null;
     valueType?: string | null;
   }
+  /**
+   * Message for switching over to a cluster
+   */
+  export interface Schema$SwitchoverClusterRequest {
+    /**
+     * Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee 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 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).
+     */
+    requestId?: string | null;
+    /**
+     * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the delete.
+     */
+    validateOnly?: boolean | null;
+  }
   /**
    * A time based retention policy specifies that all backups within a certain time period should be retained.
    */
@@ -1663,6 +1749,23 @@ export namespace alloydb_v1beta {
      */
     retentionPeriod?: string | null;
   }
+  /**
+   * Contains information and all metadata related to TRIAL clusters.
+   */
+  export interface Schema$TrialMetadata {
+    /**
+     * End time of the trial cluster.
+     */
+    endTime?: string | null;
+    /**
+     * start time of the trial cluster.
+     */
+    startTime?: string | null;
+    /**
+     * Upgrade time of trial cluster to Standard cluster.
+     */
+    upgradeTime?: string | null;
+  }
   /**
    * Policy to be used while updating the instance.
    */
@@ -3217,6 +3320,94 @@ export namespace alloydb_v1beta {
         return createAPIRequest<Schema$Operation>(parameters);
       }
     }
+
+    /**
+     * Switches the role of PRIMARY and SECONDARY cluster without any data loss. This promotes the SECONDARY cluster to PRIMARY and sets up original PRIMARY cluster to replicate from this newly promoted cluster.
+     *
+     * @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.
+     */
+    switchover(
+      params: Params$Resource$Projects$Locations$Clusters$Switchover,
+      options: StreamMethodOptions
+    ): GaxiosPromise<Readable>;
+    switchover(
+      params?: Params$Resource$Projects$Locations$Clusters$Switchover,
+      options?: MethodOptions
+    ): GaxiosPromise<Schema$Operation>;
+    switchover(
+      params: Params$Resource$Projects$Locations$Clusters$Switchover,
+      options: StreamMethodOptions | BodyResponseCallback<Readable>,
+      callback: BodyResponseCallback<Readable>
+    ): void;
+    switchover(
+      params: Params$Resource$Projects$Locations$Clusters$Switchover,
+      options: MethodOptions | BodyResponseCallback<Schema$Operation>,
+      callback: BodyResponseCallback<Schema$Operation>
+    ): void;
+    switchover(
+      params: Params$Resource$Projects$Locations$Clusters$Switchover,
+      callback: BodyResponseCallback<Schema$Operation>
+    ): void;
+    switchover(callback: BodyResponseCallback<Schema$Operation>): void;
+    switchover(
+      paramsOrCallback?:
+        | Params$Resource$Projects$Locations$Clusters$Switchover
+        | BodyResponseCallback<Schema$Operation>
+        | BodyResponseCallback<Readable>,
+      optionsOrCallback?:
+        | MethodOptions
+        | StreamMethodOptions
+        | BodyResponseCallback<Schema$Operation>
+        | BodyResponseCallback<Readable>,
+      callback?:
+        | BodyResponseCallback<Schema$Operation>
+        | BodyResponseCallback<Readable>
+    ): void | GaxiosPromise<Schema$Operation> | GaxiosPromise<Readable> {
+      let params = (paramsOrCallback ||
+        {}) as Params$Resource$Projects$Locations$Clusters$Switchover;
+      let options = (optionsOrCallback || {}) as MethodOptions;
+
+      if (typeof paramsOrCallback === 'function') {
+        callback = paramsOrCallback;
+        params = {} as Params$Resource$Projects$Locations$Clusters$Switchover;
+        options = {};
+      }
+
+      if (typeof optionsOrCallback === 'function') {
+        callback = optionsOrCallback;
+        options = {};
+      }
+
+      const rootUrl = options.rootUrl || 'https://alloydb.googleapis.com/';
+      const parameters = {
+        options: Object.assign(
+          {
+            url: (rootUrl + '/v1beta/{+name}:switchover').replace(
+              /([^:]\/)\/+/g,
+              '$1'
+            ),
+            method: 'POST',
+            apiVersion: '',
+          },
+          options
+        ),
+        params,
+        requiredParams: ['name'],
+        pathParams: ['name'],
+        context: this.context,
+      };
+      if (callback) {
+        createAPIRequest<Schema$Operation>(
+          parameters,
+          callback as BodyResponseCallback<unknown>
+        );
+      } else {
+        return createAPIRequest<Schema$Operation>(parameters);
+      }
+    }
   }
 
   export interface Params$Resource$Projects$Locations$Clusters$Create
@@ -3376,6 +3567,18 @@ export namespace alloydb_v1beta {
      */
     requestBody?: Schema$RestoreClusterRequest;
   }
+  export interface Params$Resource$Projects$Locations$Clusters$Switchover
+    extends StandardParameters {
+    /**
+     * Required. The name of the resource. For the required format, see the comment on the Cluster.name field
+     */
+    name?: string;
+
+    /**
+     * Request body metadata
+     */
+    requestBody?: Schema$SwitchoverClusterRequest;
+  }
 
   export class Resource$Projects$Locations$Clusters$Instances {
     context: APIRequestContext;