google-cloud-alloy_db-v1beta 0.15.0 → 0.17.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.
Files changed (29) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/alloy_db/v1beta/alloy_db_admin/client.rb +131 -4
  3. data/lib/google/cloud/alloy_db/v1beta/alloy_db_admin/rest/client.rb +124 -4
  4. data/lib/google/cloud/alloy_db/v1beta/alloy_db_admin/rest/service_stub.rb +62 -0
  5. data/lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/client.rb +519 -0
  6. data/lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/credentials.rb +47 -0
  7. data/lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/operations.rb +813 -0
  8. data/lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/paths.rb +128 -0
  9. data/lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/rest/client.rb +494 -0
  10. data/lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/rest/operations.rb +913 -0
  11. data/lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/rest/service_stub.rb +143 -0
  12. data/lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/rest.rb +54 -0
  13. data/lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin.rb +56 -0
  14. data/lib/google/cloud/alloy_db/v1beta/rest.rb +1 -0
  15. data/lib/google/cloud/alloy_db/v1beta/version.rb +1 -1
  16. data/lib/google/cloud/alloy_db/v1beta.rb +1 -0
  17. data/lib/google/cloud/alloydb/v1beta/csql_service_pb.rb +53 -0
  18. data/lib/google/cloud/alloydb/v1beta/csql_service_services_pb.rb +45 -0
  19. data/lib/google/cloud/alloydb/v1beta/gemini_pb.rb +3 -1
  20. data/lib/google/cloud/alloydb/v1beta/resources_pb.rb +10 -1
  21. data/lib/google/cloud/alloydb/v1beta/service_pb.rb +5 -1
  22. data/lib/google/cloud/alloydb/v1beta/service_services_pb.rb +3 -0
  23. data/proto_docs/google/cloud/alloydb/v1beta/csql_service.rb +45 -0
  24. data/proto_docs/google/cloud/alloydb/v1beta/gemini.rb +27 -12
  25. data/proto_docs/google/cloud/alloydb/v1beta/resources.rb +247 -14
  26. data/proto_docs/google/cloud/alloydb/v1beta/service.rb +89 -4
  27. data/proto_docs/google/type/date.rb +53 -0
  28. data/proto_docs/google/type/timeofday.rb +1 -1
  29. metadata +15 -2
@@ -181,8 +181,7 @@ module Google
181
181
  # @return [::Google::Cloud::AlloyDB::V1beta::EncryptionConfig]
182
182
  # Optional. The encryption config can be specified to encrypt the
183
183
  # backups with a customer-managed encryption key (CMEK). When this field is
184
- # not specified, the backup will then use default encryption scheme to
185
- # protect the user data.
184
+ # not specified, the backup will use the cluster's encryption config.
186
185
  # @!attribute [rw] location
187
186
  # @return [::String]
188
187
  # The location where the backup will be stored. Currently, the only supported
@@ -265,8 +264,7 @@ module Google
265
264
  # @return [::Google::Cloud::AlloyDB::V1beta::EncryptionConfig]
266
265
  # The encryption config can be specified to encrypt the
267
266
  # backups with a customer-managed encryption key (CMEK). When this field is
268
- # not specified, the backup will then use default encryption scheme to
269
- # protect the user data.
267
+ # not specified, the backup will use the cluster's encryption config.
270
268
  class ContinuousBackupConfig
271
269
  include ::Google::Protobuf::MessageExts
272
270
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -284,12 +282,19 @@ module Google
284
282
  # if ContinuousBackup is not enabled.
285
283
  # @!attribute [r] schedule
286
284
  # @return [::Array<::Google::Type::DayOfWeek>]
287
- # Output only. Days of the week on which a continuous backup is taken. Output
288
- # only field. Ignored if passed into the request.
285
+ # Output only. Days of the week on which a continuous backup is taken.
289
286
  # @!attribute [r] earliest_restorable_time
290
287
  # @return [::Google::Protobuf::Timestamp]
291
- # Output only. The earliest restorable time that can be restored to. Output
292
- # only field.
288
+ # Output only. The earliest restorable time that can be restored to. If
289
+ # continuous backups and recovery was recently enabled, the earliest
290
+ # restorable time is the creation time of the earliest eligible backup within
291
+ # this cluster's continuous backup recovery window. After a cluster has had
292
+ # continuous backups enabled for the duration of its recovery window, the
293
+ # earliest restorable time becomes "now minus the recovery window". For
294
+ # example, assuming a point in time recovery is attempted at 04/16/2025
295
+ # 3:23:00PM with a 14d recovery window, the earliest restorable time would be
296
+ # 04/02/2025 3:23:00PM. This field is only visible if the
297
+ # CLUSTER_VIEW_CONTINUOUS_BACKUP cluster view is provided.
293
298
  class ContinuousBackupInfo
