google-cloud-bigquery-reservation-v1 0.7.0 → 0.8.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: 2fced309d84b0b3968da1ce270764f3534b96e3a7ea7f1cce0bd43a70b843b22
4
- data.tar.gz: 425f3be26e9f9af5bd8871e30d985ebee53b52f6ff8913b69bf2bee9ffd76279
3
+ metadata.gz: f700df3e772219789e42945c9882c85335102b4ab54144d2e15f18bc18e8c0a6
4
+ data.tar.gz: 5e4fa02dab05445bedebff685d6ae1168dbe884f3ba3d45cc5b0b1b63c69048a
5
5
  SHA512:
6
- metadata.gz: 8ff4feb5aa7ccb0b060d29577fe0fa37562fb14808b93b45be061428356b5b73cbab73f7fa83280e1b2564bf76f1559083522953bb47d6837beae50a8a8d4f9c
7
- data.tar.gz: '0986ed11755dae29f746c1bc44087facef37731c875159827caadff9244910346a45b62c7d8777cd78d707ae00f9a6bf658a47c76cef9f1672c3809ad1a462fa'
6
+ metadata.gz: 1fd72e1d6af15f41e10709c63d3b058bccd5d06f6ef57ce7bfc059c41ad8b91c152315a747eb7129d5946386e165288e436f9eea3fff3b20dd080db4d830af3d
7
+ data.tar.gz: 20c0b758fdd3d0a66ac3eb0890891e8eccdf980cc444ded4ee1b6526bc5e0ad7882cc52b0d9c8d1b49555483c6fb4283f332e3fd5a7fcd044fa32b93c03e1f71
data/README.md CHANGED
@@ -47,7 +47,7 @@ for general usage information.
47
47
 
48
48
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
49
  The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
50
+ or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
51
  that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
53
 
@@ -18,10 +18,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
18
18
  optional :name, :string, 1
19
19
  optional :slot_capacity, :int64, 2
20
20
  optional :ignore_idle_slots, :bool, 4
21
+ optional :autoscale, :message, 7, "google.cloud.bigquery.reservation.v1.Reservation.Autoscale"
21
22
  optional :concurrency, :int64, 16
22
23
  optional :creation_time, :message, 8, "google.protobuf.Timestamp"
23
24
  optional :update_time, :message, 9, "google.protobuf.Timestamp"
24
25
  optional :multi_region_auxiliary, :bool, 14
26
+ optional :edition, :enum, 17, "google.cloud.bigquery.reservation.v1.Edition"
27
+ end
28
+ add_message "google.cloud.bigquery.reservation.v1.Reservation.Autoscale" do
29
+ optional :current_slots, :int64, 1
30
+ optional :max_slots, :int64, 2
25
31
  end
26
32
  add_message "google.cloud.bigquery.reservation.v1.CapacityCommitment" do
27
33
  optional :name, :string, 1
@@ -33,13 +39,19 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
33
39
  optional :failure_status, :message, 7, "google.rpc.Status"
34
40
  optional :renewal_plan, :enum, 8, "google.cloud.bigquery.reservation.v1.CapacityCommitment.CommitmentPlan"
35
41
  optional :multi_region_auxiliary, :bool, 10
42
+ optional :edition, :enum, 12, "google.cloud.bigquery.reservation.v1.Edition"
36
43
  end
37
44
  add_enum "google.cloud.bigquery.reservation.v1.CapacityCommitment.CommitmentPlan" do
38
45
  value :COMMITMENT_PLAN_UNSPECIFIED, 0
39
46
  value :FLEX, 3
47
+ value :FLEX_FLAT_RATE, 7
40
48
  value :TRIAL, 5
41
49
  value :MONTHLY, 2
50
+ value :MONTHLY_FLAT_RATE, 8
42
51
  value :ANNUAL, 4
52
+ value :ANNUAL_FLAT_RATE, 9
53
+ value :THREE_YEAR, 10
54
+ value :NONE, 6
43
55
  end
44
56
  add_enum "google.cloud.bigquery.reservation.v1.CapacityCommitment.State" do
45
57
  value :STATE_UNSPECIFIED, 0
@@ -120,6 +132,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
120
132
  value :PIPELINE, 1
121
133
  value :QUERY, 2
122
134
  value :ML_EXTERNAL, 3
