google-cloud-bigquery-reservation-v1 1.0.1 → 1.2.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.
@@ -28,6 +28,9 @@ module Google
28
28
  # @!attribute [rw] destinations
29
29
  # @return [::Array<::Google::Api::ClientLibraryDestination>]
30
30
  # The destination where API teams want this client library to be published.
31
+ # @!attribute [rw] selective_gapic_generation
32
+ # @return [::Google::Api::SelectiveGapicGeneration]
33
+ # Configuration for which RPCs should be generated in the GAPIC client.
31
34
  class CommonLanguageSettings
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,6 +215,12 @@ module Google
212
215
  # enabled. By default, asynchronous REST clients will not be generated.
213
216
  # This feature will be enabled by default 1 month after launching the
214
217
  # feature in preview packages.
218
+ # @!attribute [rw] protobuf_pythonic_types_enabled
219
+ # @return [::Boolean]
220
+ # Enables generation of protobuf code using new types that are more
221
+ # Pythonic which are included in `protobuf>=5.29.x`. This feature will be
222
+ # enabled by default 1 month after launching the feature in preview
223
+ # packages.
215
224
  class ExperimentalFeatures
216
225
  include ::Google::Protobuf::MessageExts
217
226
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,9 +306,28 @@ module Google
297
306
  # @!attribute [rw] common
298
307
  # @return [::Google::Api::CommonLanguageSettings]
299
308
  # Some settings.
309
+ # @!attribute [rw] renamed_services
310
+ # @return [::Google::Protobuf::Map{::String => ::String}]
311
+ # Map of service names to renamed services. Keys are the package relative
312
+ # service names and values are the name to be used for the service client
313
+ # and call options.
314
+ #
315
+ # publishing:
316
+ # go_settings:
317
+ # renamed_services:
318
+ # Publisher: TopicAdmin
300
319
  class GoSettings
301
320
  include ::Google::Protobuf::MessageExts
302
321
  extend ::Google::Protobuf::MessageExts::ClassMethods
322
+
323
+ # @!attribute [rw] key
324
+ # @return [::String]
325
+ # @!attribute [rw] value
326
+ # @return [::String]
327
+ class RenamedServicesEntry
328
+ include ::Google::Protobuf::MessageExts
329
+ extend ::Google::Protobuf::MessageExts::ClassMethods
330
+ end
303
331
  end
304
332
 
305
333
  # Describes the generator configuration for a method.
@@ -375,6 +403,17 @@ module Google
375
403
  end
376
404
  end
377
405
 
406
+ # This message is used to configure the generation of a subset of the RPCs in
407
+ # a service for client libraries.
408
+ # @!attribute [rw] methods
409
+ # @return [::Array<::String>]
410
+ # An allowlist of the fully qualified names of RPCs that should be included
411
+ # on public client surfaces.
412
+ class SelectiveGapicGeneration
413
+ include ::Google::Protobuf::MessageExts
414
+ extend ::Google::Protobuf::MessageExts::ClassMethods
415
+ end
416
+
378
417
  # The organization for which the client libraries are being published.
379
418
  # Affects the url where generated docs are published, etc.
380
419
  module ClientLibraryOrganization
@@ -32,20 +32,26 @@ module Google
32
32
  # maximum length is 64 characters.
33
33
  # @!attribute [rw] slot_capacity
34
34
  # @return [::Integer]
35
- # Minimum slots available to this reservation. A slot is a unit of
35
+ # Baseline slots available to this reservation. A slot is a unit of
36
36
  # computational power in BigQuery, and serves as the unit of parallelism.
37
37
  #
38
38
  # Queries using this reservation might use more slots during runtime if
39
- # ignore_idle_slots is set to false.
39
+ # ignore_idle_slots is set to false, or autoscaling is enabled.
40
40
  #
