@googleapis/alloydb 11.0.0 → 11.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/v1beta.ts CHANGED
@@ -250,6 +250,10 @@ export namespace alloydb_v1beta {
250
250
  * Output only. The current state of the backup.
251
251
  */
252
252
  state?: string | null;
253
+ /**
254
+ * Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: ``` "123/environment": "production", "123/costCenter": "marketing" ```
255
+ */
256
+ tags?: {[key: string]: string} | null;
253
257
  /**
254
258
  * The backup type, which suggests the trigger for the backup.
255
259
  */
@@ -285,7 +289,7 @@ export namespace alloydb_v1beta {
285
289
  */
286
290
  requireConnectors?: boolean | null;
287
291
  /**
288
- * Optional. SSL config option for this instance.
292
+ * Optional. SSL configuration option for this instance.
289
293
  */
290
294
  sslConfig?: Schema$SslConfig;
291
295
  }
@@ -444,6 +448,10 @@ export namespace alloydb_v1beta {
444
448
  * Optional. Subscription type of the cluster.
445
449
  */
446
450
  subscriptionType?: string | null;
451
+ /**
452
+ * Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: ``` "123/environment": "production", "123/costCenter": "marketing" ```
453
+ */
454
+ tags?: {[key: string]: string} | null;
447
455
  /**
448
456
  * Output only. Metadata for free trial clusters
449
457
  */
@@ -566,6 +574,27 @@ export namespace alloydb_v1beta {
566
574
  */
567
575
  pointInTime?: string | null;
568
576
  }
577
+ /**
578
+ * Options for exporting data in CSV format.
579
+ */
580
+ export interface Schema$CsvExportOptions {
581
+ /**
582
+ * Optional. Specifies the character that should appear before a data character that needs to be escaped. The default is the same as quote character. The value of this argument has to be a character in Hex ASCII Code.
583
+ */
584
+ escapeCharacter?: string | null;
585
+ /**
586
+ * Optional. Specifies the character that separates columns within each row (line) of the file. The default is comma. The value of this argument has to be a character in Hex ASCII Code.
587
+ */
588
+ fieldDelimiter?: string | null;
589
+ /**
590
+ * Optional. Specifies the quoting character to be used when a data value is quoted. The default is double-quote. The value of this argument has to be a character in Hex ASCII Code.
591
+ */
592
+ quoteCharacter?: string | null;
593
+ /**
594
+ * Required. The SELECT query used to extract the data.
595
+ */
596
+ selectQuery?: string | null;
597
+ }
569
598
  /**
570
599
  * 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); \}
571
600
  */
@@ -592,19 +621,49 @@ export namespace alloydb_v1beta {
592
621
  */
593
622
  kmsKeyVersions?: string[] | null;
594
623
  }
624
+ /**
625
+ * Export cluster request.
626
+ */
627
+ export interface Schema$ExportClusterRequest {
628
+ /**
629
+ * Options for exporting data in CSV format. Required field to be set for CSV file type.
630
+ */
631
+ csvExportOptions?: Schema$CsvExportOptions;
632
+ /**
633
+ * Required. Name of the database where the export command will be executed. Note - Value provided should be the same as expected from `SELECT current_database();` and NOT as a resource reference.
634
+ */
635
+ database?: string | null;
636
+ /**
637
+ * Required. Option to export data to cloud storage.
638
+ */
639
+ gcsDestination?: Schema$GcsDestination;
640
+ /**
641
+ * Options for exporting data in SQL format. Required field to be set for SQL file type.
642
+ */
643
+ sqlExportOptions?: Schema$SqlExportOptions;
644
+ }
595
645
  /**
596
646
  * Message for triggering failover on an Instance
597
647
  */
598
648
  export interface Schema$FailoverInstanceRequest {
599
649
  /**
600
- * 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).
650
+ * 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).
601
651
  */
602
652
  requestId?: string | null;
603
653
  /**
604
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the failover.
654
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
605
655
  */
606
656
  validateOnly?: boolean | null;
607
657
  }
658
+ /**
659
+ * Destination for Export. Export will be done to cloud storage.
660
+ */
661
+ export interface Schema$GcsDestination {
662
+ /**
663
+ * Required. The path to the file in Google Cloud Storage where the export will be stored. The URI is in the form `gs://bucketName/fileName`.
664
+ */
665
+ uri?: string | null;
666
+ }
608
667
  /**
609
668
  * Cluster level configuration parameters related to the Gemini in Databases add-on.
610
669
  */
@@ -666,19 +725,19 @@ export namespace alloydb_v1beta {
666
725
  */
667
726
  export interface Schema$GoogleTypeTimeOfDay {
668
727
  /**
669
- * Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
728
+ * Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
670
729
  */
671
730
  hours?: number | null;
672
731
  /**
673
- * Minutes of hour of day. Must be from 0 to 59.
732
+ * Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
674
733
  */
675
734
  minutes?: number | null;
676
735
  /**
677
- * Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
736
+ * Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
678
737
  */
679
738
  nanos?: number | null;
680
739
  /**
681
- * Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
740
+ * Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.
682
741
  */
683
742
  seconds?: number | null;
684
743
  }
@@ -691,11 +750,11 @@ export namespace alloydb_v1beta {
691
750
  */
692
751
  faultType?: string | null;
693
752
  /**
694
- * 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).
753
+ * 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).
695
754
  */
696
755
  requestId?: string | null;
697
756
  /**
698
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the fault injection.
757
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
699
758
  */
700
759
  validateOnly?: boolean | null;
701
760
  }
@@ -720,7 +779,7 @@ export namespace alloydb_v1beta {
720
779
  */
721
780
  createTime?: string | null;
722
781
  /**
723
- * Database flags. Set at instance level. * They are copied from primary instance on read instance creation. * Read instances can set new or override existing flags that are relevant for reads, e.g. for enabling columnar cache on a read instance. Flags set on read instance may or may not be present on primary. This is a list of "key": "value" pairs. "key": The name of the flag. These flags are passed at instance setup time, so include both server options and system variables for Postgres. Flags are specified with underscores, not hyphens. "value": The value of the flag. Booleans are set to **on** for true and **off** for false. This field must be omitted if the flag doesn't take a value.
782
+ * Database flags. Set at the instance level. They are copied from the primary instance on secondary instance creation. Flags that have restrictions default to the value at primary instance on read instances during creation. Read instances can set new flags or override existing flags that are relevant for reads, for example, for enabling columnar cache on a read instance. Flags set on read instance might or might not be present on the primary instance. This is a list of "key": "value" pairs. "key": The name of the flag. These flags are passed at instance setup time, so include both server options and system variables for Postgres. Flags are specified with underscores, not hyphens. "value": The value of the flag. Booleans are set to **on** for true and **off** for false. This field must be omitted if the flag doesn't take a value.
724
783
  */
725
784
  databaseFlags?: {[key: string]: string} | null;
726
785
  /**
@@ -764,7 +823,7 @@ export namespace alloydb_v1beta {
764
823
  */
765
824
  name?: string | null;
766
825
  /**
767
- * Optional. Instance level network configuration.
826
+ * Optional. Instance-level network configuration.
768
827
  */
769
828
  networkConfig?: Schema$InstanceNetworkConfig;
770
829
  /**
@@ -825,7 +884,7 @@ export namespace alloydb_v1beta {
825
884
  writableNode?: Schema$Node;
826
885
  }
827
886
  /**
828
- * Metadata related to instance level network configuration.
887
+ * Metadata related to instance-level network configuration.
829
888
  */
830
889
  export interface Schema$InstanceNetworkConfig {
831
890
  /**
@@ -1040,19 +1099,19 @@ export namespace alloydb_v1beta {
1040
1099
  */
1041
1100
  export interface Schema$Node {
1042
1101
  /**
1043
- * The identifier of the VM e.g. "test-read-0601-407e52be-ms3l".
1102
+ * Output only. The identifier of the VM e.g. "test-read-0601-407e52be-ms3l".
1044
1103
  */
1045
1104
  id?: string | null;
1046
1105
  /**
1047
- * The private IP address of the VM e.g. "10.57.0.34".
1106
+ * Output only. The private IP address of the VM e.g. "10.57.0.34".
1048
1107
  */
1049
1108
  ip?: string | null;
1050
1109
  /**
1051
- * 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.
1110
+ * 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.
1052
1111
  */
1053
1112
  state?: string | null;
1054
1113
  /**
1055
- * The Compute Engine zone of the VM e.g. "us-central1-b".
1114
+ * Output only. The Compute Engine zone of the VM e.g. "us-central1-b".
1056
1115
  */
1057
1116
  zoneId?: string | null;
1058
1117
  }
@@ -1139,7 +1198,7 @@ export namespace alloydb_v1beta {
1139
1198
  */
1140
1199
  endTime?: string | null;
1141
1200
  /**
1142
- * Output only. Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
1201
+ * Output only. Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
1143
1202
  */
1144
1203
  requestedCancellation?: boolean | null;
1145
1204
  /**
@@ -1173,11 +1232,11 @@ export namespace alloydb_v1beta {
1173
1232
  */
1174
1233
  etag?: string | null;
1175
1234
  /**
1176
- * 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).
1235
+ * 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).
1177
1236
  */
1178
1237
  requestId?: string | null;
1179
1238
  /**
1180
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the delete.
1239
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
1181
1240
  */
1182
1241
  validateOnly?: boolean | null;
1183
1242
  }
@@ -1261,15 +1320,15 @@ export namespace alloydb_v1beta {
1261
1320
  }
1262
1321
  export interface Schema$RestartInstanceRequest {
1263
1322
  /**
1264
- * Optional. Full name of the nodes as obtained from INSTANCE_VIEW_FULL to restart upon. Only applicable for read instances.
1323
+ * Optional. Full name of the nodes as obtained from INSTANCE_VIEW_FULL to restart upon. Applicable only to read instances.
1265
1324
  */
1266
1325
  nodeIds?: string[] | null;
1267
1326
  /**
1268
- * 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).
1327
+ * 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).
1269
1328
  */
1270
1329
  requestId?: string | null;
1271
1330
  /**
1272
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the restart.
1331
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
1273
1332
  */
1274
1333
  validateOnly?: boolean | null;
1275
1334
  }
@@ -1294,14 +1353,31 @@ export namespace alloydb_v1beta {
1294
1353
  */
1295
1354
  continuousBackupSource?: Schema$ContinuousBackupSource;
1296
1355
  /**
1297
- * 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 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).
1356
+ * 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).
1298
1357
  */
1299
1358
  requestId?: string | null;
1300
1359
  /**
1301
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the import request.
1360
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
1302
1361
  */
1303
1362
  validateOnly?: boolean | null;
1304
1363
  }
1364
+ /**
1365
+ * Message for registering Restoring from CloudSQL resource.
1366
+ */
1367
+ export interface Schema$RestoreFromCloudSQLRequest {
1368
+ /**
1369
+ * Cluster created from CloudSQL backup run.
1370
+ */
1371
+ cloudsqlBackupRunSource?: Schema$CloudSQLBackupRunSource;
1372
+ /**
1373
+ * Required. The resource being created
1374
+ */
1375
+ cluster?: Schema$Cluster;
1376
+ /**
1377
+ * Required. ID of the requesting object.
1378
+ */
1379
+ clusterId?: string | null;
1380
+ }
1305
1381
  /**
1306
1382
  * Configuration information for the secondary cluster. This should be set if and only if the cluster is of type SECONDARY.
1307
1383
  */
@@ -1311,6 +1387,27 @@ export namespace alloydb_v1beta {
1311
1387
  */
1312
1388
  primaryClusterName?: string | null;
1313
1389
  }
1390
+ /**
1391
+ * Options for exporting data in SQL format.
1392
+ */
1393
+ export interface Schema$SqlExportOptions {
1394
+ /**
1395
+ * Optional. If true, output commands to DROP all the dumped database objects prior to outputting the commands for creating them.
1396
+ */
1397
+ cleanTargetObjects?: boolean | null;
1398
+ /**
1399
+ * Optional. If true, use DROP ... IF EXISTS commands to check for the object's existence before dropping it in clean_target_objects mode.
1400
+ */
1401
+ ifExistTargetObjects?: boolean | null;
1402
+ /**
1403
+ * Optional. If true, only export the schema.
1404
+ */
1405
+ schemaOnly?: boolean | null;
1406
+ /**
1407
+ * Optional. Tables to export from.
1408
+ */
1409
+ tables?: string[] | null;
1410
+ }
1314
1411
  /**
1315
1412
  * SSL configuration.
1316
1413
  */
@@ -1362,6 +1459,10 @@ export namespace alloydb_v1beta {
1362
1459
  * Configuration for availability of database instance
1363
1460
  */
1364
1461
  export interface Schema$StorageDatabasecenterPartnerapiV1mainAvailabilityConfiguration {
1462
+ /**
1463
+ * Checks for existence of (multi-cluster) routing configuration that allows automatic failover to a different zone/region in case of an outage. Applicable to Bigtable resources.
1464
+ */
1465
+ automaticFailoverRoutingConfigured?: boolean | null;
1365
1466
  /**
1366
1467
  * Availability type. Potential values: * `ZONAL`: The instance serves data from only one zone. Outages in that zone affect data accessibility. * `REGIONAL`: The instance can serve data from more than one zone in a region (it is highly available).
1367
1468
  */
@@ -1534,7 +1635,7 @@ export namespace alloydb_v1beta {
1534
1635
  uniqueId?: string | null;
1535
1636
  }
1536
1637
  /**
1537
- * Common model for database resource instance metadata.
1638
+ * Common model for database resource instance metadata. Next ID: 23
1538
1639
  */
1539
1640
  export interface Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata {
1540
1641
  /**
@@ -1561,6 +1662,10 @@ export namespace alloydb_v1beta {
1561
1662
  * Any custom metadata associated with the resource
1562
1663
  */
1563
1664
  customMetadata?: Schema$StorageDatabasecenterPartnerapiV1mainCustomMetadataData;
1665
+ /**
1666
+ * Optional. Edition represents whether the instance is ENTERPRISE or ENTERPRISE_PLUS. This information is core to Cloud SQL only and is used to identify the edition of the instance.
1667
+ */
1668
+ edition?: string | null;
1564
1669
  /**
1565
1670
  * Entitlements associated with the resource
1566
1671
  */
@@ -1589,6 +1694,10 @@ export namespace alloydb_v1beta {
1589
1694
  * 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.
1590
1695
  */
1591
1696
  primaryResourceId?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId;
1697
+ /**
1698
+ * Primary resource location. REQUIRED if the immediate parent exists when first time resource is getting ingested, otherwise optional.
1699
+ */
1700
+ primaryResourceLocation?: string | null;
1592
1701
  /**
1593
1702
  * The product this resource represents.
1594
1703
  */
@@ -1601,6 +1710,10 @@ export namespace alloydb_v1beta {
1601
1710
  * 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
1602
1711
  */
1603
1712
  resourceName?: string | null;
1713
+ /**
1714
+ * Optional. Tags associated with this resources.
1715
+ */
1716
+ tagsSet?: Schema$StorageDatabasecenterPartnerapiV1mainTags;
1604
1717
  /**
1605
1718
  * The time at which the resource was updated and recorded at partner service.
1606
1719
  */
@@ -1684,13 +1797,21 @@ export namespace alloydb_v1beta {
1684
1797
  */
1685
1798
  export interface Schema$StorageDatabasecenterPartnerapiV1mainMachineConfiguration {
1686
1799
  /**
1687
- * The number of CPUs. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
1800
+ * The number of CPUs. Deprecated. Use vcpu_count instead. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
1688
1801
  */
1689
1802
  cpuCount?: number | null;
1690
1803
  /**
1691
1804
  * Memory size in bytes. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
1692
1805
  */
1693
1806
  memorySizeInBytes?: string | null;
1807
+ /**
1808
+ * Optional. Number of shards (if applicable).
1809
+ */
1810
+ shardCount?: number | null;
1811
+ /**
1812
+ * Optional. The number of vCPUs. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
1813
+ */
1814
+ vcpuCount?: number | null;
1694
1815
  }
1695
1816
  export interface Schema$StorageDatabasecenterPartnerapiV1mainObservabilityMetricData {
1696
1817
  /**
@@ -1729,12 +1850,29 @@ export namespace alloydb_v1beta {
1729
1850
  message?: string | null;
1730
1851
  }
1731
1852
  export interface Schema$StorageDatabasecenterPartnerapiV1mainRetentionSettings {
1853
+ /**
1854
+ * Duration based retention period i.e. 172800 seconds (2 days)
1855
+ */
1856
+ durationBasedRetention?: string | null;
1732
1857
  quantityBasedRetention?: number | null;
1733
1858
  /**
1734
1859
  * The unit that 'retained_backups' represents.
1735
1860
  */
1736
1861
  retentionUnit?: string | null;
1737
1862
  timeBasedRetention?: string | null;
1863
+ /**
1864
+ * Timestamp based retention period i.e. 2024-05-01T00:00:00Z
1865
+ */
1866
+ timestampBasedRetentionTime?: string | null;
1867
+ }
1868
+ /**
1869
+ * 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.
1870
+ */
1871
+ export interface Schema$StorageDatabasecenterPartnerapiV1mainTags {
1872
+ /**
1873
+ * The Tag key/value mappings.
1874
+ */
1875
+ tags?: {[key: string]: string} | null;
1738
1876
  }
1739
1877
  /**
1740
1878
  * Message type for storing user labels. User labels are used to tag App Engine resources, allowing users to search for resources matching a set of labels and to aggregate usage data by labels.
@@ -1828,11 +1966,11 @@ export namespace alloydb_v1beta {
1828
1966
  */
1829
1967
  export interface Schema$SwitchoverClusterRequest {
1830
1968
  /**
1831
- * 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).
1969
+ * 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).
1832
1970
  */
1833
1971
  requestId?: string | null;
1834
1972
  /**
1835
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the delete.
1973
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
1836
1974
  */
1837
1975
  validateOnly?: boolean | null;
1838
1976
  }
@@ -1875,6 +2013,27 @@ export namespace alloydb_v1beta {
1875
2013
  */
1876
2014
  mode?: string | null;
1877
2015
  }
2016
+ /**
2017
+ * Upgrades a cluster.
2018
+ */
2019
+ export interface Schema$UpgradeClusterRequest {
2020
+ /**
2021
+ * Optional. The current etag of the Cluster. If an etag is provided and does not match the current etag of the Cluster, upgrade will be blocked and an ABORTED error will be returned.
2022
+ */
2023
+ etag?: string | null;
2024
+ /**
2025
+ * 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).
2026
+ */
2027
+ requestId?: string | null;
2028
+ /**
2029
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
2030
+ */
2031
+ validateOnly?: boolean | null;
2032
+ /**
2033
+ * Required. The version the cluster is going to be upgraded to.
2034
+ */
2035
+ version?: string | null;
2036
+ }
1878
2037
  /**
1879
2038
  * UpgradeClusterResponse contains the response for upgrade cluster operation.
1880
2039
  */
@@ -1900,6 +2059,10 @@ export namespace alloydb_v1beta {
1900
2059
  * Optional. List of database roles this user has. The database role strings are subject to the PostgreSQL naming conventions.
1901
2060
  */
1902
2061
  databaseRoles?: string[] | null;
2062
+ /**
2063
+ * Input only. If the user already exists and it has additional roles, keep them granted.
2064
+ */
2065
+ keepExtraRoles?: boolean | null;
1903
2066
  /**
1904
2067
  * Output only. Name of the resource in the form of projects/{project\}/locations/{location\}/cluster/{cluster\}/users/{user\}.
1905
2068
  */
@@ -2635,7 +2798,7 @@ export namespace alloydb_v1beta {
2635
2798
  */
2636
2799
  parent?: string;
2637
2800
  /**
2638
- * 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 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).
2801
+ * 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).
2639
2802
  */
2640
2803
  requestId?: string;
2641
2804
  /**
@@ -2659,7 +2822,7 @@ export namespace alloydb_v1beta {
2659
2822
  */
2660
2823
  name?: string;
2661
2824
  /**
2662
- * 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).
2825
+ * 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).
2663
2826
  */
2664
2827
  requestId?: string;
2665
2828
  /**
@@ -2708,7 +2871,7 @@ export namespace alloydb_v1beta {
2708
2871
  */
2709
2872
  name?: string;
2710
2873
  /**
2711
- * 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 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).
2874
+ * 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).
2712
2875
  */
2713
2876
  requestId?: string;
2714
2877
  /**
@@ -2999,6 +3162,94 @@ export namespace alloydb_v1beta {
2999
3162
  }
3000
3163
  }
3001
3164
 
3165
+ /**
3166
+ * Exports data from the cluster. Imperative only.
3167
+ *
3168
+ * @param params - Parameters for request
3169
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
3170
+ * @param callback - Optional callback that handles the response.
3171
+ * @returns A promise if used with async/await, or void if used with a callback.
3172
+ */
3173
+ export(
3174
+ params: Params$Resource$Projects$Locations$Clusters$Export,
3175
+ options: StreamMethodOptions
3176
+ ): GaxiosPromise<Readable>;
3177
+ export(
3178
+ params?: Params$Resource$Projects$Locations$Clusters$Export,
3179
+ options?: MethodOptions
3180
+ ): GaxiosPromise<Schema$Operation>;
3181
+ export(
3182
+ params: Params$Resource$Projects$Locations$Clusters$Export,
3183
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
3184
+ callback: BodyResponseCallback<Readable>
3185
+ ): void;
3186
+ export(
3187
+ params: Params$Resource$Projects$Locations$Clusters$Export,
3188
+ options: MethodOptions | BodyResponseCallback<Schema$Operation>,
3189
+ callback: BodyResponseCallback<Schema$Operation>
3190
+ ): void;
3191
+ export(
3192
+ params: Params$Resource$Projects$Locations$Clusters$Export,
3193
+ callback: BodyResponseCallback<Schema$Operation>
3194
+ ): void;
3195
+ export(callback: BodyResponseCallback<Schema$Operation>): void;
3196
+ export(
3197
+ paramsOrCallback?:
3198
+ | Params$Resource$Projects$Locations$Clusters$Export
3199
+ | BodyResponseCallback<Schema$Operation>
3200
+ | BodyResponseCallback<Readable>,
3201
+ optionsOrCallback?:
3202
+ | MethodOptions
3203
+ | StreamMethodOptions
3204
+ | BodyResponseCallback<Schema$Operation>
3205
+ | BodyResponseCallback<Readable>,
3206
+ callback?:
3207
+ | BodyResponseCallback<Schema$Operation>
3208
+ | BodyResponseCallback<Readable>
3209
+ ): void | GaxiosPromise<Schema$Operation> | GaxiosPromise<Readable> {
3210
+ let params = (paramsOrCallback ||
3211
+ {}) as Params$Resource$Projects$Locations$Clusters$Export;
3212
+ let options = (optionsOrCallback || {}) as MethodOptions;
3213
+
3214
+ if (typeof paramsOrCallback === 'function') {
3215
+ callback = paramsOrCallback;
3216
+ params = {} as Params$Resource$Projects$Locations$Clusters$Export;
3217
+ options = {};
3218
+ }
3219
+
3220
+ if (typeof optionsOrCallback === 'function') {
3221
+ callback = optionsOrCallback;
3222
+ options = {};
3223
+ }
3224
+
3225
+ const rootUrl = options.rootUrl || 'https://alloydb.googleapis.com/';
3226
+ const parameters = {
3227
+ options: Object.assign(
3228
+ {
3229
+ url: (rootUrl + '/v1beta/{+name}:export').replace(
3230
+ /([^:]\/)\/+/g,
3231
+ '$1'
3232
+ ),
3233
+ method: 'POST',
3234
+ apiVersion: '',
3235
+ },
3236
+ options
3237
+ ),
3238
+ params,
3239
+ requiredParams: ['name'],
3240
+ pathParams: ['name'],
3241
+ context: this.context,
3242
+ };
3243
+ if (callback) {
3244
+ createAPIRequest<Schema$Operation>(
3245
+ parameters,
3246
+ callback as BodyResponseCallback<unknown>
3247
+ );
3248
+ } else {
3249
+ return createAPIRequest<Schema$Operation>(parameters);
3250
+ }
3251
+ }
3252
+
3002
3253
  /**
3003
3254
  * Gets details of a single Cluster.
3004
3255
  *
@@ -3439,7 +3690,95 @@ export namespace alloydb_v1beta {
3439
3690
  }
3440
3691
 
3441
3692
  /**
3442
- * 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.
3693
+ * Restores an AlloyDB cluster from a CloudSQL resource.
3694
+ *
3695
+ * @param params - Parameters for request
3696
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
3697
+ * @param callback - Optional callback that handles the response.
3698
+ * @returns A promise if used with async/await, or void if used with a callback.
3699
+ */
3700
+ restoreFromCloudSQL(
3701
+ params: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql,
3702
+ options: StreamMethodOptions
3703
+ ): GaxiosPromise<Readable>;
3704
+ restoreFromCloudSQL(
3705
+ params?: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql,
3706
+ options?: MethodOptions
3707
+ ): GaxiosPromise<Schema$Operation>;
3708
+ restoreFromCloudSQL(
3709
+ params: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql,
3710
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
3711
+ callback: BodyResponseCallback<Readable>
3712
+ ): void;
3713
+ restoreFromCloudSQL(
3714
+ params: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql,
3715
+ options: MethodOptions | BodyResponseCallback<Schema$Operation>,
3716
+ callback: BodyResponseCallback<Schema$Operation>
3717
+ ): void;
3718
+ restoreFromCloudSQL(
3719
+ params: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql,
3720
+ callback: BodyResponseCallback<Schema$Operation>
3721
+ ): void;
3722
+ restoreFromCloudSQL(callback: BodyResponseCallback<Schema$Operation>): void;
3723
+ restoreFromCloudSQL(
3724
+ paramsOrCallback?:
3725
+ | Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql
3726
+ | BodyResponseCallback<Schema$Operation>
3727
+ | BodyResponseCallback<Readable>,
3728
+ optionsOrCallback?:
3729
+ | MethodOptions
3730
+ | StreamMethodOptions
3731
+ | BodyResponseCallback<Schema$Operation>
3732
+ | BodyResponseCallback<Readable>,
3733
+ callback?:
3734
+ | BodyResponseCallback<Schema$Operation>
3735
+ | BodyResponseCallback<Readable>
3736
+ ): void | GaxiosPromise<Schema$Operation> | GaxiosPromise<Readable> {
3737
+ let params = (paramsOrCallback ||
3738
+ {}) as Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql;
3739
+ let options = (optionsOrCallback || {}) as MethodOptions;
3740
+
3741
+ if (typeof paramsOrCallback === 'function') {
3742
+ callback = paramsOrCallback;
3743
+ params =
3744
+ {} as Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql;
3745
+ options = {};
3746
+ }
3747
+
3748
+ if (typeof optionsOrCallback === 'function') {
3749
+ callback = optionsOrCallback;
3750
+ options = {};
3751
+ }
3752
+
3753
+ const rootUrl = options.rootUrl || 'https://alloydb.googleapis.com/';
3754
+ const parameters = {
3755
+ options: Object.assign(
3756
+ {
3757
+ url: (
3758
+ rootUrl + '/v1beta/{+parent}/clusters:restoreFromCloudSQL'
3759
+ ).replace(/([^:]\/)\/+/g, '$1'),
3760
+ method: 'POST',
3761
+ apiVersion: '',
3762
+ },
3763
+ options
3764
+ ),
3765
+ params,
3766
+ requiredParams: ['parent'],
3767
+ pathParams: ['parent'],
3768
+ context: this.context,
3769
+ };
3770
+ if (callback) {
3771
+ createAPIRequest<Schema$Operation>(
3772
+ parameters,
3773
+ callback as BodyResponseCallback<unknown>
3774
+ );
3775
+ } else {
3776
+ return createAPIRequest<Schema$Operation>(parameters);
3777
+ }
3778
+ }
3779
+
3780
+ /**
3781
+ * 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.
3443
3782
  *
3444
3783
  * @param params - Parameters for request
3445
3784
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3525,6 +3864,94 @@ export namespace alloydb_v1beta {
3525
3864
  return createAPIRequest<Schema$Operation>(parameters);
3526
3865
  }
3527
3866
  }
3867
+
3868
+ /**
3869
+ * Upgrades a single Cluster. Imperative only.
3870
+ *
3871
+ * @param params - Parameters for request
3872
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
3873
+ * @param callback - Optional callback that handles the response.
3874
+ * @returns A promise if used with async/await, or void if used with a callback.
3875
+ */
3876
+ upgrade(
3877
+ params: Params$Resource$Projects$Locations$Clusters$Upgrade,
3878
+ options: StreamMethodOptions
3879
+ ): GaxiosPromise<Readable>;
3880
+ upgrade(
3881
+ params?: Params$Resource$Projects$Locations$Clusters$Upgrade,
3882
+ options?: MethodOptions
3883
+ ): GaxiosPromise<Schema$Operation>;
3884
+ upgrade(
3885
+ params: Params$Resource$Projects$Locations$Clusters$Upgrade,
3886
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
3887
+ callback: BodyResponseCallback<Readable>
3888
+ ): void;
3889
+ upgrade(
3890
+ params: Params$Resource$Projects$Locations$Clusters$Upgrade,
3891
+ options: MethodOptions | BodyResponseCallback<Schema$Operation>,
3892
+ callback: BodyResponseCallback<Schema$Operation>
3893
+ ): void;
3894
+ upgrade(
3895
+ params: Params$Resource$Projects$Locations$Clusters$Upgrade,
3896
+ callback: BodyResponseCallback<Schema$Operation>
3897
+ ): void;
3898
+ upgrade(callback: BodyResponseCallback<Schema$Operation>): void;
3899
+ upgrade(
3900
+ paramsOrCallback?:
3901
+ | Params$Resource$Projects$Locations$Clusters$Upgrade
3902
+ | BodyResponseCallback<Schema$Operation>
3903
+ | BodyResponseCallback<Readable>,
3904
+ optionsOrCallback?:
3905
+ | MethodOptions
3906
+ | StreamMethodOptions
3907
+ | BodyResponseCallback<Schema$Operation>
3908
+ | BodyResponseCallback<Readable>,
3909
+ callback?:
3910
+ | BodyResponseCallback<Schema$Operation>
3911
+ | BodyResponseCallback<Readable>
3912
+ ): void | GaxiosPromise<Schema$Operation> | GaxiosPromise<Readable> {
3913
+ let params = (paramsOrCallback ||
3914
+ {}) as Params$Resource$Projects$Locations$Clusters$Upgrade;
3915
+ let options = (optionsOrCallback || {}) as MethodOptions;
3916
+
3917
+ if (typeof paramsOrCallback === 'function') {
3918
+ callback = paramsOrCallback;
3919
+ params = {} as Params$Resource$Projects$Locations$Clusters$Upgrade;
3920
+ options = {};
3921
+ }
3922
+
3923
+ if (typeof optionsOrCallback === 'function') {
3924
+ callback = optionsOrCallback;
3925
+ options = {};
3926
+ }
3927
+
3928
+ const rootUrl = options.rootUrl || 'https://alloydb.googleapis.com/';
3929
+ const parameters = {
3930
+ options: Object.assign(
3931
+ {
3932
+ url: (rootUrl + '/v1beta/{+name}:upgrade').replace(
3933
+ /([^:]\/)\/+/g,
3934
+ '$1'
3935
+ ),
3936
+ method: 'PATCH',
3937
+ apiVersion: '',
3938
+ },
3939
+ options
3940
+ ),
3941
+ params,
3942
+ requiredParams: ['name'],
3943
+ pathParams: ['name'],
3944
+ context: this.context,
3945
+ };
3946
+ if (callback) {
3947
+ createAPIRequest<Schema$Operation>(
3948
+ parameters,
3949
+ callback as BodyResponseCallback<unknown>
3950
+ );
3951
+ } else {
3952
+ return createAPIRequest<Schema$Operation>(parameters);
3953
+ }
3954
+ }
3528
3955
  }
3529
3956
 
3530
3957
  export interface Params$Resource$Projects$Locations$Clusters$Create
@@ -3538,11 +3965,11 @@ export namespace alloydb_v1beta {
3538
3965
  */
3539
3966
  parent?: string;
3540
3967
  /**
3541
- * 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 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).
3968
+ * 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).
3542
3969
  */
3543
3970
  requestId?: string;
3544
3971
  /**
3545
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the create request.
3972
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
3546
3973
  */
3547
3974
  validateOnly?: boolean;
3548
3975
 
@@ -3562,11 +3989,11 @@ export namespace alloydb_v1beta {
3562
3989
  */
3563
3990
  parent?: string;
3564
3991
  /**
3565
- * 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 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).
3992
+ * 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).
3566
3993
  */
3567
3994
  requestId?: string;
3568
3995
  /**
3569
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the create request.
3996
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
3570
3997
  */
3571
3998
  validateOnly?: boolean;
3572
3999
 
@@ -3590,14 +4017,26 @@ export namespace alloydb_v1beta {
3590
4017
  */
3591
4018
  name?: string;
3592
4019
  /**
3593
- * 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).
4020
+ * 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).
3594
4021
  */
3595
4022
  requestId?: string;
3596
4023
  /**
3597
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the delete.
4024
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
3598
4025
  */
3599
4026
  validateOnly?: boolean;
3600
4027
  }
4028
+ export interface Params$Resource$Projects$Locations$Clusters$Export
4029
+ extends StandardParameters {
4030
+ /**
4031
+ * Required. The resource name of the cluster.
4032
+ */
4033
+ name?: string;
4034
+
4035
+ /**
4036
+ * Request body metadata
4037
+ */
4038
+ requestBody?: Schema$ExportClusterRequest;
4039
+ }
3601
4040
  export interface Params$Resource$Projects$Locations$Clusters$Get
3602
4041
  extends StandardParameters {
3603
4042
  /**
@@ -3643,7 +4082,7 @@ export namespace alloydb_v1beta {
3643
4082
  */
3644
4083
  name?: string;
3645
4084
  /**
3646
- * 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 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).
4085
+ * 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).
3647
4086
  */
3648
4087
  requestId?: string;
3649
4088
  /**
@@ -3651,7 +4090,7 @@ export namespace alloydb_v1beta {
3651
4090
  */
3652
4091
  updateMask?: string;
3653
4092
  /**
3654
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the update request.
4093
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
3655
4094
  */
3656
4095
  validateOnly?: boolean;
3657
4096
 
@@ -3684,6 +4123,18 @@ export namespace alloydb_v1beta {
3684
4123
  */
3685
4124
  requestBody?: Schema$RestoreClusterRequest;
3686
4125
  }
4126
+ export interface Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql
4127
+ extends StandardParameters {
4128
+ /**
4129
+ * Required. The location of the new cluster. For the required format, see the comment on Cluster.name field.
4130
+ */
4131
+ parent?: string;
4132
+
4133
+ /**
4134
+ * Request body metadata
4135
+ */
4136
+ requestBody?: Schema$RestoreFromCloudSQLRequest;
4137
+ }
3687
4138
  export interface Params$Resource$Projects$Locations$Clusters$Switchover
3688
4139
  extends StandardParameters {
3689
4140
  /**
@@ -3696,6 +4147,18 @@ export namespace alloydb_v1beta {
3696
4147
  */
3697
4148
  requestBody?: Schema$SwitchoverClusterRequest;
3698
4149
  }
4150
+ export interface Params$Resource$Projects$Locations$Clusters$Upgrade
4151
+ extends StandardParameters {
4152
+ /**
4153
+ * Required. The resource name of the cluster.
4154
+ */
4155
+ name?: string;
4156
+
4157
+ /**
4158
+ * Request body metadata
4159
+ */
4160
+ requestBody?: Schema$UpgradeClusterRequest;
4161
+ }
3699
4162
 
3700
4163
  export class Resource$Projects$Locations$Clusters$Instances {
3701
4164
  context: APIRequestContext;
@@ -4602,11 +5065,11 @@ export namespace alloydb_v1beta {
4602
5065
  */
4603
5066
  parent?: string;
4604
5067
  /**
4605
- * 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 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).
5068
+ * 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).
4606
5069
  */
4607
5070
  requestId?: string;
4608
5071
  /**
4609
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the create request.
5072
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
4610
5073
  */
4611
5074
  validateOnly?: boolean;
4612
5075
 
@@ -4626,11 +5089,11 @@ export namespace alloydb_v1beta {
4626
5089
  */
4627
5090
  parent?: string;
4628
5091
  /**
4629
- * 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 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).
5092
+ * 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).
4630
5093
  */
4631
5094
  requestId?: string;
4632
5095
  /**
4633
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the create request.
5096
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
4634
5097
  */
4635
5098
  validateOnly?: boolean;
4636
5099
 
@@ -4650,11 +5113,11 @@ export namespace alloydb_v1beta {
4650
5113
  */
4651
5114
  name?: string;
4652
5115
  /**
4653
- * 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).
5116
+ * 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).
4654
5117
  */
4655
5118
  requestId?: string;
4656
5119
  /**
4657
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the delete.
5120
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
4658
5121
  */
4659
5122
  validateOnly?: boolean;
4660
5123
  }
@@ -4688,7 +5151,7 @@ export namespace alloydb_v1beta {
4688
5151
  */
4689
5152
  parent?: string;
4690
5153
  /**
4691
- * 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).
5154
+ * 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).
4692
5155
  */
4693
5156
  requestId?: string;
4694
5157
  }
@@ -4738,7 +5201,7 @@ export namespace alloydb_v1beta {
4738
5201
  */
4739
5202
  name?: string;
4740
5203
  /**
4741
- * 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 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).
5204
+ * 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).
4742
5205
  */
4743
5206
  requestId?: string;
4744
5207
  /**
@@ -4746,7 +5209,7 @@ export namespace alloydb_v1beta {
4746
5209
  */
4747
5210
  updateMask?: string;
4748
5211
  /**
4749
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the update request.
5212
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
4750
5213
  */
4751
5214
  validateOnly?: boolean;
4752
5215
 
@@ -5216,7 +5679,7 @@ export namespace alloydb_v1beta {
5216
5679
  */
5217
5680
  parent?: string;
5218
5681
  /**
5219
- * 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 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).
5682
+ * 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).
5220
5683
  */
5221
5684
  requestId?: string;
5222
5685
  /**
@@ -5240,7 +5703,7 @@ export namespace alloydb_v1beta {
5240
5703
  */
5241
5704
  name?: string;
5242
5705
  /**
5243
- * 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).
5706
+ * 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).
5244
5707
  */
5245
5708
  requestId?: string;
5246
5709
  /**
@@ -5289,7 +5752,7 @@ export namespace alloydb_v1beta {
5289
5752
  */
5290
5753
  name?: string;
5291
5754
  /**
5292
- * 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 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).
5755
+ * 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).
5293
5756
  */
5294
5757
  requestId?: string;
5295
5758
  /**
@@ -5314,7 +5777,7 @@ export namespace alloydb_v1beta {
5314
5777
  }
5315
5778
 
5316
5779
  /**
5317
- * 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`.
5780
+ * 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`.
5318
5781
  *
5319
5782
  * @param params - Parameters for request
5320
5783
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.