135
+ value :BACKGROUND, 4
123
136
  end
124
137
  add_enum "google.cloud.bigquery.reservation.v1.Assignment.State" do
125
138
  value :STATE_UNSPECIFIED, 0
@@ -166,6 +179,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
166
179
  add_message "google.cloud.bigquery.reservation.v1.MoveAssignmentRequest" do
167
180
  optional :name, :string, 1
168
181
  optional :destination_id, :string, 3
182
+ optional :assignment_id, :string, 5
169
183
  end
170
184
  add_message "google.cloud.bigquery.reservation.v1.UpdateAssignmentRequest" do
171
185
  optional :assignment, :message, 1, "google.cloud.bigquery.reservation.v1.Assignment"
@@ -189,6 +203,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
189
203
  optional :bi_reservation, :message, 1, "google.cloud.bigquery.reservation.v1.BiReservation"
190
204
  optional :update_mask, :message, 2, "google.protobuf.FieldMask"
191
205
  end
206
+ add_enum "google.cloud.bigquery.reservation.v1.Edition" do
207
+ value :EDITION_UNSPECIFIED, 0
208
+ value :STANDARD, 1
209
+ value :ENTERPRISE, 2
210
+ value :ENTERPRISE_PLUS, 3
211
+ end
192
212
  end
193
213
  end
194
214
 
@@ -198,6 +218,7 @@ module Google
198
218
  module Reservation
199
219
  module V1
200
220
  Reservation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.Reservation").msgclass
221
+ Reservation::Autoscale = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.Reservation.Autoscale").msgclass
201
222
  CapacityCommitment = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.CapacityCommitment").msgclass
202
223
  CapacityCommitment::CommitmentPlan = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.CapacityCommitment.CommitmentPlan").enummodule
203
224
  CapacityCommitment::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.CapacityCommitment.State").enummodule
@@ -233,6 +254,7 @@ module Google
233
254
  BiReservation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.BiReservation").msgclass
234
255
  GetBiReservationRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.GetBiReservationRequest").msgclass
235
256
  UpdateBiReservationRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.UpdateBiReservationRequest").msgclass
257
+ Edition = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.Edition").enummodule
236
258
  end
237
259
  end
238
260
  end
@@ -1721,8 +1721,8 @@ module Google
1721
1721
  # the default parameter values, pass an empty Hash as a request object (see above).
1722
1722
  #
1723
1723
  # @param parent [::String]
1724
- # Required. The resource name of the admin project(containing project and location),
1725
- # e.g.:
1724
+ # Required. The resource name of the admin project(containing project and
1725
+ # location), e.g.:
1726
1726
  # `projects/myproject/locations/US`.
1727
1727
  # @param query [::String]
1728
1728
  # Please specify resource name as assignee in the query.
@@ -1844,8 +1844,8 @@ module Google
1844
1844
  # the default parameter values, pass an empty Hash as a request object (see above).
1845
1845
  #
1846
1846
  # @param parent [::String]
1847
- # Required. The resource name with location (project name could be the wildcard '-'),
1848
- # e.g.:
1847
+ # Required. The resource name with location (project name could be the
1848
+ # wildcard '-'), e.g.:
1849
1849
  # `projects/-/locations/US`.
1850
1850
  # @param query [::String]
1851
1851
  # Please specify resource name as assignee in the query.
@@ -1946,7 +1946,7 @@ module Google
1946
1946
  # @param options [::Gapic::CallOptions, ::Hash]
1947
1947
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1948
1948
  #
1949
- # @overload move_assignment(name: nil, destination_id: nil)
1949
+ # @overload move_assignment(name: nil, destination_id: nil, assignment_id: nil)
1950
1950
  # Pass arguments to `move_assignment` via keyword arguments. Note that at
1951
1951
  # least one keyword argument is required. To specify no parameters, or to keep all
1952
1952
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1958,6 +1958,12 @@ module Google
1958
1958
  # @param destination_id [::String]
1959
1959
  # The new reservation ID, e.g.:
1960
1960
  # `projects/myotherproject/locations/US/reservations/team2-prod`
1961
+ # @param assignment_id [::String]
1962
+ # The optional assignment ID. A new assignment name is generated if this
1963
+ # field is empty.
1964
+ #
1965
+ # This field can contain only lowercase alphanumeric characters or dashes.
1966
+ # Max length is 64 characters.
1961
1967
  #