294
299
  include ::Google::Protobuf::MessageExts
295
300
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -328,6 +333,9 @@ module Google
328
333
  # @!attribute [rw] maintenance_windows
329
334
  # @return [::Array<::Google::Cloud::AlloyDB::V1beta::MaintenanceUpdatePolicy::MaintenanceWindow>]
330
335
  # Preferred windows to perform maintenance. Currently limited to 1.
336
+ # @!attribute [rw] deny_maintenance_periods
337
+ # @return [::Array<::Google::Cloud::AlloyDB::V1beta::MaintenanceUpdatePolicy::DenyMaintenancePeriod>]
338
+ # Periods to deny maintenance. Currently limited to 1.
331
339
  class MaintenanceUpdatePolicy
332
340
  include ::Google::Protobuf::MessageExts
333
341
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -344,6 +352,32 @@ module Google
344
352
  include ::Google::Protobuf::MessageExts
345
353
  extend ::Google::Protobuf::MessageExts::ClassMethods
346
354
  end
355
+
356
+ # DenyMaintenancePeriod definition. Excepting emergencies, maintenance
357
+ # will not be scheduled to start within this deny period. The start_date must
358
+ # be less than the end_date.
359
+ # @!attribute [rw] start_date
360
+ # @return [::Google::Type::Date]
361
+ # Deny period start date.
362
+ # This can be:
363
+ # * A full date, with non-zero year, month and day values OR
364
+ # * A month and day value, with a zero year for recurring
365
+ # @!attribute [rw] end_date
366
+ # @return [::Google::Type::Date]
367
+ # Deny period end date.
368
+ # This can be:
369
+ # * A full date, with non-zero year, month and day values OR
370
+ # * A month and day value, with a zero year for recurring
371
+ # @!attribute [rw] time
372
+ # @return [::Google::Type::TimeOfDay]
373
+ # Time in UTC when the deny period starts on start_date and ends on
374
+ # end_date. This can be:
375
+ # * Full time OR
376
+ # * All zeros for 00:00:00 UTC
377
+ class DenyMaintenancePeriod
378
+ include ::Google::Protobuf::MessageExts
379
+ extend ::Google::Protobuf::MessageExts::ClassMethods
380
+ end
347
381
  end
348
382
 
349
383
  # MaintenanceSchedule stores the maintenance schedule generated from
@@ -499,9 +533,10 @@ module Google
499
533
  # Output only. The maintenance schedule for the cluster, generated for a
500
534
  # specific rollout if a maintenance window is set.
501
535
  # @!attribute [rw] gemini_config
536
+ # @deprecated This field is deprecated and may be removed in the next major version update.
502
537
  # @return [::Google::Cloud::AlloyDB::V1beta::GeminiClusterConfig]
503
- # Optional. Configuration parameters related to the Gemini in Databases
504
- # add-on.
538
+ # Optional. Deprecated and unused. This field will be removed in the near
539
+ # future.
505
540
  # @!attribute [rw] subscription_type
506
541
  # @return [::Google::Cloud::AlloyDB::V1beta::SubscriptionType]
507
542
  # Optional. Subscription type of the cluster.
@@ -516,6 +551,12 @@ module Google
516
551
  # "123/environment": "production",
517
552
  # "123/costCenter": "marketing"
518
553
  # ```
554
+ # @!attribute [r] service_account_email
555
+ # @return [::String]
556
+ # Output only. AlloyDB per-cluster service agent email. This service account
557
+ # is created per-cluster per-project, and is different from that of the
558
+ # primary service agent which is created per-project. The service account
559
+ # naming format is subject to change.
519
560
  class Cluster
520
561
  include ::Google::Protobuf::MessageExts
521
562
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -571,6 +612,10 @@ module Google
571
612
  # @return [::Boolean]
572
613
  # Optional. Create an instance that allows connections from Private Service
573
614
  # Connect endpoints to the instance.
615
+ # @!attribute [r] service_owned_project_number
616
+ # @return [::Integer]
617
+ # Output only. The project number that needs to be allowlisted on the
618
+ # network attachment to enable outbound connectivity.
574
619
  class PscConfig
575
620
  include ::Google::Protobuf::MessageExts
