google-cloud-alloy_db-v1 0.11.0 → 1.0.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d2aeb881d34ecd84e9d1410aa98ef60361c985e06cf67f6c065e2475adf7c1fe
4
- data.tar.gz: db7935df24ddf9638e22a22e38dbefead524be6089b55ffaeb2df34313be25c2
3
+ metadata.gz: ea31832b84b96ef1db566d9dc9a1a228d63a9d3f4773fa3f264e7d6032af4010
4
+ data.tar.gz: e13b9683631dd66771eb6b79b2d35ccac62738a0c931be08e98d490ef9b0d03a
5
5
  SHA512:
6
- metadata.gz: d01423be2f962f44022324f782f00e0fc553e460fd58407323bd63f5d712ac3bd2ad4d47e87a391b188119a6318c835675eee8b16cd55d3e33e9148de8819355
7
- data.tar.gz: 968908e3da5f467b66cd87a890cade7e2406634596d8ea00cfd3848ad232285d1f57e7e0c8a5f47faaa2677c55af8618a64fb49f007edddd593b646cd8e5c31d
6
+ metadata.gz: 2ffb9f65a536f106a87e860c380a2c4b39040bdcff56a169244211b699f6a8b89fe5056f240a24bff122bb2afa9d82c0208f6ff5ee5ee1a645e8020a071f498d
7
+ data.tar.gz: 6a9b5d120d989d5492de928f3b0e057c14578bd33195b3d9cd2143e33b6cfbed48fa9d87915f541691d60c83161881aa5c6346d172f8b4fb933e81b52165046c
data/README.md CHANGED
@@ -86,7 +86,7 @@ To browse ready to use code samples check [Google Cloud Samples](https://cloud.g
86
86
 
87
87
  ## Supported Ruby Versions
88
88
 
89
- This library is supported on Ruby 2.7+.
89
+ This library is supported on Ruby 3.0+.
90
90
 
91
91
  Google provides official support for Ruby versions that are actively supported
92
92
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
@@ -1082,9 +1082,13 @@ module Google
1082
1082
  #
1083
1083
  # @param backup_source [::Google::Cloud::AlloyDB::V1::BackupSource, ::Hash]
1084
1084
  # Backup source.
1085
+ #
1086
+ # Note: The following fields are mutually exclusive: `backup_source`, `continuous_backup_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1085
1087
  # @param continuous_backup_source [::Google::Cloud::AlloyDB::V1::ContinuousBackupSource, ::Hash]
1086
1088
  # ContinuousBackup source. Continuous backup needs to be enabled in the
1087
1089
  # source cluster for this operation to succeed.
1090
+ #
1091
+ # Note: The following fields are mutually exclusive: `continuous_backup_source`, `backup_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1088
1092
  # @param parent [::String]
1089
1093
  # Required. The name of the parent resource. For the required format, see the
1090
1094
  # comment on the Cluster.name field.
@@ -4039,6 +4043,13 @@ module Google
4039
4043
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
4040
4044
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
4041
4045
  # * (`nil`) indicating no credentials
4046
+ #
4047
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
4048
+ # external source for authentication to Google Cloud, you must validate it before
4049
+ # providing it to a Google API client library. Providing an unvalidated credential
4050
+ # configuration to Google APIs can compromise the security of your systems and data.
4051
+ # For more information, refer to [Validate credential configurations from external
4052
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
4042
4053
  # @return [::Object]
4043
4054
  # @!attribute [rw] scope
4044
4055
  # The OAuth scopes
@@ -640,6 +640,13 @@ module Google
640
640
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
641
641
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
642
642
  # * (`nil`) indicating no credentials
643
+ #
644
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
645
+ # external source for authentication to Google Cloud, you must validate it before
646
+ # providing it to a Google API client library. Providing an unvalidated credential
647
+ # configuration to Google APIs can compromise the security of your systems and data.
648
+ # For more information, refer to [Validate credential configurations from external
649
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
643
650
  # @return [::Object]
644
651
  # @!attribute [rw] scope
645
652
  # The OAuth scopes
@@ -303,10 +303,10 @@ module Google
303
303
  # @param order_by [::String]
304
304
  # Optional. Hint for how to order the results
305
305
  # @yield [result, operation] Access the result along with the TransportOperation object
306
- # @yieldparam result [::Google::Cloud::AlloyDB::V1::ListClustersResponse]
306
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::AlloyDB::V1::Cluster>]
307
307
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
308
308
  #
309
- # @return [::Google::Cloud::AlloyDB::V1::ListClustersResponse]
309
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::AlloyDB::V1::Cluster>]
310
310
  #
311
311
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
312
312
  #