41
- # If total slot_capacity of the reservation and its siblings
42
- # exceeds the total slot_count of all capacity commitments, the request will
43
- # fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
41
+ # If edition is EDITION_UNSPECIFIED and total slot_capacity of the
42
+ # reservation and its siblings exceeds the total slot_count of all capacity
43
+ # commitments, the request will fail with
44
+ # `google.rpc.Code.RESOURCE_EXHAUSTED`.
44
45
  #
45
- #
46
- # NOTE: for reservations in US or EU multi-regions, slot capacity constraints
47
- # are checked separately for default and auxiliary regions. See
48
- # multi_region_auxiliary flag for more details.
46
+ # If edition is any value but EDITION_UNSPECIFIED, then the above requirement
47
+ # is not needed. The total slot_capacity of the reservation and its siblings
48
+ # may exceed the total slot_count of capacity commitments. In that case, the
49
+ # exceeding slots will be charged with the autoscale SKU. You can increase
50
+ # the number of baseline slots in a reservation every few minutes. If you
51
+ # want to decrease your baseline slots, you are limited to once an hour if
52
+ # you have recently changed your baseline slot capacity and your baseline
53
+ # slots exceed your committed slots. Otherwise, you can decrease your
54
+ # baseline slots every few minutes.
49
55
  # @!attribute [rw] ignore_idle_slots
50
56
  # @return [::Boolean]
51
57
  # If false, any query or pipeline job using this reservation will use idle
@@ -54,8 +60,7 @@ module Google
54
60
  # capacity specified in the slot_capacity field at most.
55
61
  # @!attribute [rw] autoscale
56
62
  # @return [::Google::Cloud::Bigquery::Reservation::V1::Reservation::Autoscale]
57
- # The configuration parameters for the auto scaling feature. Note this is an
58
- # alpha feature.
63
+ # The configuration parameters for the auto scaling feature.
59
64
  # @!attribute [rw] concurrency
60
65
  # @return [::Integer]
61
66
  # Job concurrency target which sets a soft upper bound on the number of jobs
@@ -64,8 +69,8 @@ module Google
64
69
  # queries.
65
70
  # Default value is 0 which means that concurrency target will be
66
71
  # automatically computed by the system.
67
- # NOTE: this field is exposed as `target_job_concurrency` in the Information
68
- # Schema, DDL and BQ CLI.
72
+ # NOTE: this field is exposed as target job concurrency in the Information
73
+ # Schema, DDL and BigQuery CLI.
69
74
  # @!attribute [r] creation_time
70
75
  # @return [::Google::Protobuf::Timestamp]
71
76
  # Output only. Creation time of the reservation.
@@ -86,6 +91,23 @@ module Google
86
91
  # @!attribute [rw] edition
87
92
  # @return [::Google::Cloud::Bigquery::Reservation::V1::Edition]
88
93
  # Edition of the reservation.
94
+ # @!attribute [rw] primary_location
95
+ # @return [::String]
96
+ # Optional. The current location of the reservation's primary replica. This
97
+ # field is only set for reservations using the managed disaster recovery
98
+ # feature.
99
+ # @!attribute [rw] secondary_location
100
+ # @return [::String]
101
+ # Optional. The current location of the reservation's secondary replica. This
102
+ # field is only set for reservations using the managed disaster recovery
103
+ # feature. Users can set this in create reservation calls
104
+ # to create a failover reservation or in update reservation calls to convert
105
+ # a non-failover reservation to a failover reservation(or vice versa).
106
+ # @!attribute [rw] original_primary_location
107
+ # @return [::String]
108
+ # Optional. The location where the reservation was originally created. This
109
+ # is set only during the failover reservation's creation. All billing charges
110
+ # for the failover reservation will be applied to this location.
89
111
  class Reservation
90
112
  include ::Google::Protobuf::MessageExts
91
113
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -94,7 +116,10 @@ module Google
94
116
  # @!attribute [r] current_slots
95
117
  # @return [::Integer]
