google-cloud-bigquery-reservation-v1 0.9.0 → 0.11.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/AUTHENTICATION.md +72 -101
- data/lib/google/cloud/bigquery/reservation/v1/reservation_service/client.rb +41 -9
- data/lib/google/cloud/bigquery/reservation/v1/reservation_service/rest/client.rb +389 -7
- data/lib/google/cloud/bigquery/reservation/v1/reservation_service/rest/service_stub.rb +14 -2
- data/lib/google/cloud/bigquery/reservation/v1/version.rb +1 -1
- data/proto_docs/google/api/client.rb +14 -0
- data/proto_docs/google/api/field_behavior.rb +14 -0
- metadata +5 -5
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 8c02bec02e7a5ee015cf094c52420a7abe3e451bf90eff8f6457708e73dcca1b
|
|
4
|
+
data.tar.gz: 0fdfb6273c93ccc2cabadad4703555539b5a708268d5f58bc041fc2d667853bf
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 167b76e95b90182da58c4a3165abc97db9edb2db9c7e77784a9f72e5752b031ea1274a170391db69e5a139d92eab57c69ce4e7fe551faa6dc5f7cb0798ada010
|
|
7
|
+
data.tar.gz: cb56f5ce1fa76f28121b0bd7ff1d29ec2a956c450173ee66d4d434bb959fdf5c271ddf0b148c232da705ca17d6df3c79715c9ad38c7efb0e2bfbe24cfc2b441d
|
data/AUTHENTICATION.md
CHANGED
|
@@ -1,151 +1,122 @@
|
|
|
1
1
|
# Authentication
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
[
|
|
5
|
-
|
|
6
|
-
[Google Cloud Platform environments](#google-cloud-platform-environments) the
|
|
7
|
-
credentials will be discovered automatically. When running on other
|
|
8
|
-
environments, the Service Account credentials can be specified by providing the
|
|
9
|
-
path to the
|
|
10
|
-
[JSON keyfile](https://cloud.google.com/iam/docs/managing-service-account-keys)
|
|
11
|
-
for the account (or the JSON itself) in
|
|
12
|
-
[environment variables](#environment-variables). Additionally, Cloud SDK
|
|
13
|
-
credentials can also be discovered automatically, but this is only recommended
|
|
14
|
-
during development.
|
|
3
|
+
The recommended way to authenticate to the google-cloud-bigquery-reservation-v1 library is to use
|
|
4
|
+
[Application Default Credentials (ADC)](https://cloud.google.com/docs/authentication/application-default-credentials).
|
|
5
|
+
To review all of your authentication options, see [Credentials lookup](#credential-lookup).
|
|
15
6
|
|
|
16
7
|
## Quickstart
|
|
17
8
|
|
|
18
|
-
|
|
19
|
-
|
|
9
|
+
The following example shows how to set up authentication for a local development
|
|
10
|
+
environment with your user credentials.
|
|
20
11
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
3. Initialize the client.
|
|
12
|
+
**NOTE:** This method is _not_ recommended for running in production. User credentials
|
|
13
|
+
should be used only during development.
|
|
26
14
|
|
|
27
|
-
|
|
28
|
-
|
|
15
|
+
1. [Download and install the Google Cloud CLI](https://cloud.google.com/sdk).
|
|
16
|
+
2. Set up a local ADC file with your user credentials:
|
|
29
17
|
|
|
30
|
-
|
|
18
|
+
```sh
|
|
19
|
+
gcloud auth application-default login
|
|
31
20
|
```
|
|
32
21
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
The google-cloud-bigquery-reservation-v1 library aims to make authentication
|
|
36
|
-
as simple as possible, and provides several mechanisms to configure your system
|
|
37
|
-
without requiring **Service Account Credentials** directly in code.
|
|
38
|
-
|
|
39
|
-
**Credentials** are discovered in the following order:
|
|
40
|
-
|
|
41
|
-
1. Specify credentials in method arguments
|
|
42
|
-
2. Specify credentials in configuration
|
|
43
|
-
3. Discover credentials path in environment variables
|
|
44
|
-
4. Discover credentials JSON in environment variables
|
|
45
|
-
5. Discover credentials file in the Cloud SDK's path
|
|
46
|
-
6. Discover GCP credentials
|
|
47
|
-
|
|
48
|
-
### Google Cloud Platform environments
|
|
22
|
+
3. Write code as if already authenticated.
|
|
49
23
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
Functions (GCF) and Cloud Run, **Credentials** are discovered automatically.
|
|
53
|
-
Code should be written as if already authenticated.
|
|
24
|
+
For more information about setting up authentication for a local development environment, see
|
|
25
|
+
[Set up Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-dev).
|
|
54
26
|
|
|
55
|
-
|
|
27
|
+
## Credential Lookup
|
|
56
28
|
|
|
57
|
-
The
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
**Credentials JSON** file can be stored in the environment variable, or the
|
|
62
|
-
**Credentials JSON** itself can be stored for environments such as Docker
|
|
63
|
-
containers where writing files is difficult or not encouraged.
|
|
29
|
+
The google-cloud-bigquery-reservation-v1 library provides several mechanisms to configure your system.
|
|
30
|
+
Generally, using Application Default Credentials to facilitate automatic
|
|
31
|
+
credentials discovery is the easist method. But if you need to explicitly specify
|
|
32
|
+
credentials, there are several methods available to you.
|
|
64
33
|
|
|
65
|
-
|
|
66
|
-
checks for credentials are configured on the service Credentials class (such as
|
|
67
|
-
{::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Credentials}):
|
|
34
|
+
Credentials are accepted in the following ways, in the following order or precedence:
|
|
68
35
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
36
|
+
1. Credentials specified in method arguments
|
|
37
|
+
2. Credentials specified in configuration
|
|
38
|
+
3. Credentials pointed to or included in environment variables
|
|
39
|
+
4. Credentials found in local ADC file
|
|
40
|
+
5. Credentials returned by the metadata server for the attached service account (GCP)
|
|
74
41
|
|
|
75
|
-
|
|
76
|
-
require "google/cloud/bigquery/reservation/v1"
|
|
77
|
-
|
|
78
|
-
ENV["BIGQUERY_RESERVATION_CREDENTIALS"] = "path/to/keyfile.json"
|
|
42
|
+
### Configuration
|
|
79
43
|
|
|
80
|
-
client
|
|
81
|
-
|
|
44
|
+
You can configure a path to a JSON credentials file, either for an individual client object or
|
|
45
|
+
globally, for all client objects. The JSON file can contain credentials created for
|
|
46
|
+
[workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
|
|
47
|
+
[workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
|
|
48
|
+
[service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
|
|
82
49
|
|
|
83
|
-
|
|
50
|
+
Note: Service account keys are a security risk if not managed correctly. You should
|
|
51
|
+
[choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
|
|
52
|
+
whenever possible.
|
|
84
53
|
|
|
85
|
-
|
|
86
|
-
it in an environment variable. Either on an individual client initialization:
|
|
54
|
+
To configure a credentials file for an individual client initialization:
|
|
87
55
|
|
|
88
56
|
```ruby
|
|
89
57
|
require "google/cloud/bigquery/reservation/v1"
|
|
90
58
|
|
|
91
59
|
client = ::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new do |config|
|
|
92
|
-
config.credentials = "path/to/
|
|
60
|
+
config.credentials = "path/to/credentialfile.json"
|
|
93
61
|
end
|
|
94
62
|
```
|
|
95
63
|
|
|
96
|
-
|
|
64
|
+
To configure a credentials file globally for all clients:
|
|
97
65
|
|
|
98
66
|
```ruby
|
|
99
67
|
require "google/cloud/bigquery/reservation/v1"
|
|
100
68
|
|
|
101
69
|
::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.configure do |config|
|
|
102
|
-
config.credentials = "path/to/
|
|
70
|
+
config.credentials = "path/to/credentialfile.json"
|
|
103
71
|
end
|
|
104
72
|
|
|
105
73
|
client = ::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
|
|
106
74
|
```
|
|
107
75
|
|
|
108
|
-
###
|
|
76
|
+
### Environment Variables
|
|
109
77
|
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
78
|
+
You can also use an environment variable to provide a JSON credentials file.
|
|
79
|
+
The environment variable can contain a path to the credentials file or, for
|
|
80
|
+
environments such as Docker containers where writing files is not encouraged,
|
|
81
|
+
you can include the credentials file itself.
|
|
113
82
|
|
|
114
|
-
|
|
83
|
+
The JSON file can contain credentials created for
|
|
84
|
+
[workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
|
|
85
|
+
[workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
|
|
86
|
+
[service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
|
|
115
87
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
88
|
+
Note: Service account keys are a security risk if not managed correctly. You should
|
|
89
|
+
[choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
|
|
90
|
+
whenever possible.
|
|
91
|
+
|
|
92
|
+
The environment variables that google-cloud-bigquery-reservation-v1
|
|
93
|
+
checks for credentials are:
|
|
119
94
|
|
|
120
|
-
|
|
121
|
-
*
|
|
95
|
+
* `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
|
|
96
|
+
* `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
|
|
122
97
|
|
|
123
|
-
|
|
98
|
+
```ruby
|
|
99
|
+
require "google/cloud/bigquery/reservation/v1"
|
|
124
100
|
|
|
125
|
-
|
|
126
|
-
connect to the APIs. You will use the **JSON key file** to
|
|
127
|
-
connect to most services with google-cloud-bigquery-reservation-v1.
|
|
101
|
+
ENV["GOOGLE_APPLICATION_CREDENTIALS"] = "path/to/credentialfile.json"
|
|
128
102
|
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
need a Google Developers service account.
|
|
103
|
+
client = ::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
|
|
104
|
+
```
|
|
132
105
|
|
|
133
|
-
|
|
134
|
-
2. Create a new project or click on an existing project.
|
|
135
|
-
3. Activate the menu in the upper left and select **APIs & Services**. From
|
|
136
|
-
here, you will enable the APIs that your application requires.
|
|
106
|
+
### Local ADC file
|
|
137
107
|
|
|
138
|
-
|
|
108
|
+
You can set up a local ADC file with your user credentials for authentication during
|
|
109
|
+
development. If credentials are not provided in code or in environment variables,
|
|
110
|
+
then the local ADC credentials are discovered.
|
|
139
111
|
|
|
140
|
-
|
|
112
|
+
Follow the steps in [Quickstart](#quickstart) to set up a local ADC file.
|
|
141
113
|
|
|
142
|
-
|
|
143
|
-
"Service account" to be guided through downloading a new JSON key file.
|
|
114
|
+
### Google Cloud Platform environments
|
|
144
115
|
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
116
|
+
When running on Google Cloud Platform (GCP), including Google Compute Engine
|
|
117
|
+
(GCE), Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud
|
|
118
|
+
Functions (GCF) and Cloud Run, credentials are retrieved from the attached
|
|
119
|
+
service account automatically. Code should be written as if already authenticated.
|
|
149
120
|
|
|
150
|
-
|
|
151
|
-
|
|
121
|
+
For more information, see
|
|
122
|
+
[Set up ADC for Google Cloud services](https://cloud.google.com/docs/authentication/provide-credentials-adc#attached-sa).
|
|
@@ -45,6 +45,9 @@ module Google
|
|
|
45
45
|
# `projects/myproject/locations/US/capacityCommitments/id`.
|
|
46
46
|
#
|
|
47
47
|
class Client
|
|
48
|
+
# @private
|
|
49
|
+
DEFAULT_ENDPOINT_TEMPLATE = "bigqueryreservation.$UNIVERSE_DOMAIN$"
|
|
50
|
+
|
|
48
51
|
include Paths
|
|
49
52
|
|
|
50
53
|
# @private
|
|
@@ -173,6 +176,15 @@ module Google
|
|
|
173
176
|
@config
|
|
174
177
|
end
|
|
175
178
|
|
|
179
|
+
##
|
|
180
|
+
# The effective universe domain
|
|
181
|
+
#
|
|
182
|
+
# @return [String]
|
|
183
|
+
#
|
|
184
|
+
def universe_domain
|
|
185
|
+
@reservation_service_stub.universe_domain
|
|
186
|
+
end
|
|
187
|
+
|
|
176
188
|
##
|
|
177
189
|
# Create a new ReservationService client object.
|
|
178
190
|
#
|
|
@@ -206,8 +218,9 @@ module Google
|
|
|
206
218
|
credentials = @config.credentials
|
|
207
219
|
# Use self-signed JWT if the endpoint is unchanged from default,
|
|
208
220
|
# but only if the default endpoint does not have a region prefix.
|
|
209
|
-
enable_self_signed_jwt = @config.endpoint
|
|
210
|
-
|
|
221
|
+
enable_self_signed_jwt = @config.endpoint.nil? ||
|
|
222
|
+
(@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
|
|
223
|
+
!@config.endpoint.split(".").first.include?("-"))
|
|
211
224
|
credentials ||= Credentials.default scope: @config.scope,
|
|
212
225
|
enable_self_signed_jwt: enable_self_signed_jwt
|
|
213
226
|
if credentials.is_a?(::String) || credentials.is_a?(::Hash)
|
|
@@ -218,10 +231,13 @@ module Google
|
|
|
218
231
|
|
|
219
232
|
@reservation_service_stub = ::Gapic::ServiceStub.new(
|
|
220
233
|
::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Stub,
|
|
221
|
-
credentials:
|
|
222
|
-
endpoint:
|
|
234
|
+
credentials: credentials,
|
|
235
|
+
endpoint: @config.endpoint,
|
|
236
|
+
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
|
237
|
+
universe_domain: @config.universe_domain,
|
|
223
238
|
channel_args: @config.channel_args,
|
|
224
|
-
interceptors: @config.interceptors
|
|
239
|
+
interceptors: @config.interceptors,
|
|
240
|
+
channel_pool_config: @config.channel_pool
|
|
225
241
|
)
|
|
226
242
|
end
|
|
227
243
|
|
|
@@ -2328,9 +2344,9 @@ module Google
|
|
|
2328
2344
|
# end
|
|
2329
2345
|
#
|
|
2330
2346
|
# @!attribute [rw] endpoint
|
|
2331
|
-
#
|
|
2332
|
-
#
|
|
2333
|
-
# @return [::String]
|
|
2347
|
+
# A custom service endpoint, as a hostname or hostname:port. The default is
|
|
2348
|
+
# nil, indicating to use the default endpoint in the current universe domain.
|
|
2349
|
+
# @return [::String,nil]
|
|
2334
2350
|
# @!attribute [rw] credentials
|
|
2335
2351
|
# Credentials to send with calls. You may provide any of the following types:
|
|
2336
2352
|
# * (`String`) The path to a service account key file in JSON format
|
|
@@ -2376,13 +2392,20 @@ module Google
|
|
|
2376
2392
|
# @!attribute [rw] quota_project
|
|
2377
2393
|
# A separate project against which to charge quota.
|
|
2378
2394
|
# @return [::String]
|
|
2395
|
+
# @!attribute [rw] universe_domain
|
|
2396
|
+
# The universe domain within which to make requests. This determines the
|
|
2397
|
+
# default endpoint URL. The default value of nil uses the environment
|
|
2398
|
+
# universe (usually the default "googleapis.com" universe).
|
|
2399
|
+
# @return [::String,nil]
|
|
2379
2400
|
#
|
|
2380
2401
|
class Configuration
|
|
2381
2402
|
extend ::Gapic::Config
|
|
2382
2403
|
|
|
2404
|
+
# @private
|
|
2405
|
+
# The endpoint specific to the default "googleapis.com" universe. Deprecated.
|
|
2383
2406
|
DEFAULT_ENDPOINT = "bigqueryreservation.googleapis.com"
|
|
2384
2407
|
|
|
2385
|
-
config_attr :endpoint,
|
|
2408
|
+
config_attr :endpoint, nil, ::String, nil
|
|
2386
2409
|
config_attr :credentials, nil do |value|
|
|
2387
2410
|
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
|
2388
2411
|
allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
|
|
@@ -2397,6 +2420,7 @@ module Google
|
|
|
2397
2420
|
config_attr :metadata, nil, ::Hash, nil
|
|
2398
2421
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
|
2399
2422
|
config_attr :quota_project, nil, ::String, nil
|
|
2423
|
+
config_attr :universe_domain, nil, ::String, nil
|
|
2400
2424
|
|
|
2401
2425
|
# @private
|
|
2402
2426
|
def initialize parent_config = nil
|
|
@@ -2417,6 +2441,14 @@ module Google
|
|
|
2417
2441
|
end
|
|
2418
2442
|
end
|
|
2419
2443
|
|
|
2444
|
+
##
|
|
2445
|
+
# Configuration for the channel pool
|
|
2446
|
+
# @return [::Gapic::ServiceStub::ChannelPool::Configuration]
|
|
2447
|
+
#
|
|
2448
|
+
def channel_pool
|
|
2449
|
+
@channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
|
|
2450
|
+
end
|
|
2451
|
+
|
|
2420
2452
|
##
|
|
2421
2453
|
# Configuration RPC class for the ReservationService API.
|
|
2422
2454
|
#
|
|
@@ -47,6 +47,9 @@ module Google
|
|
|
47
47
|
# `projects/myproject/locations/US/capacityCommitments/id`.
|
|
48
48
|
#
|
|
49
49
|
class Client
|
|
50
|
+
# @private
|
|
51
|
+
DEFAULT_ENDPOINT_TEMPLATE = "bigqueryreservation.$UNIVERSE_DOMAIN$"
|
|
52
|
+
|
|
50
53
|
include Paths
|
|
51
54
|
|
|
52
55
|
# @private
|
|
@@ -175,6 +178,15 @@ module Google
|
|
|
175
178
|
@config
|
|
176
179
|
end
|
|
177
180
|
|
|
181
|
+
##
|
|
182
|
+
# The effective universe domain
|
|
183
|
+
#
|
|
184
|
+
# @return [String]
|
|
185
|
+
#
|
|
186
|
+
def universe_domain
|
|
187
|
+
@reservation_service_stub.universe_domain
|
|
188
|
+
end
|
|
189
|
+
|
|
178
190
|
##
|
|
179
191
|
# Create a new ReservationService REST client object.
|
|
180
192
|
#
|
|
@@ -202,8 +214,9 @@ module Google
|
|
|
202
214
|
credentials = @config.credentials
|
|
203
215
|
# Use self-signed JWT if the endpoint is unchanged from default,
|
|
204
216
|
# but only if the default endpoint does not have a region prefix.
|
|
205
|
-
enable_self_signed_jwt = @config.endpoint
|
|
206
|
-
|
|
217
|
+
enable_self_signed_jwt = @config.endpoint.nil? ||
|
|
218
|
+
(@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
|
|
219
|
+
!@config.endpoint.split(".").first.include?("-"))
|
|
207
220
|
credentials ||= Credentials.default scope: @config.scope,
|
|
208
221
|
enable_self_signed_jwt: enable_self_signed_jwt
|
|
209
222
|
if credentials.is_a?(::String) || credentials.is_a?(::Hash)
|
|
@@ -213,7 +226,12 @@ module Google
|
|
|
213
226
|
@quota_project_id = @config.quota_project
|
|
214
227
|
@quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
|
|
215
228
|
|
|
216
|
-
@reservation_service_stub = ::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::ServiceStub.new
|
|
229
|
+
@reservation_service_stub = ::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::ServiceStub.new(
|
|
230
|
+
endpoint: @config.endpoint,
|
|
231
|
+
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
|
232
|
+
universe_domain: @config.universe_domain,
|
|
233
|
+
credentials: credentials
|
|
234
|
+
)
|
|
217
235
|
end
|
|
218
236
|
|
|
219
237
|
# Service calls
|
|
@@ -252,6 +270,22 @@ module Google
|
|
|
252
270
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::Reservation]
|
|
253
271
|
#
|
|
254
272
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
273
|
+
#
|
|
274
|
+
# @example Basic example
|
|
275
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
276
|
+
#
|
|
277
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
278
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
279
|
+
#
|
|
280
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
281
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::CreateReservationRequest.new
|
|
282
|
+
#
|
|
283
|
+
# # Call the create_reservation method.
|
|
284
|
+
# result = client.create_reservation request
|
|
285
|
+
#
|
|
286
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Reservation.
|
|
287
|
+
# p result
|
|
288
|
+
#
|
|
255
289
|
def create_reservation request, options = nil
|
|
256
290
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
257
291
|
|
|
@@ -319,6 +353,26 @@ module Google
|
|
|
319
353
|
# @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Bigquery::Reservation::V1::Reservation>]
|
|
320
354
|
#
|
|
321
355
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
356
|
+
#
|
|
357
|
+
# @example Basic example
|
|
358
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
359
|
+
#
|
|
360
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
361
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
362
|
+
#
|
|
363
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
364
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::ListReservationsRequest.new
|
|
365
|
+
#
|
|
366
|
+
# # Call the list_reservations method.
|
|
367
|
+
# result = client.list_reservations request
|
|
368
|
+
#
|
|
369
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can iterate
|
|
370
|
+
# # over elements, and API calls will be issued to fetch pages as needed.
|
|
371
|
+
# result.each do |item|
|
|
372
|
+
# # Each element is of type ::Google::Cloud::Bigquery::Reservation::V1::Reservation.
|
|
373
|
+
# p item
|
|
374
|
+
# end
|
|
375
|
+
#
|
|
322
376
|
def list_reservations request, options = nil
|
|
323
377
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
324
378
|
|
|
@@ -383,6 +437,22 @@ module Google
|
|
|
383
437
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::Reservation]
|
|
384
438
|
#
|
|
385
439
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
440
|
+
#
|
|
441
|
+
# @example Basic example
|
|
442
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
443
|
+
#
|
|
444
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
445
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
446
|
+
#
|
|
447
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
448
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::GetReservationRequest.new
|
|
449
|
+
#
|
|
450
|
+
# # Call the get_reservation method.
|
|
451
|
+
# result = client.get_reservation request
|
|
452
|
+
#
|
|
453
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Reservation.
|
|
454
|
+
# p result
|
|
455
|
+
#
|
|
386
456
|
def get_reservation request, options = nil
|
|
387
457
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
388
458
|
|
|
@@ -448,6 +518,22 @@ module Google
|
|
|
448
518
|
# @return [::Google::Protobuf::Empty]
|
|
449
519
|
#
|
|
450
520
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
521
|
+
#
|
|
522
|
+
# @example Basic example
|
|
523
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
524
|
+
#
|
|
525
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
526
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
527
|
+
#
|
|
528
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
529
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::DeleteReservationRequest.new
|
|
530
|
+
#
|
|
531
|
+
# # Call the delete_reservation method.
|
|
532
|
+
# result = client.delete_reservation request
|
|
533
|
+
#
|
|
534
|
+
# # The returned object is of type Google::Protobuf::Empty.
|
|
535
|
+
# p result
|
|
536
|
+
#
|
|
451
537
|
def delete_reservation request, options = nil
|
|
452
538
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
453
539
|
|
|
@@ -512,6 +598,22 @@ module Google
|
|
|
512
598
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::Reservation]
|
|
513
599
|
#
|
|
514
600
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
601
|
+
#
|
|
602
|
+
# @example Basic example
|
|
603
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
604
|
+
#
|
|
605
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
606
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
607
|
+
#
|
|
608
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
609
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::UpdateReservationRequest.new
|
|
610
|
+
#
|
|
611
|
+
# # Call the update_reservation method.
|
|
612
|
+
# result = client.update_reservation request
|
|
613
|
+
#
|
|
614
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Reservation.
|
|
615
|
+
# p result
|
|
616
|
+
#
|
|
515
617
|
def update_reservation request, options = nil
|
|
516
618
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
517
619
|
|
|
@@ -586,6 +688,22 @@ module Google
|
|
|
586
688
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment]
|
|
587
689
|
#
|
|
588
690
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
691
|
+
#
|
|
692
|
+
# @example Basic example
|
|
693
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
694
|
+
#
|
|
695
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
696
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
697
|
+
#
|
|
698
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
699
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::CreateCapacityCommitmentRequest.new
|
|
700
|
+
#
|
|
701
|
+
# # Call the create_capacity_commitment method.
|
|
702
|
+
# result = client.create_capacity_commitment request
|
|
703
|
+
#
|
|
704
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.
|
|
705
|
+
# p result
|
|
706
|
+
#
|
|
589
707
|
def create_capacity_commitment request, options = nil
|
|
590
708
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
591
709
|
|
|
@@ -653,6 +771,26 @@ module Google
|
|
|
653
771
|
# @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment>]
|
|
654
772
|
#
|
|
655
773
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
774
|
+
#
|
|
775
|
+
# @example Basic example
|
|
776
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
777
|
+
#
|
|
778
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
779
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
780
|
+
#
|
|
781
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
782
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::ListCapacityCommitmentsRequest.new
|
|
783
|
+
#
|
|
784
|
+
# # Call the list_capacity_commitments method.
|
|
785
|
+
# result = client.list_capacity_commitments request
|
|
786
|
+
#
|
|
787
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can iterate
|
|
788
|
+
# # over elements, and API calls will be issued to fetch pages as needed.
|
|
789
|
+
# result.each do |item|
|
|
790
|
+
# # Each element is of type ::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.
|
|
791
|
+
# p item
|
|
792
|
+
# end
|
|
793
|
+
#
|
|
656
794
|
def list_capacity_commitments request, options = nil
|
|
657
795
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
658
796
|
|
|
@@ -717,6 +855,22 @@ module Google
|
|
|
717
855
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment]
|
|
718
856
|
#
|
|
719
857
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
858
|
+
#
|
|
859
|
+
# @example Basic example
|
|
860
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
861
|
+
#
|
|
862
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
863
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
864
|
+
#
|
|
865
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
866
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::GetCapacityCommitmentRequest.new
|
|
867
|
+
#
|
|
868
|
+
# # Call the get_capacity_commitment method.
|
|
869
|
+
# result = client.get_capacity_commitment request
|
|
870
|
+
#
|
|
871
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.
|
|
872
|
+
# p result
|
|
873
|
+
#
|
|
720
874
|
def get_capacity_commitment request, options = nil
|
|
721
875
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
722
876
|
|
|
@@ -786,6 +940,22 @@ module Google
|
|
|
786
940
|
# @return [::Google::Protobuf::Empty]
|
|
787
941
|
#
|
|
788
942
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
943
|
+
#
|
|
944
|
+
# @example Basic example
|
|
945
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
946
|
+
#
|
|
947
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
948
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
949
|
+
#
|
|
950
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
951
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::DeleteCapacityCommitmentRequest.new
|
|
952
|
+
#
|
|
953
|
+
# # Call the delete_capacity_commitment method.
|
|
954
|
+
# result = client.delete_capacity_commitment request
|
|
955
|
+
#
|
|
956
|
+
# # The returned object is of type Google::Protobuf::Empty.
|
|
957
|
+
# p result
|
|
958
|
+
#
|
|
789
959
|
def delete_capacity_commitment request, options = nil
|
|
790
960
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
791
961
|
|
|
@@ -856,6 +1026,22 @@ module Google
|
|
|
856
1026
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment]
|
|
857
1027
|
#
|
|
858
1028
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
1029
|
+
#
|
|
1030
|
+
# @example Basic example
|
|
1031
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
1032
|
+
#
|
|
1033
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
1034
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
1035
|
+
#
|
|
1036
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
1037
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::UpdateCapacityCommitmentRequest.new
|
|
1038
|
+
#
|
|
1039
|
+
# # Call the update_capacity_commitment method.
|
|
1040
|
+
# result = client.update_capacity_commitment request
|
|
1041
|
+
#
|
|
1042
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.
|
|
1043
|
+
# p result
|
|
1044
|
+
#
|
|
859
1045
|
def update_capacity_commitment request, options = nil
|
|
860
1046
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
861
1047
|
|
|
@@ -928,6 +1114,22 @@ module Google
|
|
|
928
1114
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::SplitCapacityCommitmentResponse]
|
|
929
1115
|
#
|
|
930
1116
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
1117
|
+
#
|
|
1118
|
+
# @example Basic example
|
|
1119
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
1120
|
+
#
|
|
1121
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
1122
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
1123
|
+
#
|
|
1124
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
1125
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::SplitCapacityCommitmentRequest.new
|
|
1126
|
+
#
|
|
1127
|
+
# # Call the split_capacity_commitment method.
|
|
1128
|
+
# result = client.split_capacity_commitment request
|
|
1129
|
+
#
|
|
1130
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::SplitCapacityCommitmentResponse.
|
|
1131
|
+
# p result
|
|
1132
|
+
#
|
|
931
1133
|
def split_capacity_commitment request, options = nil
|
|
932
1134
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
933
1135
|
|
|
@@ -1003,6 +1205,22 @@ module Google
|
|
|
1003
1205
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment]
|
|
1004
1206
|
#
|
|
1005
1207
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
1208
|
+
#
|
|
1209
|
+
# @example Basic example
|
|
1210
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
1211
|
+
#
|
|
1212
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
1213
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
1214
|
+
#
|
|
1215
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
1216
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::MergeCapacityCommitmentsRequest.new
|
|
1217
|
+
#
|
|
1218
|
+
# # Call the merge_capacity_commitments method.
|
|
1219
|
+
# result = client.merge_capacity_commitments request
|
|
1220
|
+
#
|
|
1221
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.
|
|
1222
|
+
# p result
|
|
1223
|
+
#
|
|
1006
1224
|
def merge_capacity_commitments request, options = nil
|
|
1007
1225
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
1008
1226
|
|
|
@@ -1107,6 +1325,22 @@ module Google
|
|
|
1107
1325
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::Assignment]
|
|
1108
1326
|
#
|
|
1109
1327
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
1328
|
+
#
|
|
1329
|
+
# @example Basic example
|
|
1330
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
1331
|
+
#
|
|
1332
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
1333
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
1334
|
+
#
|
|
1335
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
1336
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::CreateAssignmentRequest.new
|
|
1337
|
+
#
|
|
1338
|
+
# # Call the create_assignment method.
|
|
1339
|
+
# result = client.create_assignment request
|
|
1340
|
+
#
|
|
1341
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Assignment.
|
|
1342
|
+
# p result
|
|
1343
|
+
#
|
|
1110
1344
|
def create_assignment request, options = nil
|
|
1111
1345
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
1112
1346
|
|
|
@@ -1199,6 +1433,26 @@ module Google
|
|
|
1199
1433
|
# @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Bigquery::Reservation::V1::Assignment>]
|
|
1200
1434
|
#
|
|
1201
1435
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
1436
|
+
#
|
|
1437
|
+
# @example Basic example
|
|
1438
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
1439
|
+
#
|
|
1440
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
1441
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
1442
|
+
#
|
|
1443
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
1444
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::ListAssignmentsRequest.new
|
|
1445
|
+
#
|
|
1446
|
+
# # Call the list_assignments method.
|
|
1447
|
+
# result = client.list_assignments request
|
|
1448
|
+
#
|
|
1449
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can iterate
|
|
1450
|
+
# # over elements, and API calls will be issued to fetch pages as needed.
|
|
1451
|
+
# result.each do |item|
|
|
1452
|
+
# # Each element is of type ::Google::Cloud::Bigquery::Reservation::V1::Assignment.
|
|
1453
|
+
# p item
|
|
1454
|
+
# end
|
|
1455
|
+
#
|
|
1202
1456
|
def list_assignments request, options = nil
|
|
1203
1457
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
1204
1458
|
|
|
@@ -1277,6 +1531,22 @@ module Google
|
|
|
1277
1531
|
# @return [::Google::Protobuf::Empty]
|
|
1278
1532
|
#
|
|
1279
1533
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
1534
|
+
#
|
|
1535
|
+
# @example Basic example
|
|
1536
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
1537
|
+
#
|
|
1538
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
1539
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
1540
|
+
#
|
|
1541
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
1542
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::DeleteAssignmentRequest.new
|
|
1543
|
+
#
|
|
1544
|
+
# # Call the delete_assignment method.
|
|
1545
|
+
# result = client.delete_assignment request
|
|
1546
|
+
#
|
|
1547
|
+
# # The returned object is of type Google::Protobuf::Empty.
|
|
1548
|
+
# p result
|
|
1549
|
+
#
|
|
1280
1550
|
def delete_assignment request, options = nil
|
|
1281
1551
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
1282
1552
|
|
|
@@ -1375,6 +1645,26 @@ module Google
|
|
|
1375
1645
|
# @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Bigquery::Reservation::V1::Assignment>]
|
|
1376
1646
|
#
|
|
1377
1647
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
1648
|
+
#
|
|
1649
|
+
# @example Basic example
|
|
1650
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
1651
|
+
#
|
|
1652
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
1653
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
1654
|
+
#
|
|
1655
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
1656
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::SearchAssignmentsRequest.new
|
|
1657
|
+
#
|
|
1658
|
+
# # Call the search_assignments method.
|
|
1659
|
+
# result = client.search_assignments request
|
|
1660
|
+
#
|
|
1661
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can iterate
|
|
1662
|
+
# # over elements, and API calls will be issued to fetch pages as needed.
|
|
1663
|
+
# result.each do |item|
|
|
1664
|
+
# # Each element is of type ::Google::Cloud::Bigquery::Reservation::V1::Assignment.
|
|
1665
|
+
# p item
|
|
1666
|
+
# end
|
|
1667
|
+
#
|
|
1378
1668
|
def search_assignments request, options = nil
|
|
1379
1669
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
1380
1670
|
|
|
@@ -1471,6 +1761,26 @@ module Google
|
|
|
1471
1761
|
# @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Bigquery::Reservation::V1::Assignment>]
|
|
1472
1762
|
#
|
|
1473
1763
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
1764
|
+
#
|
|
1765
|
+
# @example Basic example
|
|
1766
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
1767
|
+
#
|
|
1768
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
1769
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
1770
|
+
#
|
|
1771
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
1772
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::SearchAllAssignmentsRequest.new
|
|
1773
|
+
#
|
|
1774
|
+
# # Call the search_all_assignments method.
|
|
1775
|
+
# result = client.search_all_assignments request
|
|
1776
|
+
#
|
|
1777
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can iterate
|
|
1778
|
+
# # over elements, and API calls will be issued to fetch pages as needed.
|
|
1779
|
+
# result.each do |item|
|
|
1780
|
+
# # Each element is of type ::Google::Cloud::Bigquery::Reservation::V1::Assignment.
|
|
1781
|
+
# p item
|
|
1782
|
+
# end
|
|
1783
|
+
#
|
|
1474
1784
|
def search_all_assignments request, options = nil
|
|
1475
1785
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
1476
1786
|
|
|
@@ -1549,6 +1859,22 @@ module Google
|
|
|
1549
1859
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::Assignment]
|
|
1550
1860
|
#
|
|
1551
1861
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
1862
|
+
#
|
|
1863
|
+
# @example Basic example
|
|
1864
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
1865
|
+
#
|
|
1866
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
1867
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
1868
|
+
#
|
|
1869
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
1870
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::MoveAssignmentRequest.new
|
|
1871
|
+
#
|
|
1872
|
+
# # Call the move_assignment method.
|
|
1873
|
+
# result = client.move_assignment request
|
|
1874
|
+
#
|
|
1875
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Assignment.
|
|
1876
|
+
# p result
|
|
1877
|
+
#
|
|
1552
1878
|
def move_assignment request, options = nil
|
|
1553
1879
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
1554
1880
|
|
|
@@ -1615,6 +1941,22 @@ module Google
|
|
|
1615
1941
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::Assignment]
|
|
1616
1942
|
#
|
|
1617
1943
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
1944
|
+
#
|
|
1945
|
+
# @example Basic example
|
|
1946
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
1947
|
+
#
|
|
1948
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
1949
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
1950
|
+
#
|
|
1951
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
1952
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::UpdateAssignmentRequest.new
|
|
1953
|
+
#
|
|
1954
|
+
# # Call the update_assignment method.
|
|
1955
|
+
# result = client.update_assignment request
|
|
1956
|
+
#
|
|
1957
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Assignment.
|
|
1958
|
+
# p result
|
|
1959
|
+
#
|
|
1618
1960
|
def update_assignment request, options = nil
|
|
1619
1961
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
1620
1962
|
|
|
@@ -1678,6 +2020,22 @@ module Google
|
|
|
1678
2020
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::BiReservation]
|
|
1679
2021
|
#
|
|
1680
2022
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
2023
|
+
#
|
|
2024
|
+
# @example Basic example
|
|
2025
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
2026
|
+
#
|
|
2027
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
2028
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
2029
|
+
#
|
|
2030
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
2031
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::GetBiReservationRequest.new
|
|
2032
|
+
#
|
|
2033
|
+
# # Call the get_bi_reservation method.
|
|
2034
|
+
# result = client.get_bi_reservation request
|
|
2035
|
+
#
|
|
2036
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::BiReservation.
|
|
2037
|
+
# p result
|
|
2038
|
+
#
|
|
1681
2039
|
def get_bi_reservation request, options = nil
|
|
1682
2040
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
1683
2041
|
|
|
@@ -1749,6 +2107,22 @@ module Google
|
|
|
1749
2107
|
# @return [::Google::Cloud::Bigquery::Reservation::V1::BiReservation]
|
|
1750
2108
|
#
|
|
1751
2109
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
2110
|
+
#
|
|
2111
|
+
# @example Basic example
|
|
2112
|
+
# require "google/cloud/bigquery/reservation/v1"
|
|
2113
|
+
#
|
|
2114
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
2115
|
+
# client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new
|
|
2116
|
+
#
|
|
2117
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
2118
|
+
# request = Google::Cloud::Bigquery::Reservation::V1::UpdateBiReservationRequest.new
|
|
2119
|
+
#
|
|
2120
|
+
# # Call the update_bi_reservation method.
|
|
2121
|
+
# result = client.update_bi_reservation request
|
|
2122
|
+
#
|
|
2123
|
+
# # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::BiReservation.
|
|
2124
|
+
# p result
|
|
2125
|
+
#
|
|
1752
2126
|
def update_bi_reservation request, options = nil
|
|
1753
2127
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
1754
2128
|
|
|
@@ -1814,9 +2188,9 @@ module Google
|
|
|
1814
2188
|
# end
|
|
1815
2189
|
#
|
|
1816
2190
|
# @!attribute [rw] endpoint
|
|
1817
|
-
#
|
|
1818
|
-
#
|
|
1819
|
-
# @return [::String]
|
|
2191
|
+
# A custom service endpoint, as a hostname or hostname:port. The default is
|
|
2192
|
+
# nil, indicating to use the default endpoint in the current universe domain.
|
|
2193
|
+
# @return [::String,nil]
|
|
1820
2194
|
# @!attribute [rw] credentials
|
|
1821
2195
|
# Credentials to send with calls. You may provide any of the following types:
|
|
1822
2196
|
# * (`String`) The path to a service account key file in JSON format
|
|
@@ -1853,13 +2227,20 @@ module Google
|
|
|
1853
2227
|
# @!attribute [rw] quota_project
|
|
1854
2228
|
# A separate project against which to charge quota.
|
|
1855
2229
|
# @return [::String]
|
|
2230
|
+
# @!attribute [rw] universe_domain
|
|
2231
|
+
# The universe domain within which to make requests. This determines the
|
|
2232
|
+
# default endpoint URL. The default value of nil uses the environment
|
|
2233
|
+
# universe (usually the default "googleapis.com" universe).
|
|
2234
|
+
# @return [::String,nil]
|
|
1856
2235
|
#
|
|
1857
2236
|
class Configuration
|
|
1858
2237
|
extend ::Gapic::Config
|
|
1859
2238
|
|
|
2239
|
+
# @private
|
|
2240
|
+
# The endpoint specific to the default "googleapis.com" universe. Deprecated.
|
|
1860
2241
|
DEFAULT_ENDPOINT = "bigqueryreservation.googleapis.com"
|
|
1861
2242
|
|
|
1862
|
-
config_attr :endpoint,
|
|
2243
|
+
config_attr :endpoint, nil, ::String, nil
|
|
1863
2244
|
config_attr :credentials, nil do |value|
|
|
1864
2245
|
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
|
1865
2246
|
allowed.any? { |klass| klass === value }
|
|
@@ -1871,6 +2252,7 @@ module Google
|
|
|
1871
2252
|
config_attr :metadata, nil, ::Hash, nil
|
|
1872
2253
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
|
1873
2254
|
config_attr :quota_project, nil, ::String, nil
|
|
2255
|
+
config_attr :universe_domain, nil, ::String, nil
|
|
1874
2256
|
|
|
1875
2257
|
# @private
|
|
1876
2258
|
def initialize parent_config = nil
|
|
@@ -31,16 +31,28 @@ module Google
|
|
|
31
31
|
# including transcoding, making the REST call, and deserialing the response.
|
|
32
32
|
#
|
|
33
33
|
class ServiceStub
|
|
34
|
-
def initialize endpoint:, credentials:
|
|
34
|
+
def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
|
|
35
35
|
# These require statements are intentionally placed here to initialize
|
|
36
36
|
# the REST modules only when it's required.
|
|
37
37
|
require "gapic/rest"
|
|
38
38
|
|
|
39
|
-
@client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
|
|
39
|
+
@client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
|
|
40
|
+
endpoint_template: endpoint_template,
|
|
41
|
+
universe_domain: universe_domain,
|
|
42
|
+
credentials: credentials,
|
|
40
43
|
numeric_enums: true,
|
|
41
44
|
raise_faraday_errors: false
|
|
42
45
|
end
|
|
43
46
|
|
|
47
|
+
##
|
|
48
|
+
# The effective universe domain
|
|
49
|
+
#
|
|
50
|
+
# @return [String]
|
|
51
|
+
#
|
|
52
|
+
def universe_domain
|
|
53
|
+
@client_stub.universe_domain
|
|
54
|
+
end
|
|
55
|
+
|
|
44
56
|
##
|
|
45
57
|
# Baseline implementation for the create_reservation REST call
|
|
46
58
|
#
|
|
@@ -21,6 +21,7 @@ module Google
|
|
|
21
21
|
module Api
|
|
22
22
|
# Required information for every language.
|
|
23
23
|
# @!attribute [rw] reference_docs_uri
|
|
24
|
+
# @deprecated This field is deprecated and may be removed in the next major version update.
|
|
24
25
|
# @return [::String]
|
|
25
26
|
# Link to automatically generated reference documentation. Example:
|
|
26
27
|
# https://cloud.google.com/nodejs/docs/reference/asset/latest
|
|
@@ -304,6 +305,19 @@ module Google
|
|
|
304
305
|
# seconds: 360 # 6 minutes
|
|
305
306
|
# total_poll_timeout:
|
|
306
307
|
# seconds: 54000 # 90 minutes
|
|
308
|
+
# @!attribute [rw] auto_populated_fields
|
|
309
|
+
# @return [::Array<::String>]
|
|
310
|
+
# List of top-level fields of the request message, that should be
|
|
311
|
+
# automatically populated by the client libraries based on their
|
|
312
|
+
# (google.api.field_info).format. Currently supported format: UUID4.
|
|
313
|
+
#
|
|
314
|
+
# Example of a YAML configuration:
|
|
315
|
+
#
|
|
316
|
+
# publishing:
|
|
317
|
+
# method_settings:
|
|
318
|
+
# - selector: google.example.v1.ExampleService.CreateExample
|
|
319
|
+
# auto_populated_fields:
|
|
320
|
+
# - request_id
|
|
307
321
|
class MethodSettings
|
|
308
322
|
include ::Google::Protobuf::MessageExts
|
|
309
323
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
@@ -66,6 +66,20 @@ module Google
|
|
|
66
66
|
# a non-empty value will be returned. The user will not be aware of what
|
|
67
67
|
# non-empty value to expect.
|
|
68
68
|
NON_EMPTY_DEFAULT = 7
|
|
69
|
+
|
|
70
|
+
# Denotes that the field in a resource (a message annotated with
|
|
71
|
+
# google.api.resource) is used in the resource name to uniquely identify the
|
|
72
|
+
# resource. For AIP-compliant APIs, this should only be applied to the
|
|
73
|
+
# `name` field on the resource.
|
|
74
|
+
#
|
|
75
|
+
# This behavior should not be applied to references to other resources within
|
|
76
|
+
# the message.
|
|
77
|
+
#
|
|
78
|
+
# The identifier field of resources often have different field behavior
|
|
79
|
+
# depending on the request it is embedded in (e.g. for Create methods name
|
|
80
|
+
# is optional and unused, while for Update methods it is required). Instead
|
|
81
|
+
# of method-specific annotations, only `IDENTIFIER` is required.
|
|
82
|
+
IDENTIFIER = 8
|
|
69
83
|
end
|
|
70
84
|
end
|
|
71
85
|
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.
|
|
4
|
+
version: 0.11.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:
|
|
11
|
+
date: 2024-01-11 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: gapic-common
|
|
@@ -16,7 +16,7 @@ dependencies:
|
|
|
16
16
|
requirements:
|
|
17
17
|
- - ">="
|
|
18
18
|
- !ruby/object:Gem::Version
|
|
19
|
-
version: 0.
|
|
19
|
+
version: 0.21.1
|
|
20
20
|
- - "<"
|
|
21
21
|
- !ruby/object:Gem::Version
|
|
22
22
|
version: 2.a
|
|
@@ -26,7 +26,7 @@ dependencies:
|
|
|
26
26
|
requirements:
|
|
27
27
|
- - ">="
|
|
28
28
|
- !ruby/object:Gem::Version
|
|
29
|
-
version: 0.
|
|
29
|
+
version: 0.21.1
|
|
30
30
|
- - "<"
|
|
31
31
|
- !ruby/object:Gem::Version
|
|
32
32
|
version: 2.a
|
|
@@ -214,7 +214,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
|
214
214
|
- !ruby/object:Gem::Version
|
|
215
215
|
version: '0'
|
|
216
216
|
requirements: []
|
|
217
|
-
rubygems_version: 3.
|
|
217
|
+
rubygems_version: 3.5.3
|
|
218
218
|
signing_key:
|
|
219
219
|
specification_version: 4
|
|
220
220
|
summary: A service to modify your BigQuery flat-rate reservations.
|