@@ -358,7 +358,9 @@ module Google
358
358
  retry_policy: @config.retry_policy
359
359
 
360
360
  @alloy_db_admin_stub.list_clusters request, options do |result, operation|
361
+ result = ::Gapic::Rest::PagedEnumerable.new @alloy_db_admin_stub, :list_clusters, "clusters", request, result, options
361
362
  yield result, operation if block_given?
363
+ throw :response, result
362
364
  end
363
365
  rescue ::Gapic::Rest::Error => e
364
366
  raise ::Google::Cloud::Error.from_error(e)
@@ -1025,9 +1027,13 @@ module Google
1025
1027
  #
1026
1028
  # @param backup_source [::Google::Cloud::AlloyDB::V1::BackupSource, ::Hash]
1027
1029
  # Backup source.
1030
+ #
1031
+ # Note: The following fields are mutually exclusive: `backup_source`, `continuous_backup_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1028
1032
  # @param continuous_backup_source [::Google::Cloud::AlloyDB::V1::ContinuousBackupSource, ::Hash]
1029
1033
  # ContinuousBackup source. Continuous backup needs to be enabled in the
1030
1034
  # source cluster for this operation to succeed.
1035
+ #
1036
+ # Note: The following fields are mutually exclusive: `continuous_backup_source`, `backup_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1031
1037
  # @param parent [::String]
1032
1038
  # Required. The name of the parent resource. For the required format, see the
1033
1039
  # comment on the Cluster.name field.
@@ -1266,10 +1272,10 @@ module Google
1266
1272
  # @param order_by [::String]
1267
1273
  # Optional. Hint for how to order the results
1268
1274
  # @yield [result, operation] Access the result along with the TransportOperation object
1269
- # @yieldparam result [::Google::Cloud::AlloyDB::V1::ListInstancesResponse]
1275
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::AlloyDB::V1::Instance>]
1270
1276
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
1271
1277
  #
1272
- # @return [::Google::Cloud::AlloyDB::V1::ListInstancesResponse]
1278
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::AlloyDB::V1::Instance>]
1273
1279
  #
1274
1280
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1275
1281
  #
@@ -1321,7 +1327,9 @@ module Google
1321
1327
  retry_policy: @config.retry_policy
1322
1328
 
1323
1329
  @alloy_db_admin_stub.list_instances request, options do |result, operation|
1330
+ result = ::Gapic::Rest::PagedEnumerable.new @alloy_db_admin_stub, :list_instances, "instances", request, result, options
1324
1331
  yield result, operation if block_given?
1332
+ throw :response, result
1325
1333
  end
1326
1334
  rescue ::Gapic::Rest::Error => e
1327
1335
  raise ::Google::Cloud::Error.from_error(e)
@@ -2413,10 +2421,10 @@ module Google
2413
2421
  # @param order_by [::String]
2414
2422
  # Hint for how to order the results
2415
2423
  # @yield [result, operation] Access the result along with the TransportOperation object
2416
- # @yieldparam result [::Google::Cloud::AlloyDB::V1::ListBackupsResponse]
2424
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::AlloyDB::V1::Backup>]
2417
2425
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
2418
2426
  #
2419
- # @return [::Google::Cloud::AlloyDB::V1::ListBackupsResponse]
2427
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::AlloyDB::V1::Backup>]
2420
2428
  #
2421
2429
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
2422
2430
  #
@@ -2468,7 +2476,9 @@ module Google
2468
2476
  retry_policy: @config.retry_policy
2469
2477
 
2470
2478
  @alloy_db_admin_stub.list_backups request, options do |result, operation|
2479
+ result = ::Gapic::Rest::PagedEnumerable.new @alloy_db_admin_stub, :list_backups, "backups", request, result, options
2471
2480
  yield result, operation if block_given?
2481
+ throw :response, result
2472
2482
  end
2473
2483
  rescue ::Gapic::Rest::Error => e
2474
2484
  raise ::Google::Cloud::Error.from_error(e)
@@ -3209,10 +3219,10 @@ module Google
3209
3219
  # @param order_by [::String]
3210
3220
  # Optional. Hint for how to order the results
3211
3221
  # @yield [result, operation] Access the result along with the TransportOperation object
3212
- # @yieldparam result [::Google::Cloud::AlloyDB::V1::ListUsersResponse]
3222
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::AlloyDB::V1::User>]
3213
3223
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
3214
3224
  #
3215
- # @return [::Google::Cloud::AlloyDB::V1::ListUsersResponse]
3225
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::AlloyDB::V1::User>]
3216
3226
  #
3217
3227
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
3218
3228
  #