576
621
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -814,12 +859,28 @@ module Google
814
859
  # @return [::Google::Cloud::AlloyDB::V1beta::Instance::InstanceNetworkConfig]
815
860
  # Optional. Instance-level network configuration.
816
861
  # @!attribute [rw] gemini_config
862
+ # @deprecated This field is deprecated and may be removed in the next major version update.
817
863
  # @return [::Google::Cloud::AlloyDB::V1beta::GeminiInstanceConfig]
818
- # Optional. Configuration parameters related to the Gemini in Databases
819
- # add-on.
864
+ # Optional. Deprecated and unused. This field will be removed in the near
865
+ # future.
820
866
  # @!attribute [r] outbound_public_ip_addresses
821
867
  # @return [::Array<::String>]
822
868
  # Output only. All outbound public IP addresses configured for the instance.
869
+ # @!attribute [rw] activation_policy
870
+ # @return [::Google::Cloud::AlloyDB::V1beta::Instance::ActivationPolicy]
871
+ # Optional. Specifies whether an instance needs to spin up. Once the instance
872
+ # is active, the activation policy can be updated to the `NEVER` to stop the
873
+ # instance. Likewise, the activation policy can be updated to `ALWAYS` to
874
+ # start the instance.
875
+ # There are restrictions around when an instance can/cannot be activated (for
876
+ # example, a read pool instance should be stopped before stopping primary
877
+ # etc.). Please refer to the API documentation for more details.
878
+ # @!attribute [rw] connection_pool_config
879
+ # @return [::Google::Cloud::AlloyDB::V1beta::Instance::ConnectionPoolConfig]
880
+ # Optional. The configuration for Managed Connection Pool (MCP).
881
+ # @!attribute [r] gca_config
882
+ # @return [::Google::Cloud::AlloyDB::V1beta::GCAInstanceConfig]
883
+ # Output only. Configuration parameters related to Gemini Cloud Assist.
823
884
  class Instance
824
885
  include ::Google::Protobuf::MessageExts
825
886
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -828,13 +889,18 @@ module Google
828
889
  # @!attribute [rw] cpu_count
829
890
  # @return [::Integer]
830
891
  # The number of CPU's in the VM instance.
892
+ # @!attribute [rw] machine_type
893
+ # @return [::String]
894
+ # Machine type of the VM instance. E.g. "n2-highmem-4",
895
+ # "n2-highmem-8", "c4a-highmem-4-lssd".
896
+ # cpu_count must match the number of vCPUs in the machine type.
831
897
  class MachineConfig
832
898
  include ::Google::Protobuf::MessageExts
833
899
  extend ::Google::Protobuf::MessageExts::ClassMethods
834
900
  end
835
901
 
836
902
  # Details of a single node in the instance.
837
- # Nodes in an AlloyDB instance are ephemereal, they can change during
903
+ # Nodes in an AlloyDB instance are ephemeral, they can change during
838
904
  # update, failover, autohealing and resize operations.
839
905
  # @!attribute [r] zone_id
840
906
  # @return [::String]
@@ -899,7 +965,7 @@ module Google
899
965
  # Output only. Track wait event types during query execution for an
900
966
  # instance. This flag is turned "on" by default but tracking is enabled
901
967
  # only after observability enabled flag is also turned on. This is
902
- # read-only flag and only modifiable by producer API.
968
+ # read-only flag and only modifiable by internal API.
903
969
  # @!attribute [rw] max_query_string_length
904
970
  # @return [::Integer]
905
971
  # Query string length. The default value is 10k.
@@ -920,6 +986,9 @@ module Google
920
986
  # @return [::Boolean]
921
987
  # Track client address for an instance.
922
988
  # If not set, default value is "off".
989
+ # @!attribute [rw] assistive_experiences_enabled
990
+ # @return [::Boolean]
991
+ # Whether assistive experiences are enabled for this AlloyDB instance.
923
992
  class ObservabilityInstanceConfig
924
993
  include ::Google::Protobuf::MessageExts
925
994
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -969,6 +1038,69 @@ module Google
969
1038
  extend ::Google::Protobuf::MessageExts::ClassMethods
970
1039
  end
971
1040
 