1962
1968
  # @yield [response, operation] Access the result along with the RPC operation
1963
1969
  # @yieldparam response [::Google::Cloud::Bigquery::Reservation::V1::Assignment]
@@ -2330,9 +2336,9 @@ module Google
2330
2336
  # * (`String`) The path to a service account key file in JSON format
2331
2337
  # * (`Hash`) A service account key as a Hash
2332
2338
  # * (`Google::Auth::Credentials`) A googleauth credentials object
2333
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
2339
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
2334
2340
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
2335
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
2341
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
2336
2342
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
2337
2343
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
2338
2344
  # * (`nil`) indicating no credentials
@@ -1353,8 +1353,8 @@ module Google
1353
1353
  # the default parameter values, pass an empty Hash as a request object (see above).
1354
1354
  #
1355
1355
  # @param parent [::String]
1356
- # Required. The resource name of the admin project(containing project and location),
1357
- # e.g.:
1356
+ # Required. The resource name of the admin project(containing project and
1357
+ # location), e.g.:
1358
1358
  # `projects/myproject/locations/US`.
1359
1359
  # @param query [::String]
1360
1360
  # Please specify resource name as assignee in the query.
@@ -1449,8 +1449,8 @@ module Google
1449
1449
  # the default parameter values, pass an empty Hash as a request object (see above).
1450
1450
  #
1451
1451
  # @param parent [::String]
1452
- # Required. The resource name with location (project name could be the wildcard '-'),
1453
- # e.g.:
1452
+ # Required. The resource name with location (project name could be the
1453
+ # wildcard '-'), e.g.:
1454
1454
  # `projects/-/locations/US`.
1455
1455
  # @param query [::String]
1456
1456
  # Please specify resource name as assignee in the query.
@@ -1524,7 +1524,7 @@ module Google
1524
1524
  # @param options [::Gapic::CallOptions, ::Hash]
1525
1525
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1526
1526
  #
1527
- # @overload move_assignment(name: nil, destination_id: nil)
1527
+ # @overload move_assignment(name: nil, destination_id: nil, assignment_id: nil)
1528
1528
  # Pass arguments to `move_assignment` via keyword arguments. Note that at
1529
1529
  # least one keyword argument is required. To specify no parameters, or to keep all
1530
1530
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1536,6 +1536,12 @@ module Google
1536
1536
  # @param destination_id [::String]
1537
1537
  # The new reservation ID, e.g.:
1538
1538
  # `projects/myotherproject/locations/US/reservations/team2-prod`
1539
+ # @param assignment_id [::String]
1540
+ # The optional assignment ID. A new assignment name is generated if this
1541
+ # field is empty.
1542
+ #
1543
+ # This field can contain only lowercase alphanumeric characters or dashes.
1544
+ # Max length is 64 characters.
1539
1545
  # @yield [result, operation] Access the result along with the TransportOperation object
1540
1546
  # @yieldparam result [::Google::Cloud::Bigquery::Reservation::V1::Assignment]
1541
1547
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1816,9 +1822,9 @@ module Google
1816
1822
  # * (`String`) The path to a service account key file in JSON format
1817
1823
  # * (`Hash`) A service account key as a Hash
1818
1824
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1819
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1825
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1820
1826
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1821
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1827
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1822
1828
  # * (`nil`) indicating no credentials
1823
1829
  # @return [::Object]
1824
1830
  # @!attribute [rw] scope
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigquery
23
23
  module Reservation
24
24
  module V1
25
- VERSION = "0.7.0"
25
+ VERSION = "0.8.0"
26
26
  end
27
27
  end
28
28
  end
@@ -35,7 +35,9 @@ module Google
35
35
  # Details about how and where to publish client libraries.
36
36
  # @!attribute [rw] version
37
37
  # @return [::String]
38
- # Version of the API to apply these settings to.
38
+ # Version of the API to apply these settings to. This is the full protobuf
39
+ # package for the API, ending in the version element.
40
+ # Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
39
41
  # @!attribute [rw] launch_stage
40
42
  # @return [::Google::Api::LaunchStage]
41
43
  # Launch stage of this version of the API.
