google-cloud-bigquery-reservation-v1 0.4.2 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: b296ad2acc74f6c083b9f6e6a56a4db3ddf22e7b6cdc496e77929da9dad5265a
4
- data.tar.gz: a3d297a574aeb962bde8d51dcb9285e0e555364f01bfe3b04ab77c21d9ef6180
3
+ metadata.gz: 47f112fc54de3426c4879a03e51d7dbea54814f3169a16cb18815b14c276cc0a
4
+ data.tar.gz: 4c85cce74d96c2b59996a4012a6326fc9cc665e166c9eb2c31359a066fd98397
5
5
  SHA512:
6
- metadata.gz: 32dc7b60458624dbd7d064c60c041290316cbba0e82dc5a74035a946a555bb1f9bfd93f39cfd52e1f7e4939f5df7d6776057fdabf208d7c7de91e35d46d056f9
7
- data.tar.gz: 0b81020e8b9bb204fe097205e1f4876980bf0757aba3a58cd596c8fb12c6547bdddde8213306b64e9006b2440d10baf5a70059069b0ccd1385b07fbc1aea703b
6
+ metadata.gz: df691d603622f10a5e6b2e75cfeae17b2dbe76800c0a60cf562747d47266225973fbbe4ac9f8d5c54620341e52a996fd847531a4ff8d000004118df4050a94a8
7
+ data.tar.gz: fb8b44325f1e755625edf193e180249fc57f3f7a4bf312e3fb79f9a8210c64dc8028c67bcaea4b0e9a72ec452e76390f37b0bbbd728d8ed3086f3619d250a5f5
data/README.md CHANGED
@@ -37,7 +37,7 @@ request = ::Google::Cloud::Bigquery::Reservation::V1::CreateReservationRequest.n
37
37
  response = client.create_reservation request
