@googleapis/alloydb 11.1.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/v1alpha.ts CHANGED
@@ -254,6 +254,10 @@ export namespace alloydb_v1alpha {
254
254
  * Output only. The current state of the backup.
255
255
  */
256
256
  state?: string | null;
257
+ /**
258
+ * Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: ``` "123/environment": "production", "123/costCenter": "marketing" ```
259
+ */
260
+ tags?: {[key: string]: string} | null;
257
261
  /**
258
262
  * The backup type, which suggests the trigger for the backup.
259
263
  */
@@ -293,7 +297,7 @@ export namespace alloydb_v1alpha {
293
297
  */
294
298
  requireConnectors?: boolean | null;
295
299
  /**
296
- * Optional. SSL config option for this instance.
300
+ * Optional. SSL configuration option for this instance.
297
301
  */
298
302
  sslConfig?: Schema$SslConfig;
299
303
  }
@@ -456,6 +460,10 @@ export namespace alloydb_v1alpha {
456
460
  * Optional. Subscription type of the cluster.
457
461
  */
458
462
  subscriptionType?: string | null;
463
+ /**
464
+ * Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: ``` "123/environment": "production", "123/costCenter": "marketing" ```
465
+ */
466
+ tags?: {[key: string]: string} | null;
459
467
  /**
460
468
  * Output only. Metadata for free trial clusters
461
469
  */
@@ -578,6 +586,27 @@ export namespace alloydb_v1alpha {
578
586
  */
579
587
  pointInTime?: string | null;
580
588
  }
589
+ /**
590
+ * Options for exporting data in CSV format.
591
+ */
592
+ export interface Schema$CsvExportOptions {
593
+ /**
594
+ * 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.
595
+ */
596
+ escapeCharacter?: string | null;
597
+ /**
598
+ * 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.
599
+ */
600
+ fieldDelimiter?: string | null;
601
+ /**
602
+ * 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.
603
+ */
604
+ quoteCharacter?: string | null;
605
+ /**
606
+ * Required. The SELECT query used to extract the data.
607
+ */
608
+ selectQuery?: string | null;
609
+ }
581
610
  /**
582
611
  * 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); \}
583
612
  */
@@ -604,19 +633,49 @@ export namespace alloydb_v1alpha {
604
633
  */
605
634
  kmsKeyVersions?: string[] | null;
606
635
  }
636
+ /**
637
+ * Export cluster request.
638
+ */
639
+ export interface Schema$ExportClusterRequest {
640
+ /**
641
+ * Options for exporting data in CSV format. Required field to be set for CSV file type.
642
+ */
643
+ csvExportOptions?: Schema$CsvExportOptions;
644
+ /**
645
+ * 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.
646
+ */
647
+ database?: string | null;
648
+ /**
649
+ * Required. Option to export data to cloud storage.
650
+ */
651
+ gcsDestination?: Schema$GcsDestination;
652
+ /**
653
+ * Options for exporting data in SQL format. Required field to be set for SQL file type.
654
+ */
655
+ sqlExportOptions?: Schema$SqlExportOptions;
656
+ }
607
657
  /**
608
658
  * Message for triggering failover on an Instance
609
659
  */
610
660
  export interface Schema$FailoverInstanceRequest {
611
661
  /**
612
- * 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).
662
+ * 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).
613
663
  */
614
664
  requestId?: string | null;
615
665
  /**
616
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the failover.
666
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
617
667
  */
618
668
  validateOnly?: boolean | null;
619
669
  }
670
+ /**
671
+ * Destination for Export. Export will be done to cloud storage.
672
+ */
673
+ export interface Schema$GcsDestination {
674
+ /**
675
+ * 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`.
676
+ */
677
+ uri?: string | null;
678
+ }
620
679
  /**
621
680
  * Cluster level configuration parameters related to the Gemini in Databases add-on.
622
681
  */
@@ -678,19 +737,19 @@ export namespace alloydb_v1alpha {
678
737
  */
679
738
  export interface Schema$GoogleTypeTimeOfDay {
680
739
  /**
681
- * 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.
740
+ * 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.
682
741
  */
683
742
  hours?: number | null;
684
743
  /**
685
- * Minutes of hour of day. Must be from 0 to 59.
744
+ * Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
686
745
  */
687
746
  minutes?: number | null;
688
747
  /**
689
- * Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
748
+ * Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
690
749
  */
691
750
  nanos?: number | null;
692
751
  /**
693
- * 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.
752
+ * 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.
694
753
  */
695
754
  seconds?: number | null;
696
755
  }
@@ -703,11 +762,11 @@ export namespace alloydb_v1alpha {
703
762
  */
704
763
  faultType?: string | null;
705
764
  /**
706
- * 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).
765
+ * 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).
707
766
  */
708
767
  requestId?: string | null;
709
768
  /**
710
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the fault injection.
769
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
711
770
  */
712
771
  validateOnly?: boolean | null;
713
772
  }
@@ -732,7 +791,7 @@ export namespace alloydb_v1alpha {
732
791
  */
733
792
  createTime?: string | null;
734
793
  /**
735
- * 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.
794
+ * 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.
736
795
  */
737
796
  databaseFlags?: {[key: string]: string} | null;
738
797
  /**
@@ -776,7 +835,7 @@ export namespace alloydb_v1alpha {
776
835
  */
777
836
  name?: string | null;
778
837
  /**
779
- * Optional. Instance level network configuration.
838
+ * Optional. Instance-level network configuration.
780
839
  */
781
840
  networkConfig?: Schema$InstanceNetworkConfig;
782
841
  /**
@@ -841,7 +900,7 @@ export namespace alloydb_v1alpha {
841
900
  writableNode?: Schema$Node;
842
901
  }
843
902
  /**
844
- * Metadata related to instance level network configuration.
903
+ * Metadata related to instance-level network configuration.
845
904
  */
846
905
  export interface Schema$InstanceNetworkConfig {
847
906
  /**
@@ -1056,19 +1115,19 @@ export namespace alloydb_v1alpha {
1056
1115
  */
1057
1116
  export interface Schema$Node {
1058
1117
  /**
1059
- * The identifier of the VM e.g. "test-read-0601-407e52be-ms3l".
1118
+ * Output only. The identifier of the VM e.g. "test-read-0601-407e52be-ms3l".
1060
1119
  */
1061
1120
  id?: string | null;
1062
1121
  /**
1063
- * The private IP address of the VM e.g. "10.57.0.34".
1122
+ * Output only. The private IP address of the VM e.g. "10.57.0.34".
1064
1123
  */
1065
1124
  ip?: string | null;
1066
1125
  /**
1067
- * 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.
1126
+ * 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.
1068
1127
  */
1069
1128
  state?: string | null;
1070
1129
  /**
1071
- * The Compute Engine zone of the VM e.g. "us-central1-b".
1130
+ * Output only. The Compute Engine zone of the VM e.g. "us-central1-b".
1072
1131
  */
1073
1132
  zoneId?: string | null;
1074
1133
  }
@@ -1155,7 +1214,7 @@ export namespace alloydb_v1alpha {
1155
1214
  */
1156
1215
  endTime?: string | null;
1157
1216
  /**
1158
- * 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`.
1217
+ * 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`.
1159
1218
  */
1160
1219
  requestedCancellation?: boolean | null;
1161
1220
  /**
@@ -1189,11 +1248,11 @@ export namespace alloydb_v1alpha {
1189
1248
  */
1190
1249
  etag?: string | null;
1191
1250
  /**
1192
- * 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).
1251
+ * 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).
1193
1252
  */
1194
1253
  requestId?: string | null;
1195
1254
  /**
1196
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the delete.
1255
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
1197
1256
  */
1198
1257
  validateOnly?: boolean | null;
1199
1258
  }
@@ -1205,6 +1264,10 @@ export namespace alloydb_v1alpha {
1205
1264
  * Optional. Create an instance that allows connections from Private Service Connect endpoints to the instance.
1206
1265
  */
1207
1266
  pscEnabled?: boolean | null;
1267
+ /**
1268
+ * Output only. The project number that needs to be allowlisted on the network attachment to enable outbound connectivity.
1269
+ */
1270
+ serviceOwnedProjectNumber?: string | null;
1208
1271
  }
1209
1272
  /**
1210
1273
  * PscInstanceConfig contains PSC related configuration at an instance level.
@@ -1218,11 +1281,24 @@ export namespace alloydb_v1alpha {
1218
1281
  * Output only. The DNS name of the instance for PSC connectivity. Name convention: ...alloydb-psc.goog
1219
1282
  */
1220
1283
  pscDnsName?: string | null;
1284
+ /**
1285
+ * Optional. Configurations for setting up PSC interfaces attached to the instance which are used for outbound connectivity. Only primary instances can have PSC interface attached. Currently we only support 0 or 1 PSC interface.
1286
+ */
1287
+ pscInterfaceConfigs?: Schema$PscInterfaceConfig[];
1221
1288
  /**
1222
1289
  * Output only. The service attachment created when Private Service Connect (PSC) is enabled for the instance. The name of the resource will be in the format of `projects//regions//serviceAttachments/`
1223
1290
  */
1224
1291
  serviceAttachmentLink?: string | null;
1225
1292
  }
1293
+ /**
1294
+ * Configuration for setting up a PSC interface to enable outbound connectivity.
1295
+ */
1296
+ export interface Schema$PscInterfaceConfig {
1297
+ /**
1298
+ * The network attachment resource created in the consumer network to which the PSC interface will be linked. This is of the format: "projects/${CONSUMER_PROJECT\}/regions/${REGION\}/networkAttachments/${NETWORK_ATTACHMENT_NAME\}". The network attachment must be in the same region as the instance.
1299
+ */
1300
+ networkAttachmentResource?: string | null;
1301
+ }
1226
1302
  /**
1227
1303
  * A backup's position in a quantity-based retention queue, of backups with the same source cluster and type, with length, retention, specified by the backup's retention policy. Once the position is greater than the retention, the backup is eligible to be garbage collected. Example: 5 backups from the same source cluster and type with a quantity-based retention of 3 and denoted by backup_id (position, retention). Safe: backup_5 (1, 3), backup_4, (2, 3), backup_3 (3, 3). Awaiting garbage collection: backup_2 (4, 3), backup_1 (5, 3)
1228
1304
  */
@@ -1277,15 +1353,15 @@ export namespace alloydb_v1alpha {
1277
1353
  }
1278
1354
  export interface Schema$RestartInstanceRequest {
1279
1355
  /**
1280
- * Optional. Full name of the nodes as obtained from INSTANCE_VIEW_FULL to restart upon. Only applicable for read instances.
1356
+ * Optional. Full name of the nodes as obtained from INSTANCE_VIEW_FULL to restart upon. Applicable only to read instances.
1281
1357
  */
1282
1358
  nodeIds?: string[] | null;
1283
1359
  /**
1284
- * 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).
1360
+ * 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).
1285
1361
  */
1286
1362
  requestId?: string | null;
1287
1363
  /**
1288
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the restart.
1364
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
1289
1365
  */
1290
1366
  validateOnly?: boolean | null;
1291
1367
  }
@@ -1310,14 +1386,31 @@ export namespace alloydb_v1alpha {
1310
1386
  */
1311
1387
  continuousBackupSource?: Schema$ContinuousBackupSource;
1312
1388
  /**
1313
- * 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).
1389
+ * 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).
1314
1390
  */
1315
1391
  requestId?: string | null;
1316
1392
  /**
1317
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the import request.
1393
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
1318
1394
  */
1319
1395
  validateOnly?: boolean | null;
1320
1396
  }
1397
+ /**
1398
+ * Message for registering Restoring from CloudSQL resource.
1399
+ */
1400
+ export interface Schema$RestoreFromCloudSQLRequest {
1401
+ /**
1402
+ * Cluster created from CloudSQL backup run.
1403
+ */
1404
+ cloudsqlBackupRunSource?: Schema$CloudSQLBackupRunSource;
1405
+ /**
1406
+ * Required. The resource being created
1407
+ */
1408
+ cluster?: Schema$Cluster;
1409
+ /**
1410
+ * Required. ID of the requesting object.
1411
+ */
1412
+ clusterId?: string | null;
1413
+ }
1321
1414
  /**
1322
1415
  * Configuration information for the secondary cluster. This should be set if and only if the cluster is of type SECONDARY.
1323
1416
  */
@@ -1327,6 +1420,27 @@ export namespace alloydb_v1alpha {
1327
1420
  */
1328
1421
  primaryClusterName?: string | null;
1329
1422
  }
1423
+ /**
1424
+ * Options for exporting data in SQL format.
1425
+ */
1426
+ export interface Schema$SqlExportOptions {
1427
+ /**
1428
+ * Optional. If true, output commands to DROP all the dumped database objects prior to outputting the commands for creating them.
1429
+ */
1430
+ cleanTargetObjects?: boolean | null;
1431
+ /**
1432
+ * Optional. If true, use DROP ... IF EXISTS commands to check for the object's existence before dropping it in clean_target_objects mode.
1433
+ */
1434
+ ifExistTargetObjects?: boolean | null;
1435
+ /**
1436
+ * Optional. If true, only export the schema.
1437
+ */
1438
+ schemaOnly?: boolean | null;
1439
+ /**
1440
+ * Optional. Tables to export from.
1441
+ */
1442
+ tables?: string[] | null;
1443
+ }
1330
1444
  /**
1331
1445
  * SSL configuration.
1332
1446
  */
@@ -1554,7 +1668,7 @@ export namespace alloydb_v1alpha {
1554
1668
  uniqueId?: string | null;
1555
1669
  }
1556
1670
  /**
1557
- * Common model for database resource instance metadata.
1671
+ * Common model for database resource instance metadata. Next ID: 23
1558
1672
  */
1559
1673
  export interface Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata {
1560
1674
  /**
@@ -1581,6 +1695,10 @@ export namespace alloydb_v1alpha {
1581
1695
  * Any custom metadata associated with the resource
1582
1696
  */
1583
1697
  customMetadata?: Schema$StorageDatabasecenterPartnerapiV1mainCustomMetadataData;
1698
+ /**
1699
+ * 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.
1700
+ */
1701
+ edition?: string | null;
1584
1702
  /**
1585
1703
  * Entitlements associated with the resource
1586
1704
  */
@@ -1609,6 +1727,10 @@ export namespace alloydb_v1alpha {
1609
1727
  * 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.
1610
1728
  */
1611
1729
  primaryResourceId?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId;
1730
+ /**
1731
+ * Primary resource location. REQUIRED if the immediate parent exists when first time resource is getting ingested, otherwise optional.
1732
+ */
1733
+ primaryResourceLocation?: string | null;
1612
1734
  /**
1613
1735
  * The product this resource represents.
1614
1736
  */
@@ -1621,6 +1743,10 @@ export namespace alloydb_v1alpha {
1621
1743
  * 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
1622
1744
  */
1623
1745
  resourceName?: string | null;
1746
+ /**
1747
+ * Optional. Tags associated with this resources.
1748
+ */
1749
+ tagsSet?: Schema$StorageDatabasecenterPartnerapiV1mainTags;
1624
1750
  /**
1625
1751
  * The time at which the resource was updated and recorded at partner service.
1626
1752
  */
@@ -1704,13 +1830,21 @@ export namespace alloydb_v1alpha {
1704
1830
  */
1705
1831
  export interface Schema$StorageDatabasecenterPartnerapiV1mainMachineConfiguration {
1706
1832
  /**
1707
- * The number of CPUs. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
1833
+ * The number of CPUs. Deprecated. Use vcpu_count instead. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
1708
1834
  */
1709
1835
  cpuCount?: number | null;
1710
1836
  /**
1711
1837
  * Memory size in bytes. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
1712
1838
  */
1713
1839
  memorySizeInBytes?: string | null;
1840
+ /**
1841
+ * Optional. Number of shards (if applicable).
1842
+ */
1843
+ shardCount?: number | null;
1844
+ /**
1845
+ * Optional. The number of vCPUs. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
1846
+ */
1847
+ vcpuCount?: number | null;
1714
1848
  }
1715
1849
  export interface Schema$StorageDatabasecenterPartnerapiV1mainObservabilityMetricData {
1716
1850
  /**
@@ -1749,12 +1883,29 @@ export namespace alloydb_v1alpha {
1749
1883
  message?: string | null;
1750
1884
  }
1751
1885
  export interface Schema$StorageDatabasecenterPartnerapiV1mainRetentionSettings {
1886
+ /**
1887
+ * Duration based retention period i.e. 172800 seconds (2 days)
1888
+ */
1889
+ durationBasedRetention?: string | null;
1752
1890
  quantityBasedRetention?: number | null;
1753
1891
  /**
1754
1892
  * The unit that 'retained_backups' represents.
1755
1893
  */
1756
1894
  retentionUnit?: string | null;
1757
1895
  timeBasedRetention?: string | null;
1896
+ /**
1897
+ * Timestamp based retention period i.e. 2024-05-01T00:00:00Z
1898
+ */
1899
+ timestampBasedRetentionTime?: string | null;
1900
+ }
1901
+ /**
1902
+ * 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.
1903
+ */
1904
+ export interface Schema$StorageDatabasecenterPartnerapiV1mainTags {
1905
+ /**
1906
+ * The Tag key/value mappings.
1907
+ */
1908
+ tags?: {[key: string]: string} | null;
1758
1909
  }
1759
1910
  /**
1760
1911
  * 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.
@@ -1848,11 +1999,11 @@ export namespace alloydb_v1alpha {
1848
1999
  */
1849
2000
  export interface Schema$SwitchoverClusterRequest {
1850
2001
  /**
1851
- * 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).
2002
+ * 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).
1852
2003
  */
1853
2004
  requestId?: string | null;
1854
2005
  /**
1855
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the delete.
2006
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
1856
2007
  */
1857
2008
  validateOnly?: boolean | null;
1858
2009
  }
@@ -1904,11 +2055,11 @@ export namespace alloydb_v1alpha {
1904
2055
  */
1905
2056
  etag?: string | null;
1906
2057
  /**
1907
- * 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).
2058
+ * 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).
1908
2059
  */
1909
2060
  requestId?: string | null;
1910
2061
  /**
1911
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but does not actually execute the upgrade.
2062
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
1912
2063
  */
1913
2064
  validateOnly?: boolean | null;
1914
2065
  /**
@@ -2680,7 +2831,7 @@ export namespace alloydb_v1alpha {
2680
2831
  */
2681
2832
  parent?: string;
2682
2833
  /**
2683
- * 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).
2834
+ * 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).
2684
2835
  */
2685
2836
  requestId?: string;
2686
2837
  /**
@@ -2704,7 +2855,7 @@ export namespace alloydb_v1alpha {
2704
2855
  */
2705
2856
  name?: string;
2706
2857
  /**
2707
- * 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).
2858
+ * 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).
2708
2859
  */
2709
2860
  requestId?: string;
2710
2861
  /**
@@ -2753,7 +2904,7 @@ export namespace alloydb_v1alpha {
2753
2904
  */
2754
2905
  name?: string;
2755
2906
  /**
2756
- * 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).
2907
+ * 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).
2757
2908
  */
2758
2909
  requestId?: string;
2759
2910
  /**
@@ -3044,6 +3195,94 @@ export namespace alloydb_v1alpha {
3044
3195
  }
3045
3196
  }
3046
3197
 
3198
+ /**
3199
+ * Exports data from the cluster. Imperative only.
3200
+ *
3201
+ * @param params - Parameters for request
3202
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
3203
+ * @param callback - Optional callback that handles the response.
3204
+ * @returns A promise if used with async/await, or void if used with a callback.
3205
+ */
3206
+ export(
3207
+ params: Params$Resource$Projects$Locations$Clusters$Export,
3208
+ options: StreamMethodOptions
3209
+ ): GaxiosPromise<Readable>;
3210
+ export(
3211
+ params?: Params$Resource$Projects$Locations$Clusters$Export,
3212
+ options?: MethodOptions
3213
+ ): GaxiosPromise<Schema$Operation>;
3214
+ export(
3215
+ params: Params$Resource$Projects$Locations$Clusters$Export,
3216
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
3217
+ callback: BodyResponseCallback<Readable>
3218
+ ): void;
3219
+ export(
3220
+ params: Params$Resource$Projects$Locations$Clusters$Export,
3221
+ options: MethodOptions | BodyResponseCallback<Schema$Operation>,
3222
+ callback: BodyResponseCallback<Schema$Operation>
3223
+ ): void;
3224
+ export(
3225
+ params: Params$Resource$Projects$Locations$Clusters$Export,
3226
+ callback: BodyResponseCallback<Schema$Operation>
3227
+ ): void;
3228
+ export(callback: BodyResponseCallback<Schema$Operation>): void;
3229
+ export(
3230
+ paramsOrCallback?:
3231
+ | Params$Resource$Projects$Locations$Clusters$Export
3232
+ | BodyResponseCallback<Schema$Operation>
3233
+ | BodyResponseCallback<Readable>,
3234
+ optionsOrCallback?:
3235
+ | MethodOptions
3236
+ | StreamMethodOptions
3237
+ | BodyResponseCallback<Schema$Operation>
3238
+ | BodyResponseCallback<Readable>,
3239
+ callback?:
3240
+ | BodyResponseCallback<Schema$Operation>
3241
+ | BodyResponseCallback<Readable>
3242
+ ): void | GaxiosPromise<Schema$Operation> | GaxiosPromise<Readable> {
3243
+ let params = (paramsOrCallback ||
3244
+ {}) as Params$Resource$Projects$Locations$Clusters$Export;
3245
+ let options = (optionsOrCallback || {}) as MethodOptions;
3246
+
3247
+ if (typeof paramsOrCallback === 'function') {
3248
+ callback = paramsOrCallback;
3249
+ params = {} as Params$Resource$Projects$Locations$Clusters$Export;
3250
+ options = {};
3251
+ }
3252
+
3253
+ if (typeof optionsOrCallback === 'function') {
3254
+ callback = optionsOrCallback;
3255
+ options = {};
3256
+ }
3257
+
3258
+ const rootUrl = options.rootUrl || 'https://alloydb.googleapis.com/';
3259
+ const parameters = {
3260
+ options: Object.assign(
3261
+ {
3262
+ url: (rootUrl + '/v1alpha/{+name}:export').replace(
3263
+ /([^:]\/)\/+/g,
3264
+ '$1'
3265
+ ),
3266
+ method: 'POST',
3267
+ apiVersion: '',
3268
+ },
3269
+ options
3270
+ ),
3271
+ params,
3272
+ requiredParams: ['name'],
3273
+ pathParams: ['name'],
3274
+ context: this.context,
3275
+ };
3276
+ if (callback) {
3277
+ createAPIRequest<Schema$Operation>(
3278
+ parameters,
3279
+ callback as BodyResponseCallback<unknown>
3280
+ );
3281
+ } else {
3282
+ return createAPIRequest<Schema$Operation>(parameters);
3283
+ }
3284
+ }
3285
+
3047
3286
  /**
3048
3287
  * Gets details of a single Cluster.
3049
3288
  *
@@ -3484,7 +3723,95 @@ export namespace alloydb_v1alpha {
3484
3723
  }
3485
3724
 
3486
3725
  /**
3487
- * 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.
3726
+ * Restores an AlloyDB cluster from a CloudSQL resource.
3727
+ *
3728
+ * @param params - Parameters for request
3729
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
3730
+ * @param callback - Optional callback that handles the response.
3731
+ * @returns A promise if used with async/await, or void if used with a callback.
3732
+ */
3733
+ restoreFromCloudSQL(
3734
+ params: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql,
3735
+ options: StreamMethodOptions
3736
+ ): GaxiosPromise<Readable>;
3737
+ restoreFromCloudSQL(
3738
+ params?: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql,
3739
+ options?: MethodOptions
3740
+ ): GaxiosPromise<Schema$Operation>;
3741
+ restoreFromCloudSQL(
3742
+ params: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql,
3743
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
3744
+ callback: BodyResponseCallback<Readable>
3745
+ ): void;
3746
+ restoreFromCloudSQL(
3747
+ params: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql,
3748
+ options: MethodOptions | BodyResponseCallback<Schema$Operation>,
3749
+ callback: BodyResponseCallback<Schema$Operation>
3750
+ ): void;
3751
+ restoreFromCloudSQL(
3752
+ params: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql,
3753
+ callback: BodyResponseCallback<Schema$Operation>
3754
+ ): void;
3755
+ restoreFromCloudSQL(callback: BodyResponseCallback<Schema$Operation>): void;
3756
+ restoreFromCloudSQL(
3757
+ paramsOrCallback?:
3758
+ | Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql
3759
+ | BodyResponseCallback<Schema$Operation>
3760
+ | BodyResponseCallback<Readable>,
3761
+ optionsOrCallback?:
3762
+ | MethodOptions
3763
+ | StreamMethodOptions
3764
+ | BodyResponseCallback<Schema$Operation>
3765
+ | BodyResponseCallback<Readable>,
3766
+ callback?:
3767
+ | BodyResponseCallback<Schema$Operation>
3768
+ | BodyResponseCallback<Readable>
3769
+ ): void | GaxiosPromise<Schema$Operation> | GaxiosPromise<Readable> {
3770
+ let params = (paramsOrCallback ||
3771
+ {}) as Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql;
3772
+ let options = (optionsOrCallback || {}) as MethodOptions;
3773
+
3774
+ if (typeof paramsOrCallback === 'function') {
3775
+ callback = paramsOrCallback;
3776
+ params =
3777
+ {} as Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql;
3778
+ options = {};
3779
+ }
3780
+
3781
+ if (typeof optionsOrCallback === 'function') {
3782
+ callback = optionsOrCallback;
3783
+ options = {};
3784
+ }
3785
+
3786
+ const rootUrl = options.rootUrl || 'https://alloydb.googleapis.com/';
3787
+ const parameters = {
3788
+ options: Object.assign(
3789
+ {
3790
+ url: (
3791
+ rootUrl + '/v1alpha/{+parent}/clusters:restoreFromCloudSQL'
3792
+ ).replace(/([^:]\/)\/+/g, '$1'),
3793
+ method: 'POST',
3794
+ apiVersion: '',
3795
+ },
3796
+ options
3797
+ ),
3798
+ params,
3799
+ requiredParams: ['parent'],
3800
+ pathParams: ['parent'],
3801
+ context: this.context,
3802
+ };
3803
+ if (callback) {
3804
+ createAPIRequest<Schema$Operation>(
3805
+ parameters,
3806
+ callback as BodyResponseCallback<unknown>
3807
+ );
3808
+ } else {
3809
+ return createAPIRequest<Schema$Operation>(parameters);
3810
+ }
3811
+ }
3812
+
3813
+ /**
3814
+ * 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.
3488
3815
  *
3489
3816
  * @param params - Parameters for request
3490
3817
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3671,11 +3998,11 @@ export namespace alloydb_v1alpha {
3671
3998
  */
3672
3999
  parent?: string;
3673
4000
  /**
3674
- * 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).
4001
+ * 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).
3675
4002
  */
3676
4003
  requestId?: string;
3677
4004
  /**
3678
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the create request.
4005
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
3679
4006
  */
3680
4007
  validateOnly?: boolean;
3681
4008
 
@@ -3695,11 +4022,11 @@ export namespace alloydb_v1alpha {
3695
4022
  */
3696
4023
  parent?: string;
3697
4024
  /**
3698
- * 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).
4025
+ * 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).
3699
4026
  */
3700
4027
  requestId?: string;
3701
4028
  /**
3702
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the create request.
4029
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
3703
4030
  */
3704
4031
  validateOnly?: boolean;
3705
4032
 
@@ -3723,14 +4050,26 @@ export namespace alloydb_v1alpha {
3723
4050
  */
3724
4051
  name?: string;
3725
4052
  /**
3726
- * 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).
4053
+ * 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).
3727
4054
  */
3728
4055
  requestId?: string;
3729
4056
  /**
3730
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the delete.
4057
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
3731
4058
  */
3732
4059
  validateOnly?: boolean;
3733
4060
  }
4061
+ export interface Params$Resource$Projects$Locations$Clusters$Export
4062
+ extends StandardParameters {
4063
+ /**
4064
+ * Required. The resource name of the cluster.
4065
+ */
4066
+ name?: string;
4067
+
4068
+ /**
4069
+ * Request body metadata
4070
+ */
4071
+ requestBody?: Schema$ExportClusterRequest;
4072
+ }
3734
4073
  export interface Params$Resource$Projects$Locations$Clusters$Get
3735
4074
  extends StandardParameters {
3736
4075
  /**
@@ -3776,7 +4115,7 @@ export namespace alloydb_v1alpha {
3776
4115
  */
3777
4116
  name?: string;
3778
4117
  /**
3779
- * 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).
4118
+ * 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).
3780
4119
  */
3781
4120
  requestId?: string;
3782
4121
  /**
@@ -3784,7 +4123,7 @@ export namespace alloydb_v1alpha {
3784
4123
  */
3785
4124
  updateMask?: string;
3786
4125
  /**
3787
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the update request.
4126
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
3788
4127
  */
3789
4128
  validateOnly?: boolean;
3790
4129
 
@@ -3817,6 +4156,18 @@ export namespace alloydb_v1alpha {
3817
4156
  */
3818
4157
  requestBody?: Schema$RestoreClusterRequest;
3819
4158
  }
4159
+ export interface Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql
4160
+ extends StandardParameters {
4161
+ /**
4162
+ * Required. The location of the new cluster. For the required format, see the comment on Cluster.name field.
4163
+ */
4164
+ parent?: string;
4165
+
4166
+ /**
4167
+ * Request body metadata
4168
+ */
4169
+ requestBody?: Schema$RestoreFromCloudSQLRequest;
4170
+ }
3820
4171
  export interface Params$Resource$Projects$Locations$Clusters$Switchover
3821
4172
  extends StandardParameters {
3822
4173
  /**
@@ -4747,11 +5098,11 @@ export namespace alloydb_v1alpha {
4747
5098
  */
4748
5099
  parent?: string;
4749
5100
  /**
4750
- * 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).
5101
+ * 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).
4751
5102
  */
4752
5103
  requestId?: string;
4753
5104
  /**
4754
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the create request.
5105
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
4755
5106
  */
4756
5107
  validateOnly?: boolean;
4757
5108
 
@@ -4771,11 +5122,11 @@ export namespace alloydb_v1alpha {
4771
5122
  */
4772
5123
  parent?: string;
4773
5124
  /**
4774
- * 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).
5125
+ * 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).
4775
5126
  */
4776
5127
  requestId?: string;
4777
5128
  /**
4778
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the create request.
5129
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
4779
5130
  */
4780
5131
  validateOnly?: boolean;
4781
5132
 
@@ -4795,11 +5146,11 @@ export namespace alloydb_v1alpha {
4795
5146
  */
4796
5147
  name?: string;
4797
5148
  /**
4798
- * 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).
5149
+ * 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).
4799
5150
  */
4800
5151
  requestId?: string;
4801
5152
  /**
4802
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the delete.
5153
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
4803
5154
  */
4804
5155
  validateOnly?: boolean;
4805
5156
  }
@@ -4833,7 +5184,7 @@ export namespace alloydb_v1alpha {
4833
5184
  */
4834
5185
  parent?: string;
4835
5186
  /**
4836
- * 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).
5187
+ * 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).
4837
5188
  */
4838
5189
  requestId?: string;
4839
5190
  }
@@ -4883,7 +5234,7 @@ export namespace alloydb_v1alpha {
4883
5234
  */
4884
5235
  name?: string;
4885
5236
  /**
4886
- * 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).
5237
+ * 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).
4887
5238
  */
4888
5239
  requestId?: string;
4889
5240
  /**
@@ -4891,7 +5242,7 @@ export namespace alloydb_v1alpha {
4891
5242
  */
4892
5243
  updateMask?: string;
4893
5244
  /**
4894
- * Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but do not actually execute the update request.
5245
+ * Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
4895
5246
  */
4896
5247
  validateOnly?: boolean;
4897
5248
 
@@ -5361,7 +5712,7 @@ export namespace alloydb_v1alpha {
5361
5712
  */
5362
5713
  parent?: string;
5363
5714
  /**
5364
- * 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).
5715
+ * 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).
5365
5716
  */
5366
5717
  requestId?: string;
5367
5718
  /**
@@ -5385,7 +5736,7 @@ export namespace alloydb_v1alpha {
5385
5736
  */
5386
5737
  name?: string;
5387
5738
  /**
5388
- * 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).
5739
+ * 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).
5389
5740
  */
5390
5741
  requestId?: string;
5391
5742
  /**
@@ -5434,7 +5785,7 @@ export namespace alloydb_v1alpha {
5434
5785
  */
5435
5786
  name?: string;
5436
5787
  /**
5437
- * 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).
5788
+ * 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).
5438
5789
  */
5439
5790
  requestId?: string;
5440
5791
  /**
@@ -5459,7 +5810,7 @@ export namespace alloydb_v1alpha {
5459
5810
  }
5460
5811
 
5461
5812
  /**
5462
- * 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`.
5813
+ * 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`.
5463
5814
  *
5464
5815
  * @param params - Parameters for request
5465
5816
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.