google-cloud-bigquery-reservation-v1 0.4.2 → 0.5.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: 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