1041
+ # Configuration for setting up a PSC interface to enable outbound
1042
+ # connectivity.
1043
+ # @!attribute [rw] network_attachment_resource
1044
+ # @return [::String]
1045
+ # The network attachment resource created in the consumer network to which
1046
+ # the PSC interface will be linked. This is of the format:
1047
+ # "projects/$\\{CONSUMER_PROJECT}/regions/$\\{REGION}/networkAttachments/$\\{NETWORK_ATTACHMENT_NAME}".
1048
+ # The network attachment must be in the same region as the instance.
1049
+ class PscInterfaceConfig
1050
+ include ::Google::Protobuf::MessageExts
1051
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1052
+ end
1053
+
1054
+ # Configuration for setting up PSC service automation. Consumer projects in
1055
+ # the configs will be allowlisted automatically for the instance.
1056
+ # @!attribute [rw] consumer_project
1057
+ # @return [::String]
1058
+ # The consumer project to which the PSC service automation endpoint will
1059
+ # be created.
1060
+ # @!attribute [rw] consumer_network
1061
+ # @return [::String]
1062
+ # The consumer network for the PSC service automation, example:
1063
+ # "projects/vpc-host-project/global/networks/default".
1064
+ # The consumer network might be hosted a different project than the
1065
+ # consumer project.
1066
+ # @!attribute [r] ip_address
1067
+ # @return [::String]
1068
+ # Output only. The IP address of the PSC service automation endpoint.
1069
+ # @!attribute [r] status
1070
+ # @return [::String]
1071
+ # Output only. The status of the PSC service automation connection.
1072
+ # Possible values:
1073
+ # "STATE_UNSPECIFIED" - An invalid state as the default case.
1074
+ # "ACTIVE" - The connection has been created successfully.
1075
+ # "FAILED" - The connection is not functional since some resources on the
1076
+ # connection fail to be created.
1077
+ # "CREATING" - The connection is being created.
1078
+ # "DELETING" - The connection is being deleted.
1079
+ # "CREATE_REPAIRING" - The connection is being repaired to complete
1080
+ # creation.
1081
+ # "DELETE_REPAIRING" - The connection is being repaired to complete
1082
+ # deletion.
1083
+ # @!attribute [r] consumer_network_status
1084
+ # @return [::String]
1085
+ # Output only. The status of the service connection policy.
1086
+ # Possible values:
1087
+ # "STATE_UNSPECIFIED" - Default state, when Connection Map is created
1088
+ # initially.
1089
+ # "VALID" - Set when policy and map configuration is valid, and their
1090
+ # matching can lead to allowing creation of PSC Connections subject to
1091
+ # other constraints like connections limit.
1092
+ # "CONNECTION_POLICY_MISSING" - No Service Connection Policy found for
1093
+ # this network and Service Class
1094
+ # "POLICY_LIMIT_REACHED" - Service Connection Policy limit reached for
1095
+ # this network and Service Class
1096
+ # "CONSUMER_INSTANCE_PROJECT_NOT_ALLOWLISTED" - The consumer instance
1097
+ # project is not in AllowedGoogleProducersResourceHierarchyLevels of the
1098
+ # matching ServiceConnectionPolicy.
1099
+ class PscAutoConnectionConfig
1100
+ include ::Google::Protobuf::MessageExts
1101
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1102
+ end
1103
+
972
1104
  # PscInstanceConfig contains PSC related configuration at an
973
1105
  # instance level.
974
1106
  # @!attribute [r] service_attachment_link
@@ -985,6 +1117,15 @@ module Google
985
1117
  # @return [::String]
986
1118
  # Output only. The DNS name of the instance for PSC connectivity.
987
1119
  # Name convention: <uid>.<uid>.<region>.alloydb-psc.goog
1120
+ # @!attribute [rw] psc_interface_configs
1121
+ # @return [::Array<::Google::Cloud::AlloyDB::V1beta::Instance::PscInterfaceConfig>]
1122
+ # Optional. Configurations for setting up PSC interfaces attached to the
1123
+ # instance which are used for outbound connectivity. Only primary instances
1124
+ # can have PSC interface attached. Currently we only support 0 or 1 PSC
1125
+ # interface.
1126
+ # @!attribute [rw] psc_auto_connections
1127
+ # @return [::Array<::Google::Cloud::AlloyDB::V1beta::Instance::PscAutoConnectionConfig>]
1128
+ # Optional. Configurations for setting up PSC service automation.
988
1129
  class PscInstanceConfig
989
1130
  include ::Google::Protobuf::MessageExts
990
1131
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1001,6 +1142,22 @@ module Google
1001
1142
  # @return [::Boolean]
1002
1143
  # Optional. Enabling an outbound public IP address to support a database
1003
1144
  # server sending requests out into the internet.