@@ -3264,7 +3274,9 @@ module Google
3264
3274
  retry_policy: @config.retry_policy
3265
3275
 
3266
3276
  @alloy_db_admin_stub.list_users request, options do |result, operation|
3277
+ result = ::Gapic::Rest::PagedEnumerable.new @alloy_db_admin_stub, :list_users, "users", request, result, options
3267
3278
  yield result, operation if block_given?
3279
+ throw :response, result
3268
3280
  end
3269
3281
  rescue ::Gapic::Rest::Error => e
3270
3282
  raise ::Google::Cloud::Error.from_error(e)
@@ -3785,6 +3797,13 @@ module Google
3785
3797
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
3786
3798
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
3787
3799
  # * (`nil`) indicating no credentials
3800
+ #
3801
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
3802
+ # external source for authentication to Google Cloud, you must validate it before
3803
+ # providing it to a Google API client library. Providing an unvalidated credential
3804
+ # configuration to Google APIs can compromise the security of your systems and data.
3805
+ # For more information, refer to [Validate credential configurations from external
3806
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
3788
3807
  # @return [::Object]
3789
3808
  # @!attribute [rw] scope
3790
3809
  # The OAuth scopes
@@ -502,6 +502,13 @@ module Google
502
502
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
503
503
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
504
504
  # * (`nil`) indicating no credentials
505
+ #
506
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
507
+ # external source for authentication to Google Cloud, you must validate it before
508
+ # providing it to a Google API client library. Providing an unvalidated credential
509
+ # configuration to Google APIs can compromise the security of your systems and data.
510
+ # For more information, refer to [Validate credential configurations from external
511
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
505
512
  # @return [::Object]
506
513
  # @!attribute [rw] scope
507
514
  # The OAuth scopes
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module AlloyDB
23
23
  module V1
24
- VERSION = "0.11.0"
24
+ VERSION = "1.0.0"
25
25
  end
26
26
  end
27
27
  end
@@ -409,6 +409,14 @@ module Google
409
409
  # @return [::Array<::String>]
410
410
  # An allowlist of the fully qualified names of RPCs that should be included
411
411
  # on public client surfaces.
412
+ # @!attribute [rw] generate_omitted_as_internal
413
+ # @return [::Boolean]
414
+ # Setting this to true indicates to the client generators that methods
415
+ # that would be excluded from the generation should instead be generated
416
+ # in a way that indicates these methods should not be consumed by
417
+ # end users. How this is expressed is up to individual language
418
+ # implementations to decide. Some examples may be: added annotations,
419
+ # obfuscated identifiers, or other language idiomatic patterns.
412
420
  class SelectiveGapicGeneration
413
421
  include ::Google::Protobuf::MessageExts
414
422
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -158,9 +158,13 @@ module Google
158
158
  # @!attribute [rw] time_based_retention
159
159
  # @return [::Google::Cloud::AlloyDB::V1::AutomatedBackupPolicy::TimeBasedRetention]
160
160
  # Time-based Backup retention policy.
161
+ #
162
+ # Note: The following fields are mutually exclusive: `time_based_retention`, `quantity_based_retention`. If a field in that set is populated, all other fields in the set will automatically be cleared.
161
163
  # @!attribute [rw] quantity_based_retention
162
164
  # @return [::Google::Cloud::AlloyDB::V1::AutomatedBackupPolicy::QuantityBasedRetention]
163
165
  # Quantity-based Backup retention policy to retain recent backups.
166
+ #
167
+ # Note: The following fields are mutually exclusive: `quantity_based_retention`, `time_based_retention`. If a field in that set is populated, all other fields in the set will automatically be cleared.
164
168
  # @!attribute [rw] enabled
165
169
  # @return [::Boolean]
166
170
  # Whether automated automated backups are enabled. If not set, defaults to
@@ -361,9 +365,13 @@ module Google
361
365
  # @!attribute [r] backup_source
362
366
  # @return [::Google::Cloud::AlloyDB::V1::BackupSource]
363
367
  # Output only. Cluster created from backup.
368
+ #
369
+ # Note: The following fields are mutually exclusive: `backup_source`, `migration_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
364
370
  # @!attribute [r] migration_source
365
371
  # @return [::Google::Cloud::AlloyDB::V1::MigrationSource]
366
372
  # Output only. Cluster created via DMS migration.
373
+ #
374
+ # Note: The following fields are mutually exclusive: `migration_source`, `backup_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
367
375
  # @!attribute [r] name
368
376
  # @return [::String]
369
377
  # Output only. The name of the cluster resource with the format:
@@ -1243,9 +1251,13 @@ module Google
1243
1251
  # @!attribute [rw] string_restrictions
