@googleapis/alloydb 11.3.0 → 12.1.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
@@ -146,7 +146,7 @@ export namespace alloydb_v1beta {
146
146
  */
147
147
  enabled?: boolean | null;
148
148
  /**
149
- * Optional. The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will then use default encryption scheme to protect the user data.
149
+ * Optional. The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will use the cluster's encryption config.
150
150
  */
151
151
  encryptionConfig?: Schema$EncryptionConfig;
152
152
  /**
@@ -186,6 +186,10 @@ export namespace alloydb_v1beta {
186
186
  * Output only. The system-generated UID of the cluster which was used to create this resource.
187
187
  */
188
188
  clusterUid?: string | null;
189
+ /**
190
+ * Output only. Timestamp when the resource finished being created.
191
+ */
192
+ createCompletionTime?: string | null;
189
193
  /**
190
194
  * Output only. Create time stamp
191
195
  */
@@ -263,7 +267,7 @@ export namespace alloydb_v1beta {
263
267
  */
264
268
  uid?: string | null;
265
269
  /**
266
- * Output only. Update time stamp
270
+ * Output only. Update time stamp Users should not infer any meaning from this field. Its value is generally unrelated to the timing of the backup creation operation.
267
271
  */
268
272
  updateTime?: string | null;
269
273
  }
@@ -384,7 +388,7 @@ export namespace alloydb_v1beta {
384
388
  */
385
389
  etag?: string | null;
386
390
  /**
387
- * Optional. Configuration parameters related to the Gemini in Databases add-on.
391
+ * Optional. Deprecated and unused. This field will be removed in the near future.
388
392
  */
389
393
  geminiConfig?: Schema$GeminiClusterConfig;
390
394
  /**
@@ -523,6 +527,59 @@ export namespace alloydb_v1beta {
523
527
  */
524
528
  publicIpAddress?: string | null;
525
529
  }
530
+ /**
531
+ * Configuration for Managed Connection Pool (MCP).
532
+ */
533
+ export interface Schema$ConnectionPoolConfig {
534
+ /**
535
+ * Optional. Deprecated. Use 'flags' instead. The default pool size. Defaults to 20.
536
+ */
537
+ defaultPoolSize?: string | null;
538
+ /**
539
+ * Optional. Deprecated; Prefer 'enabled' as this will be removed soon.
540
+ */
541
+ enable?: boolean | null;
542
+ /**
543
+ * Optional. Whether to enable Managed Connection Pool (MCP).
544
+ */
545
+ enabled?: boolean | null;
546
+ /**
547
+ * Optional. Connection Pool flags, as a list of "key": "value" pairs.
548
+ */
549
+ flags?: {[key: string]: string} | null;
550
+ /**
551
+ * Optional. Deprecated. Use 'flags' instead. The list of startup parameters to ignore. Defaults to ["extra_float_digits"]
552
+ */
553
+ ignoreStartupParameters?: string[] | null;
554
+ /**
555
+ * Optional. Deprecated. Use 'flags' instead. The maximum number of client connections allowed.
556
+ */
557
+ maxClientConn?: string | null;
558
+ /**
559
+ * Optional. Deprecated. Use 'flags' instead. The maximum number of prepared statements allowed. MCP makes sure that any statement prepared by a client, up to this limit, is available on the backing server connection in transaction and statement pooling mode. Even if the statement was originally prepared on another server connection. Defaults to 0.
560
+ */
561
+ maxPreparedStatements?: string | null;
562
+ /**
563
+ * Optional. Deprecated. Use 'flags' instead. The minimum pool size. Defaults to 0.
564
+ */
565
+ minPoolSize?: string | null;
566
+ /**
567
+ * Optional. Deprecated. Use 'flags' instead. The pool mode. Defaults to `POOL_MODE_TRANSACTION`.
568
+ */
569
+ poolMode?: string | null;
570
+ /**
571
+ * Optional. Deprecated. Use 'flags' instead. The maximum number of seconds queries are allowed to spend waiting for execution. If the query is not assigned to a server during that time, the client is disconnected. 0 disables.
572
+ */
573
+ queryWaitTimeout?: string | null;
574
+ /**
575
+ * Optional. Deprecated. Use 'flags' instead. The maximum number of seconds a server is allowed to be idle before it is disconnected. 0 disables.
576
+ */
577
+ serverIdleTimeout?: string | null;
578
+ /**
579
+ * Optional. Deprecated. Use 'flags' instead. The list of users that are allowed to connect to the MCP stats console. The users must exist in the database.
580
+ */
581
+ statsUsers?: string[] | null;
582
+ }
526
583
  /**
527
584
  * ContinuousBackupConfig describes the continuous backups recovery configurations of a cluster.
528
585
  */
@@ -532,7 +589,7 @@ export namespace alloydb_v1beta {
532
589
  */
533
590
  enabled?: boolean | null;
534
591
  /**
535
- * The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will then use default encryption scheme to protect the user data.
592
+ * The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will use the cluster's encryption config.
536
593
  */
537
594
  encryptionConfig?: Schema$EncryptionConfig;
538
595
  /**
@@ -595,6 +652,48 @@ export namespace alloydb_v1beta {
595
652
  */
596
653
  selectQuery?: string | null;
597
654
  }
655
+ /**
656
+ * Options for importing data in CSV format.
657
+ */
658
+ export interface Schema$CsvImportOptions {
659
+ /**
660
+ * Optional. The columns to which CSV data is imported. If not specified, all columns of the database table are loaded with CSV data.
661
+ */
662
+ columns?: string[] | null;
663
+ /**
664
+ * Optional. Specifies the character that should appear before a data character that needs to be escaped. The default is same as quote character. The value of this argument has to be a character in Hex ASCII Code.
665
+ */
666
+ escapeCharacter?: string | null;
667
+ /**
668
+ * 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.
669
+ */
670
+ fieldDelimiter?: string | null;
671
+ /**
672
+ * 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.
673
+ */
674
+ quoteCharacter?: string | null;
675
+ /**
676
+ * Required. The database table to import CSV file into.
677
+ */
678
+ table?: string | null;
679
+ }
680
+ /**
681
+ * DenyMaintenancePeriod definition. Excepting emergencies, maintenance will not be scheduled to start within this deny period. The start_date must be less than the end_date.
682
+ */
683
+ export interface Schema$DenyMaintenancePeriod {
684
+ /**
685
+ * Deny period end date. This can be: * A full date, with non-zero year, month and day values OR * A month and day value, with a zero year for recurring
686
+ */
687
+ endDate?: Schema$GoogleTypeDate;
688
+ /**
689
+ * Deny period start date. This can be: * A full date, with non-zero year, month and day values OR * A month and day value, with a zero year for recurring
690
+ */
691
+ startDate?: Schema$GoogleTypeDate;
692
+ /**
693
+ * Time in UTC when the deny period starts on start_date and ends on end_date. This can be: * Full time OR * All zeros for 00:00:00 UTC
694
+ */
695
+ time?: Schema$GoogleTypeTimeOfDay;
696
+ }
598
697
  /**
599
698
  * 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); \}
600
699
  */
@@ -655,6 +754,15 @@ export namespace alloydb_v1beta {
655
754
  */
656
755
  validateOnly?: boolean | null;
657
756
  }
757
+ /**
758
+ * Instance level configuration parameters related to the Gemini Cloud Assist product.
759
+ */
760
+ export interface Schema$GCAInstanceConfig {
761
+ /**
762
+ * Output only. Represents the GCA entitlement state of the instance.
763
+ */
764
+ gcaEntitlement?: string | null;
765
+ }
658
766
  /**
659
767
  * Destination for Export. Export will be done to cloud storage.
660
768
  */
@@ -665,20 +773,20 @@ export namespace alloydb_v1beta {
665
773
  uri?: string | null;
666
774
  }
667
775
  /**
668
- * Cluster level configuration parameters related to the Gemini in Databases add-on.
776
+ * Deprecated and unused. This field will be removed in the near future.
669
777
  */
670
778
  export interface Schema$GeminiClusterConfig {
671
779
  /**
672
- * Output only. Whether the Gemini in Databases add-on is enabled for the cluster. It will be true only if the add-on has been enabled for the billing account corresponding to the cluster. Its status is toggled from the Admin Control Center (ACC) and cannot be toggled using AlloyDB's APIs.
780
+ * Output only. Deprecated and unused. This field will be removed in the near future.
673
781
  */
674
782
  entitled?: boolean | null;
675
783
  }
676
784
  /**
677
- * Instance level configuration parameters related to the Gemini in Databases add-on.
785
+ * Deprecated and unused. This field will be removed in the near future.
678
786
  */
679
787
  export interface Schema$GeminiInstanceConfig {
680
788
  /**
681
- * Output only. Whether the Gemini in Databases add-on is enabled for the instance. It will be true only if the add-on has been enabled for the billing account corresponding to the instance. Its status is toggled from the Admin Control Center (ACC) and cannot be toggled using AlloyDB's APIs.
789
+ * Output only. Deprecated and unused. This field will be removed in the near future.
682
790
  */
683
791
  entitled?: boolean | null;
684
792
  }
@@ -720,6 +828,23 @@ export namespace alloydb_v1beta {
720
828
  */
721
829
  name?: string | null;
722
830
  }
831
+ /**
832
+ * Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
833
+ */
834
+ export interface Schema$GoogleTypeDate {
835
+ /**
836
+ * Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
837
+ */
838
+ day?: number | null;
839
+ /**
840
+ * Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
841
+ */
842
+ month?: number | null;
843
+ /**
844
+ * Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
845
+ */
846
+ year?: number | null;
847
+ }
723
848
  /**
724
849
  * Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.
725
850
  */
@@ -741,6 +866,31 @@ export namespace alloydb_v1beta {
741
866
  */
742
867
  seconds?: number | null;
743
868
  }
869
+ /**
870
+ * Import cluster request.
871
+ */
872
+ export interface Schema$ImportClusterRequest {
873
+ /**
874
+ * Options for importing data in CSV format.
875
+ */
876
+ csvImportOptions?: Schema$CsvImportOptions;
877
+ /**
878
+ * Optional. Name of the database to which the import will be done. For import from SQL file, this is required only if the file does not specify a database. Note - Value provided should be the same as expected from `SELECT current_database();` and NOT as a resource reference.
879
+ */
880
+ database?: string | null;
881
+ /**
882
+ * Required. The path to the file in Google Cloud Storage where the source file for import will be stored. The URI is in the form `gs://bucketName/fileName`.
883
+ */
884
+ gcsUri?: string | null;
885
+ /**
886
+ * Options for importing data in SQL format.
887
+ */
888
+ sqlImportOptions?: Schema$SqlImportOptions;
889
+ /**
890
+ * Optional. Database user to be used for importing the data. Note - Value provided should be the same as expected from `SELECT current_user;` and NOT as a resource reference.
891
+ */
892
+ user?: string | null;
893
+ }
744
894
  /**
745
895
  * Message for triggering fault injection on an instance
746
896
  */
@@ -774,6 +924,10 @@ export namespace alloydb_v1beta {
774
924
  * Optional. Client connection specific configurations
775
925
  */
776
926
  clientConnectionConfig?: Schema$ClientConnectionConfig;
927
+ /**
928
+ * Optional. The configuration for Managed Connection Pool (MCP).
929
+ */
930
+ connectionPoolConfig?: Schema$ConnectionPoolConfig;
777
931
  /**
778
932
  * Output only. Create time stamp
779
933
  */
@@ -794,12 +948,16 @@ export namespace alloydb_v1beta {
794
948
  * For Resource freshness validation (https://google.aip.dev/154)
795
949
  */
796
950
  etag?: string | null;
951
+ /**
952
+ * Output only. Configuration parameters related to Gemini Cloud Assist.
953
+ */
954
+ gcaConfig?: Schema$GCAInstanceConfig;
797
955
  /**
798
956
  * The Compute Engine zone that the instance should serve from, per https://cloud.google.com/compute/docs/regions-zones This can ONLY be specified for ZONAL instances. If present for a REGIONAL instance, an error will be thrown. If this is absent for a ZONAL instance, instance is created in a random zone with available capacity.
799
957
  */
800
958
  gceZone?: string | null;
801
959
  /**
802
- * Optional. Configuration parameters related to the Gemini in Databases add-on.
960
+ * Optional. Deprecated and unused. This field will be removed in the near future.
803
961
  */
804
962
  geminiConfig?: Schema$GeminiInstanceConfig;
805
963
  /**
@@ -899,6 +1057,10 @@ export namespace alloydb_v1beta {
899
1057
  * Optional. Enabling public ip for the instance.
900
1058
  */
901
1059
  enablePublicIp?: boolean | null;
1060
+ /**
1061
+ * Output only. The resource link for the VPC network in which instance resources are created and from which they are accessible via Private IP. This will be the same value as the parent cluster's network. It is specified in the form: // `projects/{project_number\}/global/networks/{network_id\}`.
1062
+ */
1063
+ network?: string | null;
902
1064
  }
903
1065
  /**
904
1066
  * Details regarding the upgrade of instaces associated with a cluster.
@@ -1032,6 +1194,10 @@ export namespace alloydb_v1beta {
1032
1194
  * The number of CPU's in the VM instance.
1033
1195
  */
1034
1196
  cpuCount?: number | null;
1197
+ /**
1198
+ * Machine type of the VM instance. E.g. "n2-highmem-4", "n2-highmem-8", "c4a-highmem-4-lssd". cpu_count must match the number of vCPUs in the machine type.
1199
+ */
1200
+ machineType?: string | null;
1035
1201
  }
1036
1202
  /**
1037
1203
  * MaintenanceSchedule stores the maintenance schedule generated from the MaintenanceUpdatePolicy, once a maintenance rollout is triggered, if MaintenanceWindow is set, and if there is no conflicting DenyPeriod. The schedule is cleared once the update takes place. This field cannot be manually changed; modify the MaintenanceUpdatePolicy instead.
@@ -1046,6 +1212,10 @@ export namespace alloydb_v1beta {
1046
1212
  * MaintenanceUpdatePolicy defines the policy for system updates.
1047
1213
  */
1048
1214
  export interface Schema$MaintenanceUpdatePolicy {
1215
+ /**
1216
+ * Periods to deny maintenance. Currently limited to 1.
1217
+ */
1218
+ denyMaintenancePeriods?: Schema$DenyMaintenancePeriod[];
1049
1219
  /**
1050
1220
  * Preferred windows to perform maintenance. Currently limited to 1.
1051
1221
  */
@@ -1095,7 +1265,7 @@ export namespace alloydb_v1beta {
1095
1265
  network?: string | null;
1096
1266
  }
1097
1267
  /**
1098
- * Details of a single node in the instance. Nodes in an AlloyDB instance are ephemereal, they can change during update, failover, autohealing and resize operations.
1268
+ * Details of a single node in the instance. Nodes in an AlloyDB instance are ephemeral, they can change during update, failover, autohealing and resize operations.
1099
1269
  */
1100
1270
  export interface Schema$Node {
1101
1271
  /**
@@ -1119,6 +1289,10 @@ export namespace alloydb_v1beta {
1119
1289
  * Observability Instance specific configuration.
1120
1290
  */
1121
1291
  export interface Schema$ObservabilityInstanceConfig {
1292
+ /**
1293
+ * Whether assistive experiences are enabled for this AlloyDB instance.
1294
+ */
1295
+ assistiveExperiencesEnabled?: boolean | null;
1122
1296
  /**
1123
1297
  * Observability feature status for an instance. This flag is turned "off" by default.
1124
1298
  */
@@ -1143,16 +1317,12 @@ export namespace alloydb_v1beta {
1143
1317
  * Track actively running queries on the instance. If not set, this flag is "off" by default.
1144
1318
  */
1145
1319
  trackActiveQueries?: boolean | null;
1146
- /**
1147
- * Track client address for an instance. If not set, default value is "off".
1148
- */
1149
- trackClientAddress?: boolean | null;
1150
1320
  /**
1151
1321
  * Track wait events during query execution for an instance. This flag is turned "on" by default but tracking is enabled only after observability enabled flag is also turned on.
1152
1322
  */
1153
1323
  trackWaitEvents?: boolean | null;
1154
1324
  /**
1155
- * Output only. Track wait event types during query execution for an instance. This flag is turned "on" by default but tracking is enabled only after observability enabled flag is also turned on. This is read-only flag and only modifiable by producer API.
1325
+ * Output only. Track wait event types during query execution for an instance. This flag is turned "on" by default but tracking is enabled only after observability enabled flag is also turned on. This is read-only flag and only modifiable by internal API.
1156
1326
  */
1157
1327
  trackWaitEventTypes?: boolean | null;
1158
1328
  }
@@ -1209,6 +1379,10 @@ export namespace alloydb_v1beta {
1209
1379
  * Output only. Server-defined resource path for the target of the operation.
1210
1380
  */
1211
1381
  target?: string | null;
1382
+ /**
1383
+ * Output only. UpgradeClusterStatus related metadata.
1384
+ */
1385
+ upgradeClusterStatus?: Schema$UpgradeClusterStatus;
1212
1386
  /**
1213
1387
  * Output only. Name of the verb executed by the operation.
1214
1388
  */
@@ -1240,6 +1414,31 @@ export namespace alloydb_v1beta {
1240
1414
  */
1241
1415
  validateOnly?: boolean | null;
1242
1416
  }
1417
+ /**
1418
+ * Configuration for setting up PSC service automation. Consumer projects in the configs will be allowlisted automatically for the instance.
1419
+ */
1420
+ export interface Schema$PscAutoConnectionConfig {
1421
+ /**
1422
+ * The consumer network for the PSC service automation, example: "projects/vpc-host-project/global/networks/default". The consumer network might be hosted a different project than the consumer project.
1423
+ */
1424
+ consumerNetwork?: string | null;
1425
+ /**
1426
+ * Output only. The status of the service connection policy. Possible values: "STATE_UNSPECIFIED" - Default state, when Connection Map is created initially. "VALID" - Set when policy and map configuration is valid, and their matching can lead to allowing creation of PSC Connections subject to other constraints like connections limit. "CONNECTION_POLICY_MISSING" - No Service Connection Policy found for this network and Service Class "POLICY_LIMIT_REACHED" - Service Connection Policy limit reached for this network and Service Class "CONSUMER_INSTANCE_PROJECT_NOT_ALLOWLISTED" - The consumer instance project is not in AllowedGoogleProducersResourceHierarchyLevels of the matching ServiceConnectionPolicy.
1427
+ */
1428
+ consumerNetworkStatus?: string | null;
1429
+ /**
1430
+ * The consumer project to which the PSC service automation endpoint will be created.
1431
+ */
1432
+ consumerProject?: string | null;
1433
+ /**
1434
+ * Output only. The IP address of the PSC service automation endpoint.
1435
+ */
1436
+ ipAddress?: string | null;
1437
+ /**
1438
+ * Output only. The status of the PSC service automation connection. Possible values: "STATE_UNSPECIFIED" - An invalid state as the default case. "ACTIVE" - The connection has been created successfully. "FAILED" - The connection is not functional since some resources on the connection fail to be created. "CREATING" - The connection is being created. "DELETING" - The connection is being deleted. "CREATE_REPAIRING" - The connection is being repaired to complete creation. "DELETE_REPAIRING" - The connection is being repaired to complete deletion.
1439
+ */
1440
+ status?: string | null;
1441
+ }
1243
1442
  /**
1244
1443
  * PscConfig contains PSC related configuration at a cluster level.
1245
1444
  */
@@ -1248,6 +1447,10 @@ export namespace alloydb_v1beta {
1248
1447
  * Optional. Create an instance that allows connections from Private Service Connect endpoints to the instance.
1249
1448
  */
1250
1449
  pscEnabled?: boolean | null;
1450
+ /**
1451
+ * Output only. The project number that needs to be allowlisted on the network attachment to enable outbound connectivity.
1452
+ */
1453
+ serviceOwnedProjectNumber?: string | null;
1251
1454
  }
1252
1455
  /**
1253
1456
  * PscInstanceConfig contains PSC related configuration at an instance level.
@@ -1257,15 +1460,32 @@ export namespace alloydb_v1beta {
1257
1460
  * Optional. List of consumer projects that are allowed to create PSC endpoints to service-attachments to this instance.
1258
1461
  */
1259
1462
  allowedConsumerProjects?: string[] | null;
1463
+ /**
1464
+ * Optional. Configurations for setting up PSC service automation.
1465
+ */
1466
+ pscAutoConnections?: Schema$PscAutoConnectionConfig[];
1260
1467
  /**
1261
1468
  * Output only. The DNS name of the instance for PSC connectivity. Name convention: ...alloydb-psc.goog
1262
1469
  */
1263
1470
  pscDnsName?: string | null;
1471
+ /**
1472
+ * 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.
1473
+ */
1474
+ pscInterfaceConfigs?: Schema$PscInterfaceConfig[];
1264
1475
  /**
1265
1476
  * 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/`
1266
1477
  */
1267
1478
  serviceAttachmentLink?: string | null;
1268
1479
  }
1480
+ /**
1481
+ * Configuration for setting up a PSC interface to enable outbound connectivity.
1482
+ */
1483
+ export interface Schema$PscInterfaceConfig {
1484
+ /**
1485
+ * 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.
1486
+ */
1487
+ networkAttachmentResource?: string | null;
1488
+ }
1269
1489
  /**
1270
1490
  * 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)
1271
1491
  */
@@ -1318,6 +1538,15 @@ export namespace alloydb_v1beta {
1318
1538
  */
1319
1539
  nodeCount?: number | null;
1320
1540
  }
1541
+ /**
1542
+ * Read pool instances upgrade specific status.
1543
+ */
1544
+ export interface Schema$ReadPoolInstancesUpgradeStageStatus {
1545
+ /**
1546
+ * Read pool instances upgrade statistics.
1547
+ */
1548
+ upgradeStats?: Schema$Stats;
1549
+ }
1321
1550
  export interface Schema$RestartInstanceRequest {
1322
1551
  /**
1323
1552
  * Optional. Full name of the nodes as obtained from INSTANCE_VIEW_FULL to restart upon. Applicable only to read instances.
@@ -1333,7 +1562,7 @@ export namespace alloydb_v1beta {
1333
1562
  validateOnly?: boolean | null;
1334
1563
  }
1335
1564
  /**
1336
- * Message for restoring a Cluster from a backup or another cluster at a given point in time.
1565
+ * Message for restoring a Cluster from a backup or another cluster at a given point in time. NEXT_ID: 11
1337
1566
  */
1338
1567
  export interface Schema$RestoreClusterRequest {
1339
1568
  /**
@@ -1408,6 +1637,10 @@ export namespace alloydb_v1beta {
1408
1637
  */
1409
1638
  tables?: string[] | null;
1410
1639
  }
1640
+ /**
1641
+ * Options for importing data in SQL format.
1642
+ */
1643
+ export interface Schema$SqlImportOptions {}
1411
1644
  /**
1412
1645
  * SSL configuration.
1413
1646
  */
@@ -1438,6 +1671,44 @@ export namespace alloydb_v1beta {
1438
1671
  */
1439
1672
  status?: string | null;
1440
1673
  }
1674
+ /**
1675
+ * Status of an upgrade stage.
1676
+ */
1677
+ export interface Schema$StageStatus {
1678
+ /**
1679
+ * Read pool instances upgrade metadata.
1680
+ */
1681
+ readPoolInstancesUpgrade?: Schema$ReadPoolInstancesUpgradeStageStatus;
1682
+ /**
1683
+ * Upgrade stage.
1684
+ */
1685
+ stage?: string | null;
1686
+ /**
1687
+ * State of this stage.
1688
+ */
1689
+ state?: string | null;
1690
+ }
1691
+ /**
1692
+ * Upgrade stats for read pool instances.
1693
+ */
1694
+ export interface Schema$Stats {
1695
+ /**
1696
+ * Number of read pool instances which failed to upgrade.
1697
+ */
1698
+ failed?: number | null;
1699
+ /**
1700
+ * Number of read pool instances for which upgrade has not started.
1701
+ */
1702
+ notStarted?: number | null;
1703
+ /**
1704
+ * Number of read pool instances undergoing upgrade.
1705
+ */
1706
+ ongoing?: number | null;
1707
+ /**
1708
+ * Number of read pool instances successfully upgraded.
1709
+ */
1710
+ success?: number | null;
1711
+ }
1441
1712
  /**
1442
1713
  * The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
1443
1714
  */
@@ -1635,7 +1906,7 @@ export namespace alloydb_v1beta {
1635
1906
  uniqueId?: string | null;
1636
1907
  }
1637
1908
  /**
1638
- * Common model for database resource instance metadata. Next ID: 23
1909
+ * Common model for database resource instance metadata. Next ID: 25
1639
1910
  */
1640
1911
  export interface Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata {
1641
1912
  /**
@@ -1674,6 +1945,10 @@ export namespace alloydb_v1beta {
1674
1945
  * The state that the instance is expected to be in. For example, an instance state can transition to UNHEALTHY due to wrong patch update, while the expected state will remain at the HEALTHY.
1675
1946
  */
1676
1947
  expectedState?: string | null;
1948
+ /**
1949
+ * GCBDR configuration for the resource.
1950
+ */
1951
+ gcbdrConfiguration?: Schema$StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration;
1677
1952
  /**
1678
1953
  * Required. Unique identifier for a Database resource
1679
1954
  */
@@ -1710,6 +1985,10 @@ export namespace alloydb_v1beta {
1710
1985
  * 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
1711
1986
  */
1712
1987
  resourceName?: string | null;
1988
+ /**
1989
+ * Optional. Suspension reason for the resource.
1990
+ */
1991
+ suspensionReason?: string | null;
1713
1992
  /**
1714
1993
  * Optional. Tags associated with this resources.
1715
1994
  */
@@ -1773,6 +2052,15 @@ export namespace alloydb_v1beta {
1773
2052
  */
1774
2053
  type?: string | null;
1775
2054
  }
2055
+ /**
2056
+ * GCBDR Configuration for the resource.
2057
+ */
2058
+ export interface Schema$StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration {
2059
+ /**
2060
+ * Whether the resource is managed by GCBDR.
2061
+ */
2062
+ gcbdrManaged?: boolean | null;
2063
+ }
1776
2064
  /**
1777
2065
  * Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration settings. Similarly bigtable can have multiple clusters within same bigtable instance.
1778
2066
  */
@@ -1785,6 +2073,10 @@ export namespace alloydb_v1beta {
1785
2073
  * Information about the last backup attempt for this database
1786
2074
  */
1787
2075
  backupRun?: Schema$StorageDatabasecenterPartnerapiV1mainBackupRun;
2076
+ /**
2077
+ * Whether deletion protection is enabled for this internal resource.
2078
+ */
2079
+ isDeletionProtectionEnabled?: boolean | null;
1788
2080
  product?: Schema$StorageDatabasecenterProtoCommonProduct;
1789
2081
  resourceId?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId;
1790
2082
  /**
@@ -1797,11 +2089,11 @@ export namespace alloydb_v1beta {
1797
2089
  */
1798
2090
  export interface Schema$StorageDatabasecenterPartnerapiV1mainMachineConfiguration {
1799
2091
  /**
1800
- * The number of CPUs. Deprecated. Use vcpu_count instead. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
2092
+ * The number of CPUs. Deprecated. Use vcpu_count instead. TODO(b/342344482) add proto validations again after bug fix.
1801
2093
  */
1802
2094
  cpuCount?: number | null;
1803
2095
  /**
1804
- * Memory size in bytes. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
2096
+ * Memory size in bytes. TODO(b/342344482) add proto validations again after bug fix.
1805
2097
  */
1806
2098
  memorySizeInBytes?: string | null;
1807
2099
  /**
@@ -1809,7 +2101,7 @@ export namespace alloydb_v1beta {
1809
2101
  */
1810
2102
  shardCount?: number | null;
1811
2103
  /**
1812
- * Optional. The number of vCPUs. TODO(b/342344482, b/342346271) add proto validations again after bug fix.
2104
+ * Optional. The number of vCPUs. TODO(b/342344482) add proto validations again after bug fix.
1813
2105
  */
1814
2106
  vcpuCount?: number | null;
1815
2107
  }
@@ -1947,10 +2239,22 @@ export namespace alloydb_v1beta {
1947
2239
  * The name of the flag resource, following Google Cloud conventions, e.g.: * projects/{project\}/locations/{location\}/flags/{flag\} This field currently has no semantic meaning.
1948
2240
  */
1949
2241
  name?: string | null;
2242
+ /**
2243
+ * The recommended value for an INTEGER flag.
2244
+ */
2245
+ recommendedIntegerValue?: string | null;
2246
+ /**
2247
+ * The recommended value for a STRING flag.
2248
+ */
2249
+ recommendedStringValue?: string | null;
1950
2250
  /**
1951
2251
  * Whether setting or updating this flag on an Instance requires a database restart. If a flag that requires database restart is set, the backend will automatically restart the database (making sure to satisfy any availability SLO's).
1952
2252
  */
1953
2253
  requiresDbRestart?: boolean | null;
2254
+ /**
2255
+ * The scope of the flag.
2256
+ */
2257
+ scope?: string | null;
1954
2258
  /**
1955
2259
  * Restriction on STRING type value.
1956
2260
  */
@@ -2051,6 +2355,31 @@ export namespace alloydb_v1beta {
2051
2355
  */
2052
2356
  status?: string | null;
2053
2357
  }
2358
+ /**
2359
+ * Message for current status of the Major Version Upgrade operation.
2360
+ */
2361
+ export interface Schema$UpgradeClusterStatus {
2362
+ /**
2363
+ * Whether the operation is cancellable.
2364
+ */
2365
+ cancellable?: boolean | null;
2366
+ /**
2367
+ * Source database major version.
2368
+ */
2369
+ sourceVersion?: string | null;
2370
+ /**
2371
+ * Status of all upgrade stages.
2372
+ */
2373
+ stages?: Schema$StageStatus[];
2374
+ /**
2375
+ * Cluster Major Version Upgrade state.
2376
+ */
2377
+ state?: string | null;
2378
+ /**
2379
+ * Target database major version.
2380
+ */
2381
+ targetVersion?: string | null;
2382
+ }
2054
2383
  /**
2055
2384
  * Message describing User object.
2056
2385
  */
@@ -2328,6 +2657,10 @@ export namespace alloydb_v1beta {
2328
2657
  }
2329
2658
  export interface Params$Resource$Projects$Locations$List
2330
2659
  extends StandardParameters {
2660
+ /**
2661
+ * Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.
2662
+ */
2663
+ extraLocationTypes?: string[];
2331
2664
  /**
2332
2665
  * A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
2333
2666
  */
@@ -3335,6 +3668,94 @@ export namespace alloydb_v1beta {
3335
3668
  }
3336
3669
  }
3337
3670
 
3671
+ /**
3672
+ * Imports data to the cluster. Imperative only.
3673
+ *
3674
+ * @param params - Parameters for request
3675
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
3676
+ * @param callback - Optional callback that handles the response.
3677
+ * @returns A promise if used with async/await, or void if used with a callback.
3678
+ */
3679
+ import(
3680
+ params: Params$Resource$Projects$Locations$Clusters$Import,
3681
+ options: StreamMethodOptions
3682
+ ): GaxiosPromise<Readable>;
3683
+ import(
3684
+ params?: Params$Resource$Projects$Locations$Clusters$Import,
3685
+ options?: MethodOptions
3686
+ ): GaxiosPromise<Schema$Operation>;
3687
+ import(
3688
+ params: Params$Resource$Projects$Locations$Clusters$Import,
3689
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
3690
+ callback: BodyResponseCallback<Readable>
3691
+ ): void;
3692
+ import(
3693
+ params: Params$Resource$Projects$Locations$Clusters$Import,
3694
+ options: MethodOptions | BodyResponseCallback<Schema$Operation>,
3695
+ callback: BodyResponseCallback<Schema$Operation>
3696
+ ): void;
3697
+ import(
3698
+ params: Params$Resource$Projects$Locations$Clusters$Import,
3699
+ callback: BodyResponseCallback<Schema$Operation>
3700
+ ): void;
3701
+ import(callback: BodyResponseCallback<Schema$Operation>): void;
3702
+ import(
3703
+ paramsOrCallback?:
3704
+ | Params$Resource$Projects$Locations$Clusters$Import
3705
+ | BodyResponseCallback<Schema$Operation>
3706
+ | BodyResponseCallback<Readable>,
3707
+ optionsOrCallback?:
3708
+ | MethodOptions
3709
+ | StreamMethodOptions
3710
+ | BodyResponseCallback<Schema$Operation>
3711
+ | BodyResponseCallback<Readable>,
3712
+ callback?:
3713
+ | BodyResponseCallback<Schema$Operation>
3714
+ | BodyResponseCallback<Readable>
3715
+ ): void | GaxiosPromise<Schema$Operation> | GaxiosPromise<Readable> {
3716
+ let params = (paramsOrCallback ||
3717
+ {}) as Params$Resource$Projects$Locations$Clusters$Import;
3718
+ let options = (optionsOrCallback || {}) as MethodOptions;
3719
+
3720
+ if (typeof paramsOrCallback === 'function') {
3721
+ callback = paramsOrCallback;
3722
+ params = {} as Params$Resource$Projects$Locations$Clusters$Import;
3723
+ options = {};
3724
+ }
3725
+
3726
+ if (typeof optionsOrCallback === 'function') {
3727
+ callback = optionsOrCallback;
3728
+ options = {};
3729
+ }
3730
+
3731
+ const rootUrl = options.rootUrl || 'https://alloydb.googleapis.com/';
3732
+ const parameters = {
3733
+ options: Object.assign(
3734
+ {
3735
+ url: (rootUrl + '/v1beta/{+name}:import').replace(
3736
+ /([^:]\/)\/+/g,
3737
+ '$1'
3738
+ ),
3739
+ method: 'POST',
3740
+ apiVersion: '',
3741
+ },
3742
+ options
3743
+ ),
3744
+ params,
3745
+ requiredParams: ['name'],
3746
+ pathParams: ['name'],
3747
+ context: this.context,
3748
+ };
3749
+ if (callback) {
3750
+ createAPIRequest<Schema$Operation>(
3751
+ parameters,
3752
+ callback as BodyResponseCallback<unknown>
3753
+ );
3754
+ } else {
3755
+ return createAPIRequest<Schema$Operation>(parameters);
3756
+ }
3757
+ }
3758
+
3338
3759
  /**
3339
3760
  * Lists Clusters in a given project and location.
3340
3761
  *
@@ -4048,6 +4469,18 @@ export namespace alloydb_v1beta {
4048
4469
  */
4049
4470
  view?: string;
4050
4471
  }
4472
+ export interface Params$Resource$Projects$Locations$Clusters$Import
4473
+ extends StandardParameters {
4474
+ /**
4475
+ * Required. The resource name of the cluster.
4476
+ */
4477
+ name?: string;
4478
+
4479
+ /**
4480
+ * Request body metadata
4481
+ */
4482
+ requestBody?: Schema$ImportClusterRequest;
4483
+ }
4051
4484
  export interface Params$Resource$Projects$Locations$Clusters$List
4052
4485
  extends StandardParameters {
4053
4486
  /**
@@ -6288,5 +6721,9 @@ export namespace alloydb_v1beta {
6288
6721
  * Required. The name of the parent resource. The required format is: * projects/{project\}/locations/{location\} Regardless of the parent specified here, as long it is contains a valid project and location, the service will return a static list of supported flags resources. Note that we do not yet support region-specific flags.
6289
6722
  */
6290
6723
  parent?: string;
6724
+ /**
6725
+ * Optional. The scope for which supported flags are requested. If not specified, default is DATABASE.
6726
+ */
6727
+ scope?: string;
6291
6728
  }
6292
6729
  }