@@ -111,6 +113,10 @@ module Google
111
113
  # Client library settings. If the same version string appears multiple
112
114
  # times in this list, then the last one wins. Settings from earlier
113
115
  # settings with the same version string are discarded.
116
+ # @!attribute [rw] proto_reference_documentation_uri
117
+ # @return [::String]
118
+ # Optional link to proto reference documentation. Example:
119
+ # https://cloud.google.com/pubsub/lite/docs/reference/rpc
114
120
  class Publishing
115
121
  include ::Google::Protobuf::MessageExts
116
122
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -240,8 +246,8 @@ module Google
240
246
  # Example of a YAML configuration::
241
247
  #
242
248
  # publishing:
243
- # method_behavior:
244
- # - selector: CreateAdDomain
249
+ # method_settings:
250
+ # - selector: google.cloud.speech.v2.Speech.BatchRecognize
245
251
  # long_running:
246
252
  # initial_poll_delay:
247
253
  # seconds: 60 # 1 minute
@@ -38,10 +38,10 @@ module Google
38
38
  # Queries using this reservation might use more slots during runtime if
39
39
  # ignore_idle_slots is set to false.
40
40
  #
41
- # If the new reservation's slot capacity exceeds the project's slot capacity
42
- # or if total slot capacity of the new reservation and its siblings exceeds
43
- # the project's slot capacity, the request will fail with
44
- # `google.rpc.Code.RESOURCE_EXHAUSTED`.
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`.
44
+ #
45
45
  #
46
46
  # NOTE: for reservations in US or EU multi-regions, slot capacity constraints
47
47
  # are checked separately for default and auxiliary regions. See
@@ -52,13 +52,20 @@ module Google
52
52
  # slots from other reservations within the same admin project. If true, a
53
53
  # query or pipeline job using this reservation will execute with the slot
54
54
  # capacity specified in the slot_capacity field at most.
55
+ # @!attribute [rw] autoscale
56
+ # @return [::Google::Cloud::Bigquery::Reservation::V1::Reservation::Autoscale]
57
+ # The configuration parameters for the auto scaling feature. Note this is an
58
+ # alpha feature.
55
59
  # @!attribute [rw] concurrency
56
60
  # @return [::Integer]
57
- # Maximum number of queries that are allowed to run concurrently in this
58
- # reservation. This is a soft limit due to asynchronous nature of the system
59
- # and various optimizations for small queries.
60
- # Default value is 0 which means that concurrency will be automatically set
61
- # based on the reservation size.
61
+ # Job concurrency target which sets a soft upper bound on the number of jobs
62
+ # that can run concurrently in this reservation. This is a soft target due to
63
+ # asynchronous nature of the system and various optimizations for small
64
+ # queries.
65
+ # Default value is 0 which means that concurrency target will be
66
+ # automatically computed by the system.
67
+ # NOTE: this field is exposed as `target_job_concurrency` in the Information
68
+ # Schema, DDL and BQ CLI.
62
69
  # @!attribute [r] creation_time
63
70
  # @return [::Google::Protobuf::Timestamp]
64
71
  # Output only. Creation time of the reservation.
@@ -73,9 +80,25 @@ module Google
73
80
  # If set to true, this reservation is placed in the organization's
74
81
  # secondary region which is designated for disaster recovery purposes.
75
82
  # If false, this reservation is placed in the organization's default region.
83
+ # @!attribute [rw] edition
84
+ # @return [::Google::Cloud::Bigquery::Reservation::V1::Edition]
85
+ # Edition of the reservation.
76
86
  class Reservation
77
87
  include ::Google::Protobuf::MessageExts
78
88
  extend ::Google::Protobuf::MessageExts::ClassMethods
89
+
90
+ # Auto scaling settings.
91
+ # @!attribute [r] current_slots
92
+ # @return [::Integer]
93
+ # Output only. The slot capacity added to this reservation when autoscale
94
+ # happens. Will be between [0, max_slots].
95
+ # @!attribute [rw] max_slots
96
+ # @return [::Integer]
97
+ # Number of slots to be scaled when needed.
98
+ class Autoscale
99
+ include ::Google::Protobuf::MessageExts
100
+ extend ::Google::Protobuf::MessageExts::ClassMethods
101
+ end
79
102
  end
80
103
 
81
104
  # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
@@ -106,12 +129,12 @@ module Google
106
129
  # Output only. State of the commitment.
107
130
  # @!attribute [r] commitment_start_time
108
131
  # @return [::Google::Protobuf::Timestamp]
109
- # Output only. The start of the current commitment period. It is applicable only for
110
- # ACTIVE capacity commitments.
132
+ # Output only. The start of the current commitment period. It is applicable
133
+ # only for ACTIVE capacity commitments.
111
134
  # @!attribute [r] commitment_end_time
112
135
  # @return [::Google::Protobuf::Timestamp]
113
- # Output only. The end of the current commitment period. It is applicable only for ACTIVE
114
- # capacity commitments.
136
+ # Output only. The end of the current commitment period. It is applicable
137
+ # only for ACTIVE capacity commitments.
115
138
  # @!attribute [r] failure_status
116
139
  # @return [::Google::Rpc::Status]
117
140
  # Output only. For FAILED commitment plan, provides the reason of failure.
@@ -128,6 +151,9 @@ module Google
128
151
  # If set to true, this commitment is placed in the organization's
129
152
  # secondary region which is designated for disaster recovery purposes.
130
153
  # If false, this commitment is placed in the organization's default region.
154
+ # @!attribute [rw] edition
155
+ # @return [::Google::Cloud::Bigquery::Reservation::V1::Edition]
156
+ # Edition of the capacity commitment.
131
157
  class CapacityCommitment
132
158
  include ::Google::Protobuf::MessageExts
133
159
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -144,6 +170,10 @@ module Google
144
170
  # any time.
145
171
  FLEX = 3
146
172
 
173
+ # Same as FLEX, should only be used if flat-rate commitments are still
174
+ # available.
175
+ FLEX_FLAT_RATE = 7
176
+
147
177
  # Trial commitments have a committed period of 182 days after becoming
148
178
  # ACTIVE. After that, they are converted to a new commitment based on the
149
179
  # `renewal_plan`. Default `renewal_plan` for Trial commitment is Flex so
@@ -155,10 +185,31 @@ module Google
155
185
  # removed any time.
156
186
  MONTHLY = 2
157
187
 
188
+ # Same as MONTHLY, should only be used if flat-rate commitments are still
189
+ # available.
190
+ MONTHLY_FLAT_RATE = 8
191
+
158
192
  # Annual commitments have a committed period of 365 days after becoming
159
193
  # ACTIVE. After that they are converted to a new commitment based on the
160
194
  # renewal_plan.
161
195
  ANNUAL = 4
196
+
197
+ # Same as ANNUAL, should only be used if flat-rate commitments are still
198
+ # available.
199
+ ANNUAL_FLAT_RATE = 9
200
+
201
+ # 3-year commitments have a committed period of 1095(3 * 365) days after
202
+ # becoming ACTIVE. After that they are converted to a new commitment based
203
+ # on the renewal_plan.
204
+ THREE_YEAR = 10
205
+
206
+ # Should only be used for `renewal_plan` and is only meaningful if
207
+ # edition is specified to values other than EDITION_UNSPECIFIED. Otherwise
208
+ # CreateCapacityCommitmentRequest or UpdateCapacityCommitmentRequest will
209
+ # be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`. If the
210
+ # renewal_plan is NONE, capacity commitment will be removed at the end of
211
+ # its commitment period.
212
+ NONE = 6
162
213
  end