1145
+ # @!attribute [r] network
1146
+ # @return [::String]
1147
+ # Output only. The resource link for the VPC network in which instance
1148
+ # resources are created and from which they are accessible via Private IP.
1149
+ # This will be the same value as the parent cluster's network. It is
1150
+ # specified in the form: //
1151
+ # `projects/{project_number}/global/networks/{network_id}`.
1152
+ # @!attribute [rw] allocated_ip_range_override
1153
+ # @return [::String]
1154
+ # Optional. Name of the allocated IP range for the private IP AlloyDB
1155
+ # instance, for example: "google-managed-services-default". If set, the
1156
+ # instance IPs will be created from this allocated range and will override
1157
+ # the IP range used by the parent cluster. The range name must comply with
1158
+ # [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically,
1159
+ # the name must be 1-63 characters long and match the regular expression
1160
+ # [a-z]([-a-z0-9]*[a-z0-9])?.
1004
1161
  class InstanceNetworkConfig
1005
1162
  include ::Google::Protobuf::MessageExts
1006
1163
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1015,6 +1172,39 @@ module Google
1015
1172
  end
1016
1173
  end
1017
1174
 
1175
+ # Configuration for Managed Connection Pool (MCP).
1176
+ # @!attribute [rw] enabled
1177
+ # @return [::Boolean]
1178
+ # Optional. Whether to enable Managed Connection Pool (MCP).
1179
+ # @!attribute [rw] flags
1180
+ # @return [::Google::Protobuf::Map{::String => ::String}]
1181
+ # Optional. Connection Pool flags, as a list of "key": "value" pairs.
1182
+ class ConnectionPoolConfig
1183
+ include ::Google::Protobuf::MessageExts
1184
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1185
+
1186
+ # @!attribute [rw] key
1187
+ # @return [::String]
1188
+ # @!attribute [rw] value
1189
+ # @return [::String]
1190
+ class FlagsEntry
1191
+ include ::Google::Protobuf::MessageExts
1192
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1193
+ end
1194
+
1195
+ # The pool mode. Defaults to `POOL_MODE_TRANSACTION`.
1196
+ module PoolMode
1197
+ # The pool mode is not specified. Defaults to `POOL_MODE_TRANSACTION`.
1198
+ POOL_MODE_UNSPECIFIED = 0
1199
+
1200
+ # Server is released back to pool after a client disconnects.
1201
+ POOL_MODE_SESSION = 1
1202
+
1203
+ # Server is released back to pool after a transaction finishes.
1204
+ POOL_MODE_TRANSACTION = 2
1205
+ end
1206
+ end
1207
+
1018
1208
  # @!attribute [rw] key
1019
1209
  # @return [::String]
1020
1210
  # @!attribute [rw] value
@@ -1114,6 +1304,18 @@ module Google
1114
1304
  # Regional (or Highly) available instance.
1115
1305
  REGIONAL = 2
1116
1306
  end
1307
+
1308
+ # Specifies whether an instance needs to spin up.
1309
+ module ActivationPolicy
1310
+ # The policy is not specified.
1311
+ ACTIVATION_POLICY_UNSPECIFIED = 0
1312
+
1313
+ # The instance is running.
1314
+ ALWAYS = 1
1315
+
1316
+ # The instance is not running.
1317
+ NEVER = 2
1318
+ end
1117
1319
  end
1118
1320
 
1119
1321
  # ConnectionInfo singleton resource.
@@ -1174,9 +1376,15 @@ module Google
1174
1376
  # @!attribute [r] update_time
1175
1377
  # @return [::Google::Protobuf::Timestamp]
1176
1378
  # Output only. Update time stamp
1379
+ #
1380
+ # Users should not infer any meaning from this field. Its value is generally
1381
+ # unrelated to the timing of the backup creation operation.
1177
1382
  # @!attribute [r] delete_time
1178
1383
  # @return [::Google::Protobuf::Timestamp]
1179
1384
  # Output only. Delete time stamp
1385
+ # @!attribute [r] create_completion_time
1386
+ # @return [::Google::Protobuf::Timestamp]
1387
+ # Output only. Timestamp when the resource finished being created.
1180
1388
  # @!attribute [rw] labels
1181
1389
  # @return [::Google::Protobuf::Map{::String => ::String}]
1182
1390
  # Labels as key value pairs
@@ -1358,6 +1566,16 @@ module Google
1358
1566
  # Restriction on INTEGER type value.
1359
1567
  #
1360
1568
  # Note: The following fields are mutually exclusive: `integer_restrictions`, `string_restrictions`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1569
