google-cloud-gke_backup-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: baa9b28d49e55fb3ab4bd4d5b6fbf0da67fc634baf8b11a72090c30c3426bcf6
4
- data.tar.gz: 370f26944669fee873e983d2156f17ba225ed1cb0c137bba767fea5faba1b623
3
+ metadata.gz: 5caa29fa90f4ccf6fc7d89a417448609ae03c7520b6eb266b8f71f0881428de4
4
+ data.tar.gz: 1574931d7f53752250b04f25df3532249b9933cadffd3c2df9a0b8378db11333
5
5
  SHA512:
6
- metadata.gz: 2e5f7b4a08f3222790c6587aa9bf74bb24b07933d7e35d6a2aed554a1b8795af9ff9ddf3d79e4c1240010d4a1547a1ce782f451908d454b0f4c3d2bac8ac1013
7
- data.tar.gz: f4c82e6c180c22b3e634116452c01d8e03ee6291ba1a577f9e638fb9c809ab274df754313a4745396ce5b42544f08452f7fb1e44022f6c095d28c41b47a2bf60
6
+ metadata.gz: 0ce4cfb0fb640386736d59dea09178d4d68c4d218cb22290f97f3bd7627bba26bf440f800fa93077adc2939fd93e453ebd4ae33f53c34a340786d0e9758d52de
7
+ data.tar.gz: 30aec83e915c998175097b088e3513d1788ee711f3cdbc6077e19920b70a68c5278da36649629785ca6956e996021583ec613afa7586ea8c4a4e99a995613b3b
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
@@ -2875,6 +2875,13 @@ module Google
2875
2875
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
2876
2876
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
2877
2877
  # * (`nil`) indicating no credentials
2878
+ #
2879
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
2880
+ # external source for authentication to Google Cloud, you must validate it before
2881
+ # providing it to a Google API client library. Providing an unvalidated credential
2882
+ # configuration to Google APIs can compromise the security of your systems and data.
2883
+ # For more information, refer to [Validate credential configurations from external
2884
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
2878
2885
  # @return [::Object]
2879
2886
  # @!attribute [rw] scope
2880
2887
  # 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
@@ -453,10 +453,10 @@ module Google
453
453
  # @param order_by [::String]
454
454
  # Optional. Field by which to sort the results.
455
455
  # @yield [result, operation] Access the result along with the TransportOperation object
456
- # @yieldparam result [::Google::Cloud::GkeBackup::V1::ListBackupPlansResponse]
456
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeBackup::V1::BackupPlan>]
457
457
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
458
458
  #
459
- # @return [::Google::Cloud::GkeBackup::V1::ListBackupPlansResponse]
459
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeBackup::V1::BackupPlan>]
460
460
  #
461
461
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
462
462
  #
@@ -508,7 +508,9 @@ module Google
508
508
  retry_policy: @config.retry_policy
509
509
 
510
510
  @backup_for_gke_stub.list_backup_plans request, options do |result, operation|
511
+ result = ::Gapic::Rest::PagedEnumerable.new @backup_for_gke_stub, :list_backup_plans, "backup_plans", request, result, options
511
512
  yield result, operation if block_given?
513
+ throw :response, result
512
514
  end
513
515
  rescue ::Gapic::Rest::Error => e
514
516
  raise ::Google::Cloud::Error.from_error(e)
@@ -1578,10 +1580,10 @@ module Google
1578
1580
  # @param order_by [::String]
1579
1581
  # Optional. Field by which to sort the results.
1580
1582
  # @yield [result, operation] Access the result along with the TransportOperation object
1581
- # @yieldparam result [::Google::Cloud::GkeBackup::V1::ListRestorePlansResponse]
1583
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeBackup::V1::RestorePlan>]
1582
1584
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
1583
1585
  #
1584
- # @return [::Google::Cloud::GkeBackup::V1::ListRestorePlansResponse]
1586
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeBackup::V1::RestorePlan>]
1585
1587
  #
1586
1588
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1587
1589
  #
@@ -1633,7 +1635,9 @@ module Google
1633
1635
  retry_policy: @config.retry_policy
1634
1636
 
1635
1637
  @backup_for_gke_stub.list_restore_plans request, options do |result, operation|
1638
+ result = ::Gapic::Rest::PagedEnumerable.new @backup_for_gke_stub, :list_restore_plans, "restore_plans", request, result, options
1636
1639
  yield result, operation if block_given?
1640
+ throw :response, result
1637
1641
  end
1638
1642
  rescue ::Gapic::Rest::Error => e
1639
1643
  raise ::Google::Cloud::Error.from_error(e)
@@ -2050,10 +2054,10 @@ module Google
2050
2054
  # @param order_by [::String]
2051
2055
  # Optional. Field by which to sort the results.