163
214
 
164
215
  # Capacity commitment can either become ACTIVE right away or transition
@@ -180,7 +231,8 @@ module Google
180
231
  end
181
232
  end
182
233
 
183
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#create_reservation ReservationService.CreateReservation}.
234
+ # The request for
235
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#create_reservation ReservationService.CreateReservation}.
184
236
  # @!attribute [rw] parent
185
237
  # @return [::String]
186
238
  # Required. Project, location. E.g.,
@@ -198,7 +250,8 @@ module Google
198
250
  extend ::Google::Protobuf::MessageExts::ClassMethods
199
251
  end
200
252
 
201
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#list_reservations ReservationService.ListReservations}.
253
+ # The request for
254
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#list_reservations ReservationService.ListReservations}.
202
255
  # @!attribute [rw] parent
203
256
  # @return [::String]
204
257
  # Required. The parent resource name containing project and location, e.g.:
@@ -214,7 +267,8 @@ module Google
214
267
  extend ::Google::Protobuf::MessageExts::ClassMethods
215
268
  end
216
269
 
217
- # The response for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#list_reservations ReservationService.ListReservations}.
270
+ # The response for
271
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#list_reservations ReservationService.ListReservations}.
218
272
  # @!attribute [rw] reservations
219
273
  # @return [::Array<::Google::Cloud::Bigquery::Reservation::V1::Reservation>]