+ # @!attribute [rw] recommended_string_value
1570
+ # @return [::String]
1571
+ # The recommended value for a STRING flag.
1572
+ #
1573
+ # Note: The following fields are mutually exclusive: `recommended_string_value`, `recommended_integer_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1574
+ # @!attribute [rw] recommended_integer_value
1575
+ # @return [::Google::Protobuf::Int64Value]
1576
+ # The recommended value for an INTEGER flag.
1577
+ #
1578
+ # Note: The following fields are mutually exclusive: `recommended_integer_value`, `recommended_string_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1361
1579
  # @!attribute [rw] name
1362
1580
  # @return [::String]
1363
1581
  # The name of the flag resource, following Google Cloud conventions, e.g.:
@@ -1382,6 +1600,9 @@ module Google
1382
1600
  # restart. If a flag that requires database restart is set, the backend
1383
1601
  # will automatically restart the database (making sure to satisfy any
1384
1602
  # availability SLO's).
1603
+ # @!attribute [rw] scope
1604
+ # @return [::Google::Cloud::AlloyDB::V1beta::SupportedDatabaseFlag::Scope]
1605
+ # The scope of the flag.
1385
1606
  class SupportedDatabaseFlag
1386
1607
  include ::Google::Protobuf::MessageExts
1387
1608
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1427,6 +1648,18 @@ module Google
1427
1648
  # Denotes that the flag does not accept any values.
1428
1649
  NONE = 4
1429
1650
  end
1651
+
1652
+ # The scope of the flag.
1653
+ module Scope
1654
+ # The scope of the flag is not specified. Default is DATABASE.
1655
+ SCOPE_UNSPECIFIED = 0
1656
+
1657
+ # The flag is a database flag.
1658
+ DATABASE = 1
1659
+
1660
+ # The flag is a connection pool flag.
1661
+ CONNECTION_POOL = 2
1662
+ end
1430
1663
  end
1431
1664
 
1432
1665
  # Message describing User object.
@@ -279,6 +279,86 @@ module Google
279
279
  extend ::Google::Protobuf::MessageExts::ClassMethods
280
280
  end
281
281
 
282
+ # Import cluster request.
283
+ # @!attribute [rw] sql_import_options
284
+ # @return [::Google::Cloud::AlloyDB::V1beta::ImportClusterRequest::SqlImportOptions]
285
+ # Options for importing data in SQL format.
286
+ #
287
+ # Note: The following fields are mutually exclusive: `sql_import_options`, `csv_import_options`. If a field in that set is populated, all other fields in the set will automatically be cleared.
288
+ # @!attribute [rw] csv_import_options
289
+ # @return [::Google::Cloud::AlloyDB::V1beta::ImportClusterRequest::CsvImportOptions]
290
+ # Options for importing data in CSV format.
291
+ #
292
+ # Note: The following fields are mutually exclusive: `csv_import_options`, `sql_import_options`. If a field in that set is populated, all other fields in the set will automatically be cleared.
293
+ # @!attribute [rw] name
294
+ # @return [::String]
295
+ # Required. The resource name of the cluster.
296
+ # @!attribute [rw] gcs_uri
297
+ # @return [::String]
298
+ # Required. The path to the file in Google Cloud Storage where the source
299
+ # file for import will be stored. The URI is in the form
300
+ # `gs://bucketName/fileName`.
301
+ # @!attribute [rw] database
302
+ # @return [::String]
303
+ # Optional. Name of the database to which the import will be done.
304
+ # For import from SQL file, this is required only if the file does not
305
+ # specify a database.
306
+ # Note - Value provided should be the same as expected from `SELECT
307
+ # current_database();` and NOT as a resource reference.
308
+ # @!attribute [rw] user
309
+ # @return [::String]
310
+ # Optional. Database user to be used for importing the data.
311
+ # Note - Value provided should be the same as expected from
312
+ # `SELECT current_user;` and NOT as a resource reference.
313
+ class ImportClusterRequest
314
+ include ::Google::Protobuf::MessageExts
315
+ extend ::Google::Protobuf::MessageExts::ClassMethods
316
+
317
+ # Options for importing data in SQL format.
318
+ class SqlImportOptions
319
+ include ::Google::Protobuf::MessageExts
320
+ extend ::Google::Protobuf::MessageExts::ClassMethods
321
+ end
322
+
323
+ # Options for importing data in CSV format.
324
+ # @!attribute [rw] table
325
+ # @return [::String]
326
+ # Required. The database table to import CSV file into.
327
+ # @!attribute [rw] columns
328
+ # @return [::Array<::String>]
329
+ # Optional. The columns to which CSV data is imported. If not specified,
330
+ # all columns of the database table are loaded with CSV data.
331
+ # @!attribute [rw] field_delimiter
332
+ # @return [::String]
333
+ # Optional. Specifies the character that separates columns within each row
334
+ # (line) of the file. The default is comma. The value of this argument has
335
+ # to be a character in Hex ASCII Code.
336
+ # @!attribute [rw] quote_character
337
+ # @return [::String]
338
+ # Optional. Specifies the quoting character to be used when a data value is
339
+ # quoted. The default is double-quote. The value of this argument has to be
340
+ # a character in Hex ASCII Code.
341
+ # @!attribute [rw] escape_character
342
+ # @return [::String]
343
+ # Optional. Specifies the character that should appear before a data
344
+ # character that needs to be escaped. The default is same as quote
345
+ # character. The value of this argument has to be a character in Hex ASCII
346
+ # Code.
347
+ class CsvImportOptions
348
+ include ::Google::Protobuf::MessageExts
349
+ extend ::Google::Protobuf::MessageExts::ClassMethods
350
+ end
351
+ end
352
+
353
+ # Response of import rpc.
354
+ # @!attribute [rw] bytes_downloaded
355
+ # @return [::Integer]
356
+ # Required. Size of the object downloaded from Google Cloud Storage in bytes.
357
+ class ImportClusterResponse
358
+ include ::Google::Protobuf::MessageExts
359
+ extend ::Google::Protobuf::MessageExts::ClassMethods
360
+ end
361
+
282
362
  # Upgrades a cluster.