38
38
  ```
39
39
 
40
- View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-bigquery-reservation-v1/latest)
40
+ View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-bigquery-reservation-v1/latest)
41
41
  for class and method documentation.
42
42
 
43
43
  See also the [Product Documentation](https://cloud.google.com/bigquery/docs/reference/reservations)
@@ -17,8 +17,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
17
17
  optional :name, :string, 1
18
18
  optional :slot_capacity, :int64, 2
19
19
  optional :ignore_idle_slots, :bool, 4
20
+ optional :concurrency, :int64, 16
20
21
  optional :creation_time, :message, 8, "google.protobuf.Timestamp"
21
22
  optional :update_time, :message, 9, "google.protobuf.Timestamp"
23
+ optional :multi_region_auxiliary, :bool, 14
22
24
  end
23
25
  add_message "google.cloud.bigquery.reservation.v1.CapacityCommitment" do
24
26
  optional :name, :string, 1
@@ -29,6 +31,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
29
31
  optional :commitment_end_time, :message, 5, "google.protobuf.Timestamp"
30
32
  optional :failure_status, :message, 7, "google.rpc.Status"
31
33
  optional :renewal_plan, :enum, 8, "google.cloud.bigquery.reservation.v1.CapacityCommitment.CommitmentPlan"
34
+ optional :multi_region_auxiliary, :bool, 10
32
35
  end
33
36
  add_enum "google.cloud.bigquery.reservation.v1.CapacityCommitment.CommitmentPlan" do
34
37
  value :COMMITMENT_PLAN_UNSPECIFIED, 0
@@ -163,10 +166,20 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
163
166
  optional :name, :string, 1
164
167
  optional :destination_id, :string, 3
165
168
  end
169
+ add_message "google.cloud.bigquery.reservation.v1.UpdateAssignmentRequest" do
170
+ optional :assignment, :message, 1, "google.cloud.bigquery.reservation.v1.Assignment"
171
+ optional :update_mask, :message, 2, "google.protobuf.FieldMask"
172
+ end
173
+ add_message "google.cloud.bigquery.reservation.v1.TableReference" do
174
+ optional :project_id, :string, 1
175
+ optional :dataset_id, :string, 2
176
+ optional :table_id, :string, 3
177
+ end
166
178
  add_message "google.cloud.bigquery.reservation.v1.BiReservation" do
167
179
  optional :name, :string, 1
168
180
  optional :update_time, :message, 3, "google.protobuf.Timestamp"
169
181
  optional :size, :int64, 4
182
+ repeated :preferred_tables, :message, 5, "google.cloud.bigquery.reservation.v1.TableReference"
170
183
  end
171
184
  add_message "google.cloud.bigquery.reservation.v1.GetBiReservationRequest" do
172
185
  optional :name, :string, 1
@@ -214,6 +227,8 @@ module Google
214
227
  SearchAssignmentsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.SearchAssignmentsResponse").msgclass
215
228
  SearchAllAssignmentsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.SearchAllAssignmentsResponse").msgclass
216
229
  MoveAssignmentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.MoveAssignmentRequest").msgclass
230
+ UpdateAssignmentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.UpdateAssignmentRequest").msgclass
231
+ TableReference = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.TableReference").msgclass
217
232
  BiReservation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.BiReservation").msgclass
218
233
  GetBiReservationRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.GetBiReservationRequest").msgclass
219
234
  UpdateBiReservationRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.reservation.v1.UpdateBiReservationRequest").msgclass
@@ -249,8 +249,9 @@ module Google
249
249
  # Required. Project, location. E.g.,
250
250
  # `projects/myproject/locations/US`
251
251
  # @param reservation_id [::String]
252
- # The reservation ID. This field must only contain lower case alphanumeric
253
- # characters or dash. Max length is 64 characters.
252
+ # The reservation ID. It must only contain lower case alphanumeric
253
+ # characters or dashes. It must start with a letter and must not end
254
+ # with a dash. Its maximum length is 64 characters.
254
255
  # @param reservation [::Google::Cloud::Bigquery::Reservation::V1::Reservation, ::Hash]
255
256
  # Definition of the new reservation to create.
256
257
  #
@@ -705,8 +706,8 @@ module Google
705
706
  # @param capacity_commitment_id [::String]
706
707
  # The optional capacity commitment ID. Capacity commitment name will be
707
708
  # generated automatically if this field is empty.
708
- # This field must only contain lower case alphanumeric characters or dash.
709
- # Max length is 64 characters.
709
+ # This field must only contain lower case alphanumeric characters or dashes.
710
+ # The first and last character cannot be a dash. Max length is 64 characters.
710
711
  # NOTE: this ID won't be kept if the capacity commitment is split or merged.
711
712
  #
712
713
  # @yield [response, operation] Access the result along with the RPC operation
@@ -1149,7 +1150,7 @@ module Google
1149
1150
  #
1150
1151
  # For example, in order to downgrade from 10000 slots to 8000, you might
1151
1152
  # split a 10000 capacity commitment into commitments of 2000 and 8000. Then,
1152
- # you would change the plan of the first one to `FLEX` and then delete it.
1153
+ # you delete the first one after the commitment end time passes.
1153
1154
  #
1154
1155
  # @overload split_capacity_commitment(request, options = nil)
1155
1156
  # Pass arguments to `split_capacity_commitment` via a request object, either of type
@@ -1394,7 +1395,7 @@ module Google
1394
1395
  # @param assignment_id [::String]
1395
1396
  # The optional assignment ID. Assignment name will be generated automatically
1396
1397
  # if this field is empty.
1397
- # This field must only contain lower case alphanumeric characters or dash.
1398
+ # This field must only contain lower case alphanumeric characters or dashes.
1398
1399
  # Max length is 64 characters.
1399
1400
  #
1400
1401
  # @yield [response, operation] Access the result along with the RPC operation
@@ -1684,8 +1685,8 @@ module Google
1684
1685
  end
1685
1686
 
1686
1687
  ##
1687
- # Deprecated: Looks up assignments for a specified resource for a particular region.
1688
- # If the request is about a project:
1688
+ # Deprecated: Looks up assignments for a specified resource for a particular
1689
+ # region. If the request is about a project:
1689
1690
  #
1690
1691
  # 1. Assignments created on the project will be returned if they exist.
1691
1692
  # 2. Otherwise assignments created on the closest ancestor will be
@@ -2032,6 +2033,95 @@ module Google
2032
2033
  raise ::Google::Cloud::Error.from_error(e)
2033
2034
  end
2034
2035
 
2036
+ ##
2037
+ # Updates an existing assignment.
2038
+ #
2039
+ # Only the `priority` field can be updated.
2040
+ #
2041
+ # @overload update_assignment(request, options = nil)
2042
+ # Pass arguments to `update_assignment` via a request object, either of type
2043
+ # {::Google::Cloud::Bigquery::Reservation::V1::UpdateAssignmentRequest} or an equivalent Hash.
2044
+ #
2045
+ # @param request [::Google::Cloud::Bigquery::Reservation::V1::UpdateAssignmentRequest, ::Hash]
2046
+ # A request object representing the call parameters. Required. To specify no
2047
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2048
+ # @param options [::Gapic::CallOptions, ::Hash]
2049
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2050
+ #
2051
+ # @overload update_assignment(assignment: nil, update_mask: nil)
2052
+ # Pass arguments to `update_assignment` via keyword arguments. Note that at
2053
+ # least one keyword argument is required. To specify no parameters, or to keep all
2054
+ # the default parameter values, pass an empty Hash as a request object (see above).
2055
+ #
2056
+ # @param assignment [::Google::Cloud::Bigquery::Reservation::V1::Assignment, ::Hash]
2057
+ # Content of the assignment to update.
2058
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2059
+ # Standard field mask for the set of fields to be updated.
2060
+ #
2061
+ # @yield [response, operation] Access the result along with the RPC operation
2062
+ # @yieldparam response [::Google::Cloud::Bigquery::Reservation::V1::Assignment]
2063
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2064
+ #
2065
+ # @return [::Google::Cloud::Bigquery::Reservation::V1::Assignment]
2066
+ #
2067
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2068
+ #
2069
+ # @example Basic example
2070
+ # require "google/cloud/bigquery/reservation/v1"
2071
+ #
2072
+ # # Create a client object. The client can be reused for multiple calls.
2073
+ # client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
2074
+ #
2075
+ # # Create a request. To set request fields, pass in keyword arguments.
2076
+ # request = Google::Cloud::Bigquery::Reservation::V1::UpdateAssignmentRequest.new
2077
+ #
2078
+ # # Call the update_assignment method.
2079
+ # result = client.update_assignment request
2080
+ #
2081
+ # # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Assignment.
2082
+ # p result
2083
+ #
2084
+ def update_assignment request, options = nil
2085
+ raise ::ArgumentError, "request must be provided" if request.nil?
2086
+
2087
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Bigquery::Reservation::V1::UpdateAssignmentRequest
2088
+
2089
+ # Converts hash and nil to an options object
2090
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2091
+
2092
+ # Customize the options with defaults
2093
+ metadata = @config.rpcs.update_assignment.metadata.to_h
2094
+
2095
+ # Set x-goog-api-client and x-goog-user-project headers
2096
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2097
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2098
+ gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
2099
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2100
+
2101
+ header_params = {}
2102
+ if request.assignment&.name
2103
+ header_params["assignment.name"] = request.assignment.name
2104
+ end
2105
+
2106
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2107
+ metadata[:"x-goog-request-params"] ||= request_params_header
2108
+
2109
+ options.apply_defaults timeout: @config.rpcs.update_assignment.timeout,
2110
+ metadata: metadata,
2111
+ retry_policy: @config.rpcs.update_assignment.retry_policy
2112
+
2113
+ options.apply_defaults timeout: @config.timeout,
2114
+ metadata: @config.metadata,
2115
+ retry_policy: @config.retry_policy
2116
+
2117
+ @reservation_service_stub.call_rpc :update_assignment, request, options: options do |response, operation|
2118
+ yield response, operation if block_given?
2119
+ return response
2120
+ end
2121
+ rescue ::GRPC::BadStatus => e
2122
+ raise ::Google::Cloud::Error.from_error(e)
2123
+ end
2124
+
2035
2125
  ##
2036
2126
  # Retrieves a BI reservation.
2037
2127
  #
@@ -2438,6 +2528,11 @@ module Google
2438
2528
  #
2439
2529
  attr_reader :move_assignment
2440
2530
  ##
2531
+ # RPC-specific configuration for `update_assignment`
2532
+ # @return [::Gapic::Config::Method]
2533
+ #
2534
+ attr_reader :update_assignment
2535
+ ##
2441
2536
  # RPC-specific configuration for `get_bi_reservation`
2442
2537
  # @return [::Gapic::Config::Method]
2443
2538
  #
@@ -2486,6 +2581,8 @@ module Google
2486
2581
  @search_all_assignments = ::Gapic::Config::Method.new search_all_assignments_config
2487
2582
  move_assignment_config = parent_rpcs.move_assignment if parent_rpcs.respond_to? :move_assignment
2488
2583
  @move_assignment = ::Gapic::Config::Method.new move_assignment_config
2584
+ update_assignment_config = parent_rpcs.update_assignment if parent_rpcs.respond_to? :update_assignment
2585
+ @update_assignment = ::Gapic::Config::Method.new update_assignment_config
2489
2586
  get_bi_reservation_config = parent_rpcs.get_bi_reservation if parent_rpcs.respond_to? :get_bi_reservation
2490
2587
  @get_bi_reservation = ::Gapic::Config::Method.new get_bi_reservation_config
2491
2588
  update_bi_reservation_config = parent_rpcs.update_bi_reservation if parent_rpcs.respond_to? :update_bi_reservation
@@ -85,7 +85,7 @@ module Google
85
85
  #
86
86
  # For example, in order to downgrade from 10000 slots to 8000, you might
87
87
  # split a 10000 capacity commitment into commitments of 2000 and 8000. Then,
88
- # you would change the plan of the first one to `FLEX` and then delete it.
88
+ # you delete the first one after the commitment end time passes.
89
89
  rpc :SplitCapacityCommitment, ::Google::Cloud::Bigquery::Reservation::V1::SplitCapacityCommitmentRequest, ::Google::Cloud::Bigquery::Reservation::V1::SplitCapacityCommitmentResponse
90
90
  # Merges capacity commitments of the same plan into a single commitment.
91
91
  #
@@ -169,8 +169,8 @@ module Google
169
169
  # queries from `project1` will still use `res1` while queries from
170
170
  # `project2` will switch to use on-demand mode.
171
171
  rpc :DeleteAssignment, ::Google::Cloud::Bigquery::Reservation::V1::DeleteAssignmentRequest, ::Google::Protobuf::Empty
172
- # Deprecated: Looks up assignments for a specified resource for a particular region.
173
- # If the request is about a project:
172
+ # Deprecated: Looks up assignments for a specified resource for a particular
173
+ # region. If the request is about a project:
174
174
  #
175
175
  # 1. Assignments created on the project will be returned if they exist.
176
176
  # 2. Otherwise assignments created on the closest ancestor will be
@@ -220,6 +220,10 @@ module Google
220
220
  # by providing a transactional change that ensures an assignee always has an
221
221
  # associated reservation.
222
222
  rpc :MoveAssignment, ::Google::Cloud::Bigquery::Reservation::V1::MoveAssignmentRequest, ::Google::Cloud::Bigquery::Reservation::V1::Assignment
223
+ # Updates an existing assignment.
224
+ #
225
+ # Only the `priority` field can be updated.
226
+ rpc :UpdateAssignment, ::Google::Cloud::Bigquery::Reservation::V1::UpdateAssignmentRequest, ::Google::Cloud::Bigquery::Reservation::V1::Assignment
223
227
  # Retrieves a BI reservation.
224
228
  rpc :GetBiReservation, ::Google::Cloud::Bigquery::Reservation::V1::GetBiReservationRequest, ::Google::Cloud::Bigquery::Reservation::V1::BiReservation
225
229
  # Updates a BI reservation.
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigquery
23
23
  module Reservation
24
24
  module V1
25
- VERSION = "0.4.2"
25
+ VERSION = "0.5.0"
26
26
  end
27
27
  end
28
28
  end
@@ -26,6 +26,8 @@ module Google
26
26
  ##
27
27
  # To load this package, including all its services, and instantiate a client:
28
28
  #
29
+ # @example
30
+ #
29
31
  # require "google/cloud/bigquery/reservation/v1"
30
32
  # client = ::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
31
33
  #
@@ -27,6 +27,9 @@ module Google
27
27
  # @return [::String]
28
28
  # The resource name of the reservation, e.g.,
29
29
  # `projects/*/locations/*/reservations/team1-prod`.
30
+ # The reservation_id must only contain lower case alphanumeric characters or
31
+ # dashes. It must start with a letter and must not end with a dash. Its
32
+ # maximum length is 64 characters.
30
33
  # @!attribute [rw] slot_capacity
31
34
  # @return [::Integer]
32
35
  # Minimum slots available to this reservation. A slot is a unit of
@@ -35,22 +38,41 @@ module Google
35
38
  # Queries using this reservation might use more slots during runtime if
36
39
  # ignore_idle_slots is set to false.
37
40
  #
38
- # If the new reservation's slot capacity exceed the parent's slot capacity or
39
- # if total slot capacity of the new reservation and its siblings exceeds the
40
- # parent's slot capacity, the request will fail with
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
41
44
  # `google.rpc.Code.RESOURCE_EXHAUSTED`.
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.
42
49
  # @!attribute [rw] ignore_idle_slots
43
50
  # @return [::Boolean]
44
51
  # If false, any query or pipeline job using this reservation will use idle
45
52
  # slots from other reservations within the same admin project. If true, a
46
53
  # query or pipeline job using this reservation will execute with the slot
47
54
  # capacity specified in the slot_capacity field at most.
55
+ # @!attribute [rw] concurrency
56
+ # @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.
48
62
  # @!attribute [r] creation_time
49
63
  # @return [::Google::Protobuf::Timestamp]
50
64
  # Output only. Creation time of the reservation.
51
65
  # @!attribute [r] update_time
52
66
  # @return [::Google::Protobuf::Timestamp]
53
67
  # Output only. Last update time of the reservation.
68
+ # @!attribute [rw] multi_region_auxiliary
69
+ # @return [::Boolean]
70
+ # Applicable only for reservations located within one of the BigQuery
71
+ # multi-regions (US or EU).
72
+ #
73
+ # If set to true, this reservation is placed in the organization's
74
+ # secondary region which is designated for disaster recovery purposes.
75
+ # If false, this reservation is placed in the organization's default region.
54
76
  class Reservation
55
77
  include ::Google::Protobuf::MessageExts
56
78
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -70,6 +92,9 @@ module Google
70
92
  # @return [::String]
71
93
  # Output only. The resource name of the capacity commitment, e.g.,
72
94
  # `projects/myproject/locations/US/capacityCommitments/123`
95
+ # The commitment_id must only contain lower case alphanumeric characters or
96
+ # dashes. It must start with a letter and must not end
97
+ # with a dash. Its maximum length is 64 characters.
73
98
  # @!attribute [rw] slot_count
74
99
  # @return [::Integer]
75
100
  # Number of slots in this commitment.
@@ -95,6 +120,14 @@ module Google
95
120
  # The plan this capacity commitment is converted to after commitment_end_time
96
121
  # passes. Once the plan is changed, committed period is extended according to
97
122
  # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
123
+ # @!attribute [rw] multi_region_auxiliary
124
+ # @return [::Boolean]
125
+ # Applicable only for commitments located within one of the BigQuery
126
+ # multi-regions (US or EU).
127
+ #
128
+ # If set to true, this commitment is placed in the organization's
129
+ # secondary region which is designated for disaster recovery purposes.
130
+ # If false, this commitment is placed in the organization's default region.
98
131
  class CapacityCommitment
99
132
  include ::Google::Protobuf::MessageExts
100
133
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -135,11 +168,11 @@ module Google
135
168
  STATE_UNSPECIFIED = 0
136
169
 
137
170
  # Capacity commitment is pending provisioning. Pending capacity commitment
138
- # does not contribute to the parent's slot_capacity.
171
+ # does not contribute to the project's slot_capacity.
139
172
  PENDING = 1
140
173
 
141
174
  # Once slots are provisioned, capacity commitment becomes active.
142
- # slot_count is added to the parent's slot_capacity.
175
+ # slot_count is added to the project's slot_capacity.
143
176
  ACTIVE = 2
144
177
 
145
178
  # Capacity commitment is failed to be activated by the backend.
@@ -154,8 +187,9 @@ module Google
154
187
  # `projects/myproject/locations/US`
155
188
  # @!attribute [rw] reservation_id
156
189
  # @return [::String]
157
- # The reservation ID. This field must only contain lower case alphanumeric
158
- # characters or dash. Max length is 64 characters.
190
+ # The reservation ID. It must only contain lower case alphanumeric
191
+ # characters or dashes. It must start with a letter and must not end
192
+ # with a dash. Its maximum length is 64 characters.
159
193
  # @!attribute [rw] reservation
160
194
  # @return [::Google::Cloud::Bigquery::Reservation::V1::Reservation]
161
195
  # Definition of the new reservation to create.
@@ -241,8 +275,8 @@ module Google
241
275
  # @return [::String]
242
276
  # The optional capacity commitment ID. Capacity commitment name will be
243
277
  # generated automatically if this field is empty.
244
- # This field must only contain lower case alphanumeric characters or dash.
245
- # Max length is 64 characters.
278
+ # This field must only contain lower case alphanumeric characters or dashes.
279
+ # The first and last character cannot be a dash. Max length is 64 characters.
246
280
  # NOTE: this ID won't be kept if the capacity commitment is split or merged.
247
281
  class CreateCapacityCommitmentRequest
248
282
  include ::Google::Protobuf::MessageExts
@@ -357,12 +391,14 @@ module Google
357
391
  extend ::Google::Protobuf::MessageExts::ClassMethods
358
392
  end
359
393
 
360
- # A Assignment allows a project to submit jobs
394
+ # An assignment allows a project to submit jobs
361
395
  # of a certain type using slots from the specified reservation.
362
396
  # @!attribute [r] name
363
397
  # @return [::String]
364
398
  # Output only. Name of the resource. E.g.:
365
399
  # `projects/myproject/locations/US/reservations/team1-prod/assignments/123`.
400
+ # The assignment_id must only contain lower case alphanumeric characters or
401
+ # dashes and the max length is 64 characters.
366
402
  # @!attribute [rw] assignee
367
403
  # @return [::String]
368
404
  # The resource which will use the reservation. E.g.
@@ -424,7 +460,7 @@ module Google
424
460
  # @return [::String]
425
461
  # The optional assignment ID. Assignment name will be generated automatically
426
462
  # if this field is empty.
427
- # This field must only contain lower case alphanumeric characters or dash.
463
+ # This field must only contain lower case alphanumeric characters or dashes.
428
464
  # Max length is 64 characters.
429
465
  class CreateAssignmentRequest
430
466
  include ::Google::Protobuf::MessageExts
@@ -584,6 +620,34 @@ module Google
584
620
  extend ::Google::Protobuf::MessageExts::ClassMethods
585
621
  end
586
622
 
623
+ # The request for {::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client#update_assignment ReservationService.UpdateAssignment}.
624
+ # @!attribute [rw] assignment
625
+ # @return [::Google::Cloud::Bigquery::Reservation::V1::Assignment]
626
+ # Content of the assignment to update.
627
+ # @!attribute [rw] update_mask
628
+ # @return [::Google::Protobuf::FieldMask]
629
+ # Standard field mask for the set of fields to be updated.
630
+ class UpdateAssignmentRequest
631
+ include ::Google::Protobuf::MessageExts
632
+ extend ::Google::Protobuf::MessageExts::ClassMethods
633
+ end
634
+
635
+ # Fully qualified reference to BigQuery table.
636
+ # Internally stored as google.cloud.bi.v1.BqTableReference.
637
+ # @!attribute [rw] project_id
638
+ # @return [::String]
639
+ # The assigned project ID of the project.
640
+ # @!attribute [rw] dataset_id
641
+ # @return [::String]
642
+ # The ID of the dataset in the above project.
643
+ # @!attribute [rw] table_id
644
+ # @return [::String]
645
+ # The ID of the table in the above dataset.
646
+ class TableReference
647
+ include ::Google::Protobuf::MessageExts
648
+ extend ::Google::Protobuf::MessageExts::ClassMethods
649
+ end
650
+
587
651
  # Represents a BI Reservation.
588
652
  # @!attribute [rw] name
589
653
  # @return [::String]
@@ -596,6 +660,9 @@ module Google
596
660
  # @!attribute [rw] size
597
661
  # @return [::Integer]
598
662
  # Size of a reservation, in bytes.
663
+ # @!attribute [rw] preferred_tables
664
+ # @return [::Array<::Google::Cloud::Bigquery::Reservation::V1::TableReference>]
665
+ # Preferred tables to use BI capacity for.
599
666
  class BiReservation
600
667
  include ::Google::Protobuf::MessageExts
601
668
  extend ::Google::Protobuf::MessageExts::ClassMethods
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.4.2
4
+ version: 0.5.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: 2022-01-11 00:00:00.000000000 Z
11
+ date: 2022-04-14 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -207,7 +207,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
207
207
  - !ruby/object:Gem::Version
208
208
  version: '0'
209
209
  requirements: []
210
- rubygems_version: 3.3.4
210
+ rubygems_version: 3.3.5
211
211
  signing_key:
212
212
  specification_version: 4
213
213
  summary: API Client library for the BigQuery Reservation V1 API