2052
2056
  # @yield [result, operation] Access the result along with the TransportOperation object
2053
- # @yieldparam result [::Google::Cloud::GkeBackup::V1::ListRestoresResponse]
2057
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeBackup::V1::Restore>]
2054
2058
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
2055
2059
  #
2056
- # @return [::Google::Cloud::GkeBackup::V1::ListRestoresResponse]
2060
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeBackup::V1::Restore>]
2057
2061
  #
2058
2062
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
2059
2063
  #
@@ -2105,7 +2109,9 @@ module Google
2105
2109
  retry_policy: @config.retry_policy
2106
2110
 
2107
2111
  @backup_for_gke_stub.list_restores request, options do |result, operation|
2112
+ result = ::Gapic::Rest::PagedEnumerable.new @backup_for_gke_stub, :list_restores, "restores", request, result, options
2108
2113
  yield result, operation if block_given?
2114
+ throw :response, result
2109
2115
  end
2110
2116
  rescue ::Gapic::Rest::Error => e
2111
2117
  raise ::Google::Cloud::Error.from_error(e)
@@ -2687,6 +2693,13 @@ module Google
2687
2693
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
2688
2694
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
2689
2695
  # * (`nil`) indicating no credentials
2696
+ #
2697
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
2698
+ # external source for authentication to Google Cloud, you must validate it before
2699
+ # providing it to a Google API client library. Providing an unvalidated credential
2700
+ # configuration to Google APIs can compromise the security of your systems and data.
2701
+ # For more information, refer to [Validate credential configurations from external
2702
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
2690
2703
  # @return [::Object]
2691
2704
  # @!attribute [rw] scope
2692
2705
  # 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 GkeBackup
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
@@ -93,14 +93,20 @@ module Google
93
93
  # @!attribute [r] all_namespaces
94
94
  # @return [::Boolean]
95
95
  # Output only. If True, all namespaces were included in the Backup.
96
+ #
97
+ # Note: The following fields are mutually exclusive: `all_namespaces`, `selected_namespaces`, `selected_applications`. If a field in that set is populated, all other fields in the set will automatically be cleared.
96
98
  # @!attribute [r] selected_namespaces
97
99
  # @return [::Google::Cloud::GkeBackup::V1::Namespaces]
98
100
  # Output only. If set, the list of namespaces that were included in the
99
101
  # Backup.
102
+ #
103
+ # Note: The following fields are mutually exclusive: `selected_namespaces`, `all_namespaces`, `selected_applications`. If a field in that set is populated, all other fields in the set will automatically be cleared.
100
104
  # @!attribute [r] selected_applications
101
105
  # @return [::Google::Cloud::GkeBackup::V1::NamespacedNames]
102
106
  # Output only. If set, the list of ProtectedApplications whose resources
103
107
  # were included in the Backup.
108
+ #
109
+ # Note: The following fields are mutually exclusive: `selected_applications`, `all_namespaces`, `selected_namespaces`. If a field in that set is populated, all other fields in the set will automatically be cleared.
104
110
  # @!attribute [r] contains_volume_data
105
111
  # @return [::Boolean]
106
112
  # Output only. Whether or not the Backup contains volume data. Controlled by
@@ -191,9 +197,13 @@ module Google
191
197
  # @!attribute [r] gke_version
192
198
  # @return [::String]
193
199
  # Output only. GKE version
200
+ #
201
+ # Note: The following fields are mutually exclusive: `gke_version`, `anthos_version`. If a field in that set is populated, all other fields in the set will automatically be cleared.
194
202
  # @!attribute [r] anthos_version
195
203
  # @return [::String]
196
204
  # Output only. Anthos version
205
+ #
206
+ # Note: The following fields are mutually exclusive: `anthos_version`, `gke_version`. If a field in that set is populated, all other fields in the set will automatically be cleared.
197
207
  class ClusterMetadata
198
208
  include ::Google::Protobuf::MessageExts
199
209
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -197,13 +197,19 @@ module Google
197
197
  # @!attribute [rw] all_namespaces
198
198
  # @return [::Boolean]
199
199
  # If True, include all namespaced resources
200
+ #
201
+ # Note: The following fields are mutually exclusive: `all_namespaces`, `selected_namespaces`, `selected_applications`. If a field in that set is populated, all other fields in the set will automatically be cleared.
200
202
  # @!attribute [rw] selected_namespaces
201
203
  # @return [::Google::Cloud::GkeBackup::V1::Namespaces]
202
204
  # If set, include just the resources in the listed namespaces.
205
+ #
206
+ # Note: The following fields are mutually exclusive: `selected_namespaces`, `all_namespaces`, `selected_applications`. If a field in that set is populated, all other fields in the set will automatically be cleared.
203
207
  # @!attribute [rw] selected_applications
