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 +4 -4
- data/README.md +1 -1
- data/lib/google/cloud/bigquery/reservation/v1/reservation_pb.rb +15 -0
- data/lib/google/cloud/bigquery/reservation/v1/reservation_service/client.rb +105 -8
- data/lib/google/cloud/bigquery/reservation/v1/reservation_services_pb.rb +7 -3
- data/lib/google/cloud/bigquery/reservation/v1/version.rb +1 -1
- data/lib/google/cloud/bigquery/reservation/v1.rb +2 -0
- data/proto_docs/google/cloud/bigquery/reservation/v1/reservation.rb +78 -11
- metadata +3 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 47f112fc54de3426c4879a03e51d7dbea54814f3169a16cb18815b14c276cc0a
|
4
|
+
data.tar.gz: 4c85cce74d96c2b59996a4012a6326fc9cc665e166c9eb2c31359a066fd98397
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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://
|
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.
|
253
|
-
# characters or
|
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
|
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
|
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
|
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
|
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
|
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
|
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.
|
@@ -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
|
39
|
-
# if total slot capacity of the new reservation and its siblings exceeds
|
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
|
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
|
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
|
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.
|
158
|
-
# characters or
|
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
|
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
|
-
#
|
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
|
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
|
+
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-
|
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.
|
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
|