220
274
  # List of reservations visible to the user.
@@ -227,7 +281,8 @@ module Google
227
281
  extend ::Google::Protobuf::MessageExts::ClassMethods
228
282
  end
229
283
 
230
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#get_reservation ReservationService.GetReservation}.
284
+ # The request for
285
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#get_reservation ReservationService.GetReservation}.
231
286
  # @!attribute [rw] name
232
287
  # @return [::String]
233
288
  # Required. Resource name of the reservation to retrieve. E.g.,
@@ -237,7 +292,8 @@ module Google
237
292
  extend ::Google::Protobuf::MessageExts::ClassMethods
238
293
  end
239
294
 
240
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#delete_reservation ReservationService.DeleteReservation}.
295
+ # The request for
296
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#delete_reservation ReservationService.DeleteReservation}.
241
297
  # @!attribute [rw] name
242
298
  # @return [::String]
243
299
  # Required. Resource name of the reservation to retrieve. E.g.,
@@ -247,7 +303,8 @@ module Google
247
303
  extend ::Google::Protobuf::MessageExts::ClassMethods
248
304
  end
249
305
 
250
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#update_reservation ReservationService.UpdateReservation}.
306
+ # The request for
307
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#update_reservation ReservationService.UpdateReservation}.
251
308
  # @!attribute [rw] reservation
252
309
  # @return [::Google::Cloud::Bigquery::Reservation::V1::Reservation]
253
310
  # Content of the reservation to update.
@@ -259,7 +316,8 @@ module Google
259
316
  extend ::Google::Protobuf::MessageExts::ClassMethods
260
317
  end
261
318
 
262
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#create_capacity_commitment ReservationService.CreateCapacityCommitment}.
319
+ # The request for
320
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#create_capacity_commitment ReservationService.CreateCapacityCommitment}.
263
321
  # @!attribute [rw] parent
264
322
  # @return [::String]
265
323
  # Required. Resource name of the parent reservation. E.g.,
@@ -283,7 +341,8 @@ module Google
283
341
  extend ::Google::Protobuf::MessageExts::ClassMethods
284
342
  end
285
343
 
286
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#list_capacity_commitments ReservationService.ListCapacityCommitments}.
344
+ # The request for
345
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#list_capacity_commitments ReservationService.ListCapacityCommitments}.
287
346
  # @!attribute [rw] parent
288
347
  # @return [::String]
289
348
  # Required. Resource name of the parent reservation. E.g.,
@@ -299,7 +358,8 @@ module Google
299
358
  extend ::Google::Protobuf::MessageExts::ClassMethods
300
359
  end
301
360
 
302
- # The response for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#list_capacity_commitments ReservationService.ListCapacityCommitments}.
361
+ # The response for
362
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#list_capacity_commitments ReservationService.ListCapacityCommitments}.
303
363
  # @!attribute [rw] capacity_commitments
304
364
  # @return [::Array<::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment>]
305
365
  # List of capacity commitments visible to the user.
@@ -312,7 +372,8 @@ module Google
312
372
  extend ::Google::Protobuf::MessageExts::ClassMethods
313
373
  end
314
374
 
315
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#get_capacity_commitment ReservationService.GetCapacityCommitment}.
375
+ # The request for
376
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#get_capacity_commitment ReservationService.GetCapacityCommitment}.
316
377
  # @!attribute [rw] name
317
378
  # @return [::String]
318
379
  # Required. Resource name of the capacity commitment to retrieve. E.g.,
@@ -322,7 +383,8 @@ module Google
322
383
  extend ::Google::Protobuf::MessageExts::ClassMethods
323
384
  end
324
385
 
325
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#delete_capacity_commitment ReservationService.DeleteCapacityCommitment}.
386
+ # The request for
387
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#delete_capacity_commitment ReservationService.DeleteCapacityCommitment}.
326
388
  # @!attribute [rw] name