204
208
  # @return [::Google::Cloud::GkeBackup::V1::NamespacedNames]
205
209
  # If set, include just the resources referenced by the listed
206
210
  # ProtectedApplications.
211
+ #
212
+ # Note: The following fields are mutually exclusive: `selected_applications`, `all_namespaces`, `selected_namespaces`. If a field in that set is populated, all other fields in the set will automatically be cleared.
207
213
  # @!attribute [rw] include_volume_data
208
214
  # @return [::Boolean]
209
215
  # Optional. This flag specifies whether volume data should be backed up
@@ -316,13 +322,19 @@ module Google
316
322
  # @return [::Google::Type::Date]
317
323
  # No recurrence. The exclusion window occurs only once and on this
318
324
  # date in UTC.
325
+ #
326
+ # Note: The following fields are mutually exclusive: `single_occurrence_date`, `daily`, `days_of_week`. If a field in that set is populated, all other fields in the set will automatically be cleared.
319
327
  # @!attribute [rw] daily
320
328
  # @return [::Boolean]
321
329
  # The exclusion window occurs every day if set to "True".
322
330
  # Specifying this field to "False" is an error.
331
+ #
332
+ # Note: The following fields are mutually exclusive: `daily`, `single_occurrence_date`, `days_of_week`. If a field in that set is populated, all other fields in the set will automatically be cleared.
323
333
  # @!attribute [rw] days_of_week
324
334
  # @return [::Google::Cloud::GkeBackup::V1::ExclusionWindow::DayOfWeekList]
325
335
  # The exclusion window occurs on these days of each week in UTC.
336
+ #
337
+ # Note: The following fields are mutually exclusive: `days_of_week`, `single_occurrence_date`, `daily`. If a field in that set is populated, all other fields in the set will automatically be cleared.
326
338
  class ExclusionWindow
327
339
  include ::Google::Protobuf::MessageExts
328
340
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -201,23 +201,33 @@ module Google
201
201
  # @return [::Boolean]
202
202
  # Restore all namespaced resources in the Backup if set to "True".
203
203
  # Specifying this field to "False" is an error.
204
+ #
205
+ # Note: The following fields are mutually exclusive: `all_namespaces`, `selected_namespaces`, `selected_applications`, `no_namespaces`, `excluded_namespaces`. If a field in that set is populated, all other fields in the set will automatically be cleared.
204
206
  # @!attribute [rw] selected_namespaces
205
207
  # @return [::Google::Cloud::GkeBackup::V1::Namespaces]
206
208
  # A list of selected Namespaces to restore from the Backup. The listed
207
209
  # Namespaces and all resources contained in them will be restored.
210
+ #
211
+ # Note: The following fields are mutually exclusive: `selected_namespaces`, `all_namespaces`, `selected_applications`, `no_namespaces`, `excluded_namespaces`. If a field in that set is populated, all other fields in the set will automatically be cleared.
208
212
  # @!attribute [rw] selected_applications
209
213
  # @return [::Google::Cloud::GkeBackup::V1::NamespacedNames]
210
214
  # A list of selected ProtectedApplications to restore. The listed
211
215
  # ProtectedApplications and all the resources to which they refer will be
212
216
  # restored.
217
+ #
218
+ # Note: The following fields are mutually exclusive: `selected_applications`, `all_namespaces`, `selected_namespaces`, `no_namespaces`, `excluded_namespaces`. If a field in that set is populated, all other fields in the set will automatically be cleared.
213
219
  # @!attribute [rw] no_namespaces
214
220
  # @return [::Boolean]
215
221
  # Do not restore any namespaced resources if set to "True".
216
222
  # Specifying this field to "False" is not allowed.
223
+ #
224
+ # Note: The following fields are mutually exclusive: `no_namespaces`, `all_namespaces`, `selected_namespaces`, `selected_applications`, `excluded_namespaces`. If a field in that set is populated, all other fields in the set will automatically be cleared.
217
225
  # @!attribute [rw] excluded_namespaces
218
226
  # @return [::Google::Cloud::GkeBackup::V1::Namespaces]
219
227
  # A list of selected namespaces excluded from restoration. All
220
228
  # namespaces except those in this list will be restored.
229
+ #
230
+ # Note: The following fields are mutually exclusive: `excluded_namespaces`, `all_namespaces`, `selected_namespaces`, `selected_applications`, `no_namespaces`. If a field in that set is populated, all other fields in the set will automatically be cleared.
221
231
  # @!attribute [rw] substitution_rules
222
232
  # @return [::Array<::Google::Cloud::GkeBackup::V1::RestoreConfig::SubstitutionRule>]
223
233
  # Optional. A list of transformation rules to be applied against Kubernetes
@@ -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-gke_backup-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: Backup for GKE is a managed Kubernetes workload backup and restore service
169
166
  for GKE clusters.