283
363
  # @!attribute [rw] name
284
364
  # @return [::String]
@@ -349,7 +429,7 @@ module Google
349
429
  extend ::Google::Protobuf::MessageExts::ClassMethods
350
430
  end
351
431
 
352
- # Details regarding the upgrade of instaces associated with a cluster.
432
+ # Details regarding the upgrade of instances associated with a cluster.
353
433
  # @!attribute [rw] name
354
434
  # @return [::String]
355
435
  # Normalized name of the instance.
@@ -550,6 +630,7 @@ module Google
550
630
 
551
631
  # Message for restoring a Cluster from a backup or another cluster at a given
552
632
  # point in time.
633
+ # NEXT_ID: 11
553
634
  # @!attribute [rw] backup_source
554
635
  # @return [::Google::Cloud::AlloyDB::V1beta::BackupSource]
555
636
  # Backup source.
@@ -1304,6 +1385,10 @@ module Google
1304
1385
  # @!attribute [rw] page_token
1305
1386
  # @return [::String]
1306
1387
  # A token identifying a page of results the server should return.
1388
+ # @!attribute [rw] scope
1389
+ # @return [::Google::Cloud::AlloyDB::V1beta::SupportedDatabaseFlag::Scope]
1390
+ # Optional. The scope for which supported flags are requested. If not
1391
+ # specified, default is DATABASE.
1307
1392
  class ListSupportedDatabaseFlagsRequest
1308
1393
  include ::Google::Protobuf::MessageExts
1309
1394
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1359,9 +1444,9 @@ module Google
1359
1444
  # Optional. The public key from the client.
1360
1445
  # @!attribute [rw] use_metadata_exchange
1361
1446
  # @return [::Boolean]
1362
- # Optional. An optional hint to the endpoint to generate a client
1363
- # ceritificate that can be used by AlloyDB connectors to exchange additional
1364
- # metadata with the server after TLS handshake.
1447
+ # Optional. An optional hint to the endpoint to generate a client certificate
1448
+ # that can be used by AlloyDB connectors to exchange additional metadata with
1449
+ # the server after TLS handshake.
1365
1450
  class GenerateClientCertificateRequest
1366
1451
  include ::Google::Protobuf::MessageExts