327
389
  # @return [::String]
328
390
  # Required. Resource name of the capacity commitment to delete. E.g.,
@@ -337,7 +399,8 @@ module Google
337
399
  extend ::Google::Protobuf::MessageExts::ClassMethods
338
400
  end
339
401
 
340
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#update_capacity_commitment ReservationService.UpdateCapacityCommitment}.
402
+ # The request for
403
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#update_capacity_commitment ReservationService.UpdateCapacityCommitment}.
341
404
  # @!attribute [rw] capacity_commitment
342
405
  # @return [::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment]
343
406
  # Content of the capacity commitment to update.
@@ -349,7 +412,8 @@ module Google
349
412
  extend ::Google::Protobuf::MessageExts::ClassMethods
350
413
  end
351
414
 
352
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#split_capacity_commitment ReservationService.SplitCapacityCommitment}.
415
+ # The request for
416
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#split_capacity_commitment ReservationService.SplitCapacityCommitment}.
353
417
  # @!attribute [rw] name
354
418
  # @return [::String]
355
419
  # Required. The resource name e.g.,:
@@ -362,7 +426,8 @@ module Google
362
426
  extend ::Google::Protobuf::MessageExts::ClassMethods
363
427
  end
364
428
 
365
- # The response for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#split_capacity_commitment ReservationService.SplitCapacityCommitment}.
429
+ # The response for
430
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#split_capacity_commitment ReservationService.SplitCapacityCommitment}.
366
431
  # @!attribute [rw] first
367
432
  # @return [::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment]
368
433
  # First capacity commitment, result of a split.
@@ -374,7 +439,8 @@ module Google
374
439
  extend ::Google::Protobuf::MessageExts::ClassMethods
375
440
  end
376
441
 
377
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#merge_capacity_commitments ReservationService.MergeCapacityCommitments}.
442
+ # The request for
443
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#merge_capacity_commitments ReservationService.MergeCapacityCommitments}.
378
444
  # @!attribute [rw] parent
379
445
  # @return [::String]
380
446
  # Parent resource that identifies admin project and location e.g.,
@@ -428,6 +494,9 @@ module Google
428
494
  # BigQuery ML jobs that use services external to BigQuery for model
429
495
  # training. These jobs will not utilize idle slots from other reservations.
430
496
  ML_EXTERNAL = 3
497
+
498
+ # Background jobs that BigQuery runs for the customers in the background.
499
+ BACKGROUND = 4
431
500
  end
432
501
 
433
502
  # Assignment will remain in PENDING state if no active capacity commitment is
@@ -446,7 +515,8 @@ module Google
446
515
  end
447
516
  end
448
517
 
449
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#create_assignment ReservationService.CreateAssignment}.
518
+ # The request for
519
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#create_assignment ReservationService.CreateAssignment}.
450
520
  # Note: "bigquery.reservationAssignments.create" permission is required on the
451
521
  # related assignee.
452
522
  # @!attribute [rw] parent
@@ -467,7 +537,8 @@ module Google
467
537
  extend ::Google::Protobuf::MessageExts::ClassMethods
468
538
  end
469
539
 
470
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#list_assignments ReservationService.ListAssignments}.
540
+ # The request for
541
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#list_assignments ReservationService.ListAssignments}.
471
542
  # @!attribute [rw] parent
472
543
  # @return [::String]
473
544
  # Required. The parent resource name e.g.:
@@ -488,7 +559,8 @@ module Google
488
559
  extend ::Google::Protobuf::MessageExts::ClassMethods
489
560
  end
490
561
 
491
- # The response for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#list_assignments ReservationService.ListAssignments}.
562
+ # The response for
563
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#list_assignments ReservationService.ListAssignments}.
492
564
  # @!attribute [rw] assignments
493
565
  # @return [::Array<::Google::Cloud::Bigquery::Reservation::V1::Assignment>]
494
566
  # List of assignments visible to the user.
@@ -501,7 +573,8 @@ module Google
501
573
  extend ::Google::Protobuf::MessageExts::ClassMethods
502
574
  end
503
575
 