96
118
  # Output only. The slot capacity added to this reservation when autoscale
97
- # happens. Will be between [0, max_slots].
119
+ # happens. Will be between [0, max_slots]. Note: after users reduce
120
+ # max_slots, it may take a while before it can be propagated, so
121
+ # current_slots may stay in the original value and could be larger than
122
+ # max_slots for that brief period (less than one minute)
98
123
  # @!attribute [rw] max_slots
99
124
  # @return [::Integer]
100
125
  # Number of slots to be scaled when needed.
@@ -133,11 +158,16 @@ module Google
133
158
  # @!attribute [r] commitment_start_time
134
159
  # @return [::Google::Protobuf::Timestamp]
135
160
  # Output only. The start of the current commitment period. It is applicable
136
- # only for ACTIVE capacity commitments.
161
+ # only for ACTIVE capacity commitments. Note after the commitment is renewed,
162
+ # commitment_start_time won't be changed. It refers to the start time of the
163
+ # original commitment.
137
164
  # @!attribute [r] commitment_end_time
138
165
  # @return [::Google::Protobuf::Timestamp]
139
166
  # Output only. The end of the current commitment period. It is applicable
140
- # only for ACTIVE capacity commitments.
167
+ # only for ACTIVE capacity commitments. Note after renewal,
168
+ # commitment_end_time is the time the renewed commitment expires. So it would
169
+ # be at a time after commitment_start_time + committed period, because we
170
+ # don't change commitment_start_time ,
141
171
  # @!attribute [r] failure_status
142
172
  # @return [::Google::Rpc::Status]
143
173
  # Output only. For FAILED commitment plan, provides the reason of failure.
@@ -160,6 +190,10 @@ module Google
160
190
  # @!attribute [rw] edition
161
191
  # @return [::Google::Cloud::Bigquery::Reservation::V1::Edition]
162
192
  # Edition of the capacity commitment.
193
+ # @!attribute [r] is_flat_rate
194
+ # @return [::Boolean]
195
+ # Output only. If true, the commitment is a flat-rate commitment, otherwise,
196
+ # it's an edition commitment.
163
197
  class CapacityCommitment
164
198
  include ::Google::Protobuf::MessageExts
165
199
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -322,6 +356,16 @@ module Google
322
356
  extend ::Google::Protobuf::MessageExts::ClassMethods
323
357
  end
324
358
 
359
+ # The request for ReservationService.FailoverReservation.
360
+ # @!attribute [rw] name
361
+ # @return [::String]
362
+ # Required. Resource name of the reservation to failover. E.g.,
363
+ # `projects/myproject/locations/US/reservations/team1-prod`
364
+ class FailoverReservationRequest
365
+ include ::Google::Protobuf::MessageExts
366
+ extend ::Google::Protobuf::MessageExts::ClassMethods
367
+ end
368
+
325
369
  # The request for
326
370
  # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#create_capacity_commitment ReservationService.CreateCapacityCommitment}.
327
371
  # @!attribute [rw] parent
@@ -792,7 +836,7 @@ module Google
792
836
  # Enterprise edition.
793
837
  ENTERPRISE = 2
794
838
 
795
- # Enterprise plus edition.
839
+ # Enterprise Plus edition.
796
840
  ENTERPRISE_PLUS = 3
797
841
  end
798
842
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigquery-reservation-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.1
4
+ version: 1.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-08-30 00:00:00.000000000 Z
11
+ date: 2024-12-10 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.21.1
19
+ version: 0.24.0
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: 0.21.1
29
+ version: 0.24.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -102,7 +102,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
102
102
  - !ruby/object:Gem::Version
103
103
  version: '0'
104
104
  requirements: []
105
- rubygems_version: 3.5.6
105
+ rubygems_version: 3.5.23
106
106
  signing_key:
107
107
  specification_version: 4
108
108
  summary: A service to modify your BigQuery flat-rate reservations.