1244
1252
  # @return [::Google::Cloud::AlloyDB::V1::SupportedDatabaseFlag::StringRestrictions]
1245
1253
  # Restriction on STRING type value.
1254
+ #
1255
+ # Note: The following fields are mutually exclusive: `string_restrictions`, `integer_restrictions`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1246
1256
  # @!attribute [rw] integer_restrictions
1247
1257
  # @return [::Google::Cloud::AlloyDB::V1::SupportedDatabaseFlag::IntegerRestrictions]
1248
1258
  # Restriction on INTEGER type value.
1259
+ #
1260
+ # 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.
1249
1261
  # @!attribute [rw] name
1250
1262
  # @return [::String]
1251
1263
  # The name of the flag resource, following Google Cloud conventions, e.g.:
@@ -294,10 +294,14 @@ module Google
294
294
  # @!attribute [rw] backup_source
295
295
  # @return [::Google::Cloud::AlloyDB::V1::BackupSource]
296
296
  # Backup source.
297
+ #
298
+ # Note: The following fields are mutually exclusive: `backup_source`, `continuous_backup_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
297
299
  # @!attribute [rw] continuous_backup_source
298
300
  # @return [::Google::Cloud::AlloyDB::V1::ContinuousBackupSource]
299
301
  # ContinuousBackup source. Continuous backup needs to be enabled in the
300
302
  # source cluster for this operation to succeed.
303
+ #
304
+ # Note: The following fields are mutually exclusive: `continuous_backup_source`, `backup_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
301
305
  # @!attribute [rw] parent
302
306
  # @return [::String]
303
307
  # Required. The name of the parent resource. For the required format, see the
@@ -40,6 +40,8 @@ module Google
40
40
  # @!attribute [rw] error
41
41
  # @return [::Google::Rpc::Status]
42
42
  # The error result of the operation in case of failure or cancellation.
43
+ #
44
+ # Note: The following fields are mutually exclusive: `error`, `response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
43
45
  # @!attribute [rw] response
44
46
  # @return [::Google::Protobuf::Any]
45
47
  # The normal, successful response of the operation. If the original
@@ -50,6 +52,8 @@ module Google
50
52
  # is the original method name. For example, if the original method name
51
53
  # is `TakeSnapshot()`, the inferred response type is
52
54
  # `TakeSnapshotResponse`.
55
+ #
56
+ # Note: The following fields are mutually exclusive: `response`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
53
57
  class Operation
54
58
  include ::Google::Protobuf::MessageExts
55
59
  extend ::Google::Protobuf::MessageExts::ClassMethods
metadata CHANGED
@@ -1,14 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-alloy_db-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.11.0
4
+ version: 1.0.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
- autorequire:
9
8
  bindir: bin
10
9
  cert_chain: []
11
- date: 2024-12-10 00:00:00.000000000 Z
10
+ date: 2025-02-07 00:00:00.000000000 Z
12
11
  dependencies:
13
12
  - !ruby/object:Gem::Dependency
14
13
  name: gapic-common
@@ -16,7 +15,7 @@ dependencies:
16
15
  requirements:
17
16
  - - ">="
18
17
  - !ruby/object:Gem::Version
19
- version: 0.24.0
18
+ version: 0.25.0
20
19
  - - "<"
21
20
  - !ruby/object:Gem::Version
22
21
  version: 2.a
@@ -26,7 +25,7 @@ dependencies:
26
25
  requirements:
27
26
  - - ">="
28
27
  - !ruby/object:Gem::Version
29
- version: 0.24.0
28
+ version: 0.25.0
30
29
  - - "<"
31
30
  - !ruby/object:Gem::Version
32
31
  version: 2.a
@@ -147,7 +146,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby
147
146
  licenses:
148
147
  - Apache-2.0
149
148
  metadata: {}
150
- post_install_message:
151
149
  rdoc_options: []
152
150
  require_paths:
153
151
  - lib
@@ -155,15 +153,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
155
153
  requirements:
156
154
  - - ">="
157
155
  - !ruby/object:Gem::Version
158
- version: '2.7'
156
+ version: '3.0'
159
157
  required_rubygems_version: !ruby/object:Gem::Requirement
160
158
  requirements:
161
159
  - - ">="
162
160
  - !ruby/object:Gem::Version
163
161
  version: '0'
164
162
  requirements: []
165
- rubygems_version: 3.5.23
166
- signing_key:
163
+ rubygems_version: 3.6.3
167
164
  specification_version: 4
168
165
  summary: AlloyDB for PostgreSQL is an open source-compatible database service that
169
166
  provides a powerful option for migrating, modernizing, or building commercial-grade