504
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#delete_assignment ReservationService.DeleteAssignment}.
576
+ # The request for
577
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#delete_assignment ReservationService.DeleteAssignment}.
505
578
  # Note: "bigquery.reservationAssignments.delete" permission is required on the
506
579
  # related assignee.
507
580
  # @!attribute [rw] name
@@ -519,8 +592,8 @@ module Google
519
592
  # related assignee.
520
593
  # @!attribute [rw] parent
521
594
  # @return [::String]
522
- # Required. The resource name of the admin project(containing project and location),
523
- # e.g.:
595
+ # Required. The resource name of the admin project(containing project and
596
+ # location), e.g.:
524
597
  # `projects/myproject/locations/US`.
525
598
  # @!attribute [rw] query
526
599
  # @return [::String]
@@ -548,8 +621,8 @@ module Google
548
621
  # related assignee.
549
622
  # @!attribute [rw] parent
550
623
  # @return [::String]
551
- # Required. The resource name with location (project name could be the wildcard '-'),
552
- # e.g.:
624
+ # Required. The resource name with location (project name could be the
625
+ # wildcard '-'), e.g.:
553
626
  # `projects/-/locations/US`.
554
627
  # @!attribute [rw] query
555
628
  # @return [::String]
@@ -571,7 +644,8 @@ module Google
571
644
  extend ::Google::Protobuf::MessageExts::ClassMethods
572
645
  end
573
646
 
574
- # The response for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#search_assignments ReservationService.SearchAssignments}.
647
+ # The response for
648
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#search_assignments ReservationService.SearchAssignments}.
575
649
  # @!attribute [rw] assignments
576
650
  # @return [::Array<::Google::Cloud::Bigquery::Reservation::V1::Assignment>]
577
651
  # List of assignments visible to the user.
@@ -584,7 +658,8 @@ module Google
584
658
  extend ::Google::Protobuf::MessageExts::ClassMethods
585
659
  end
586
660
 
587
- # The response for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#search_all_assignments ReservationService.SearchAllAssignments}.
661
+ # The response for
662
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#search_all_assignments ReservationService.SearchAllAssignments}.
588
663
  # @!attribute [rw] assignments
589
664
  # @return [::Array<::Google::Cloud::Bigquery::Reservation::V1::Assignment>]
590
665
  # List of assignments visible to the user.
@@ -615,12 +690,20 @@ module Google
615
690
  # @return [::String]
616
691
  # The new reservation ID, e.g.:
617
692
  # `projects/myotherproject/locations/US/reservations/team2-prod`
693
+ # @!attribute [rw] assignment_id
694
+ # @return [::String]
695
+ # The optional assignment ID. A new assignment name is generated if this
696
+ # field is empty.
697
+ #
698
+ # This field can contain only lowercase alphanumeric characters or dashes.
699
+ # Max length is 64 characters.
618
700
  class MoveAssignmentRequest
619
701
  include ::Google::Protobuf::MessageExts
620
702
  extend ::Google::Protobuf::MessageExts::ClassMethods
621
703
  end
622
704
 
623
- # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#update_assignment ReservationService.UpdateAssignment}.
705
+ # The request for
706
+ # {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#update_assignment ReservationService.UpdateAssignment}.
624
707
  # @!attribute [rw] assignment
625
708
  # @return [::Google::Cloud::Bigquery::Reservation::V1::Assignment]
626
709
  # Content of the assignment to update.
@@ -689,6 +772,23 @@ module Google
689
772
  include ::Google::Protobuf::MessageExts
690
773
  extend ::Google::Protobuf::MessageExts::ClassMethods
691
774
  end
775
+
776
+ # The type of editions.
777
+ # Different features and behaviors are provided to different editions
778
+ # Capacity commitments and reservations are linked to editions.
779
+ module Edition
780
+ # Default value, which will be treated as ENTERPRISE.
781
+ EDITION_UNSPECIFIED = 0
782
+
783
+ # Standard edition.
784
+ STANDARD = 1
785
+
786
+ # Enterprise edition.
787
+ ENTERPRISE = 2
788
+
789
+ # Enterprise plus edition.
790
+ ENTERPRISE_PLUS = 3
791
+ end
692
792
  end
693
793
  end
694
794
  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: 0.7.0
4
+ version: 0.8.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: 2023-03-08 00:00:00.000000000 Z
11
+ date: 2023-03-24 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common