1367
1452
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -0,0 +1,53 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2025 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Type
22
+ # Represents a whole or partial calendar date, such as a birthday. The time of
23
+ # day and time zone are either specified elsewhere or are insignificant. The
24
+ # date is relative to the Gregorian Calendar. This can represent one of the
25
+ # following:
26
+ #
27
+ # * A full date, with non-zero year, month, and day values
28
+ # * A month and day value, with a zero year, such as an anniversary
29
+ # * A year on its own, with zero month and day values
30
+ # * A year and month value, with a zero day, such as a credit card expiration
31
+ # date
32
+ #
33
+ # Related types are {::Google::Type::TimeOfDay google.type.TimeOfDay} and
34
+ # `google.protobuf.Timestamp`.
35
+ # @!attribute [rw] year
36
+ # @return [::Integer]
37
+ # Year of the date. Must be from 1 to 9999, or 0 to specify a date without
38
+ # a year.
39
+ # @!attribute [rw] month
40
+ # @return [::Integer]
41
+ # Month of a year. Must be from 1 to 12, or 0 to specify a year without a
42
+ # month and day.
43
+ # @!attribute [rw] day
44
+ # @return [::Integer]
45
+ # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0
46
+ # to specify a year by itself or a year and month where the day isn't
47
+ # significant.
48
+ class Date
49
+ include ::Google::Protobuf::MessageExts
50
+ extend ::Google::Protobuf::MessageExts::ClassMethods
51
+ end
52
+ end
53
+ end
@@ -21,7 +21,7 @@ module Google
21
21
  module Type
22
22
  # Represents a time of day. The date and time zone are either not significant
23
23
  # or are specified elsewhere. An API may choose to allow leap seconds. Related
24
- # types are [google.type.Date][google.type.Date] and
24
+ # types are {::Google::Type::Date google.type.Date} and
25
25
  # `google.protobuf.Timestamp`.
26
26
  # @!attribute [rw] hours
27
27
  # @return [::Integer]
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-alloy_db-v1beta
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.15.0
4
+ version: 0.17.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -97,10 +97,21 @@ files:
97
97
  - lib/google/cloud/alloy_db/v1beta/alloy_db_admin/rest/client.rb
98
98
  - lib/google/cloud/alloy_db/v1beta/alloy_db_admin/rest/operations.rb
99
99
  - lib/google/cloud/alloy_db/v1beta/alloy_db_admin/rest/service_stub.rb
100
+ - lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin.rb
101
+ - lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/client.rb
102
+ - lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/credentials.rb
103
+ - lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/operations.rb
104
+ - lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/paths.rb
105
+ - lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/rest.rb
106
+ - lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/rest/client.rb
107
+ - lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/rest/operations.rb
108
+ - lib/google/cloud/alloy_db/v1beta/alloy_db_cloud_sql_admin/rest/service_stub.rb
100
109
  - lib/google/cloud/alloy_db/v1beta/bindings_override.rb
101
110
  - lib/google/cloud/alloy_db/v1beta/rest.rb
102
111
  - lib/google/cloud/alloy_db/v1beta/version.rb
103
112
  - lib/google/cloud/alloydb/v1beta/csql_resources_pb.rb
113
+ - lib/google/cloud/alloydb/v1beta/csql_service_pb.rb
114
+ - lib/google/cloud/alloydb/v1beta/csql_service_services_pb.rb
104
115
  - lib/google/cloud/alloydb/v1beta/data_model_pb.rb
105
116
  - lib/google/cloud/alloydb/v1beta/gemini_pb.rb
106
117
  - lib/google/cloud/alloydb/v1beta/resources_pb.rb
@@ -113,6 +124,7 @@ files:
113
124
  - proto_docs/google/api/launch_stage.rb
114
125
  - proto_docs/google/api/resource.rb
115
126
  - proto_docs/google/cloud/alloydb/v1beta/csql_resources.rb
127
+ - proto_docs/google/cloud/alloydb/v1beta/csql_service.rb
116
128
  - proto_docs/google/cloud/alloydb/v1beta/data_model.rb
117
129
  - proto_docs/google/cloud/alloydb/v1beta/gemini.rb
118
130
  - proto_docs/google/cloud/alloydb/v1beta/resources.rb
@@ -125,6 +137,7 @@ files:
125
137
  - proto_docs/google/protobuf/timestamp.rb
126
138
  - proto_docs/google/protobuf/wrappers.rb
127
139
  - proto_docs/google/rpc/status.rb
140
+ - proto_docs/google/type/date.rb
128
141
  - proto_docs/google/type/dayofweek.rb
129
142
  - proto_docs/google/type/expr.rb
130
143
  - proto_docs/google/type/timeofday.rb
@@ -146,7 +159,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
146
159
  - !ruby/object:Gem::Version
147
160
  version: '0'
148
161
  requirements: []
149
- rubygems_version: 3.6.8
162
+ rubygems_version: 3.6.9
150
163
  specification_version: 4
151
164
  summary: AlloyDB for PostgreSQL is an open source-compatible database service that
152
165
  provides a powerful option for migrating, modernizing, or building commercial-grade