google-apis-config_v1 0.1.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.
@@ -0,0 +1,1349 @@
1
+ # Copyright 2020 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module ConfigV1
23
+ # Infrastructure Manager API
24
+ #
25
+ # Creates and manages Google Cloud Platform resources and infrastructure.
26
+ #
27
+ # @example
28
+ # require 'google/apis/config_v1'
29
+ #
30
+ # Config = Google::Apis::ConfigV1 # Alias the module
31
+ # service = Config::ConfigService.new
32
+ #
33
+ # @see https://cloud.google.com/infrastructure-manager/docs
34
+ class ConfigService < Google::Apis::Core::BaseService
35
+ DEFAULT_ENDPOINT_TEMPLATE = "https://config.$UNIVERSE_DOMAIN$/"
36
+
37
+ # @return [String]
38
+ # API key. Your API key identifies your project and provides you with API access,
39
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
40
+ attr_accessor :key
41
+
42
+ # @return [String]
43
+ # Available to use for quota purposes for server-side applications. Can be any
44
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
45
+ attr_accessor :quota_user
46
+
47
+ def initialize
48
+ super(DEFAULT_ENDPOINT_TEMPLATE, '',
49
+ client_name: 'google-apis-config_v1',
50
+ client_version: Google::Apis::ConfigV1::GEM_VERSION)
51
+ @batch_path = 'batch'
52
+ end
53
+
54
+ # Gets information about a location.
55
+ # @param [String] name
56
+ # Resource name for the location.
57
+ # @param [String] fields
58
+ # Selector specifying which fields to include in a partial response.
59
+ # @param [String] quota_user
60
+ # Available to use for quota purposes for server-side applications. Can be any
61
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
62
+ # @param [Google::Apis::RequestOptions] options
63
+ # Request-specific options
64
+ #
65
+ # @yield [result, err] Result & error if block supplied
66
+ # @yieldparam result [Google::Apis::ConfigV1::Location] parsed result object
67
+ # @yieldparam err [StandardError] error object if request failed
68
+ #
69
+ # @return [Google::Apis::ConfigV1::Location]
70
+ #
71
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
72
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
73
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
74
+ def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
75
+ command = make_simple_command(:get, 'v1/{+name}', options)
76
+ command.response_representation = Google::Apis::ConfigV1::Location::Representation
77
+ command.response_class = Google::Apis::ConfigV1::Location
78
+ command.params['name'] = name unless name.nil?
79
+ command.query['fields'] = fields unless fields.nil?
80
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
81
+ execute_or_queue_command(command, &block)
82
+ end
83
+
84
+ # Lists information about the supported locations for this service.
85
+ # @param [String] name
86
+ # The resource that owns the locations collection, if applicable.
87
+ # @param [String] filter
88
+ # A filter to narrow down results to a preferred subset. The filtering language
89
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
90
+ # in [AIP-160](https://google.aip.dev/160).
91
+ # @param [Fixnum] page_size
92
+ # The maximum number of results to return. If not set, the service selects a
93
+ # default.
94
+ # @param [String] page_token
95
+ # A page token received from the `next_page_token` field in the response. Send
96
+ # that page token to receive the subsequent page.
97
+ # @param [String] fields
98
+ # Selector specifying which fields to include in a partial response.
99
+ # @param [String] quota_user
100
+ # Available to use for quota purposes for server-side applications. Can be any
101
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
102
+ # @param [Google::Apis::RequestOptions] options
103
+ # Request-specific options
104
+ #
105
+ # @yield [result, err] Result & error if block supplied
106
+ # @yieldparam result [Google::Apis::ConfigV1::ListLocationsResponse] parsed result object
107
+ # @yieldparam err [StandardError] error object if request failed
108
+ #
109
+ # @return [Google::Apis::ConfigV1::ListLocationsResponse]
110
+ #
111
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
112
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
113
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
114
+ def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
115
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
116
+ command.response_representation = Google::Apis::ConfigV1::ListLocationsResponse::Representation
117
+ command.response_class = Google::Apis::ConfigV1::ListLocationsResponse
118
+ command.params['name'] = name unless name.nil?
119
+ command.query['filter'] = filter unless filter.nil?
120
+ command.query['pageSize'] = page_size unless page_size.nil?
121
+ command.query['pageToken'] = page_token unless page_token.nil?
122
+ command.query['fields'] = fields unless fields.nil?
123
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
124
+ execute_or_queue_command(command, &block)
125
+ end
126
+
127
+ # Creates a Deployment.
128
+ # @param [String] parent
129
+ # Required. The parent in whose context the Deployment is created. The parent
130
+ # value is in the format: 'projects/`project_id`/locations/`location`'.
131
+ # @param [Google::Apis::ConfigV1::Deployment] deployment_object
132
+ # @param [String] deployment_id
133
+ # Required. The Deployment ID.
134
+ # @param [String] request_id
135
+ # Optional. An optional request ID to identify requests. Specify a unique
136
+ # request ID so that if you must retry your request, the server will know to
137
+ # ignore the request if it has already been completed. The server will guarantee
138
+ # that for at least 60 minutes since the first request. For example, consider a
139
+ # situation where you make an initial request and the request times out. If you
140
+ # make the request again with the same request ID, the server can check if
141
+ # original operation with the same request ID was received, and if so, will
142
+ # ignore the second request. This prevents clients from accidentally creating
143
+ # duplicate commitments. The request ID must be a valid UUID with the exception
144
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
145
+ # @param [String] fields
146
+ # Selector specifying which fields to include in a partial response.
147
+ # @param [String] quota_user
148
+ # Available to use for quota purposes for server-side applications. Can be any
149
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
150
+ # @param [Google::Apis::RequestOptions] options
151
+ # Request-specific options
152
+ #
153
+ # @yield [result, err] Result & error if block supplied
154
+ # @yieldparam result [Google::Apis::ConfigV1::Operation] parsed result object
155
+ # @yieldparam err [StandardError] error object if request failed
156
+ #
157
+ # @return [Google::Apis::ConfigV1::Operation]
158
+ #
159
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
160
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
161
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
162
+ def create_project_location_deployment(parent, deployment_object = nil, deployment_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
163
+ command = make_simple_command(:post, 'v1/{+parent}/deployments', options)
164
+ command.request_representation = Google::Apis::ConfigV1::Deployment::Representation
165
+ command.request_object = deployment_object
166
+ command.response_representation = Google::Apis::ConfigV1::Operation::Representation
167
+ command.response_class = Google::Apis::ConfigV1::Operation
168
+ command.params['parent'] = parent unless parent.nil?
169
+ command.query['deploymentId'] = deployment_id unless deployment_id.nil?
170
+ command.query['requestId'] = request_id unless request_id.nil?
171
+ command.query['fields'] = fields unless fields.nil?
172
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
173
+ execute_or_queue_command(command, &block)
174
+ end
175
+
176
+ # Deletes a Deployment.
177
+ # @param [String] name
178
+ # Required. The name of the Deployment in the format: 'projects/`project_id`/
179
+ # locations/`location`/deployments/`deployment`'.
180
+ # @param [String] delete_policy
181
+ # Optional. Policy on how resources actuated by the deployment should be deleted.
182
+ # If unspecified, the default behavior is to delete the underlying resources.
183
+ # @param [Boolean] force
184
+ # Optional. If set to true, any revisions for this deployment will also be
185
+ # deleted. (Otherwise, the request will only work if the deployment has no
186
+ # revisions.)
187
+ # @param [String] request_id
188
+ # Optional. An optional request ID to identify requests. Specify a unique
189
+ # request ID so that if you must retry your request, the server will know to
190
+ # ignore the request if it has already been completed. The server will guarantee
191
+ # that for at least 60 minutes after the first request. For example, consider a
192
+ # situation where you make an initial request and the request times out. If you
193
+ # make the request again with the same request ID, the server can check if
194
+ # original operation with the same request ID was received, and if so, will
195
+ # ignore the second request. This prevents clients from accidentally creating
196
+ # duplicate commitments. The request ID must be a valid UUID with the exception
197
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
198
+ # @param [String] fields
199
+ # Selector specifying which fields to include in a partial response.
200
+ # @param [String] quota_user
201
+ # Available to use for quota purposes for server-side applications. Can be any
202
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
203
+ # @param [Google::Apis::RequestOptions] options
204
+ # Request-specific options
205
+ #
206
+ # @yield [result, err] Result & error if block supplied
207
+ # @yieldparam result [Google::Apis::ConfigV1::Operation] parsed result object
208
+ # @yieldparam err [StandardError] error object if request failed
209
+ #
210
+ # @return [Google::Apis::ConfigV1::Operation]
211
+ #
212
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
213
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
214
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
215
+ def delete_project_location_deployment(name, delete_policy: nil, force: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
216
+ command = make_simple_command(:delete, 'v1/{+name}', options)
217
+ command.response_representation = Google::Apis::ConfigV1::Operation::Representation
218
+ command.response_class = Google::Apis::ConfigV1::Operation
219
+ command.params['name'] = name unless name.nil?
220
+ command.query['deletePolicy'] = delete_policy unless delete_policy.nil?
221
+ command.query['force'] = force unless force.nil?
222
+ command.query['requestId'] = request_id unless request_id.nil?
223
+ command.query['fields'] = fields unless fields.nil?
224
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
225
+ execute_or_queue_command(command, &block)
226
+ end
227
+
228
+ # Deletes Terraform state file in a given deployment.
229
+ # @param [String] name
230
+ # Required. The name of the deployment in the format: 'projects/`project_id`/
231
+ # locations/`location`/deployments/`deployment`'.
232
+ # @param [Google::Apis::ConfigV1::DeleteStatefileRequest] delete_statefile_request_object
233
+ # @param [String] fields
234
+ # Selector specifying which fields to include in a partial response.
235
+ # @param [String] quota_user
236
+ # Available to use for quota purposes for server-side applications. Can be any
237
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
238
+ # @param [Google::Apis::RequestOptions] options
239
+ # Request-specific options
240
+ #
241
+ # @yield [result, err] Result & error if block supplied
242
+ # @yieldparam result [Google::Apis::ConfigV1::Empty] parsed result object
243
+ # @yieldparam err [StandardError] error object if request failed
244
+ #
245
+ # @return [Google::Apis::ConfigV1::Empty]
246
+ #
247
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
248
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
249
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
250
+ def delete_project_location_deployment_state(name, delete_statefile_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
251
+ command = make_simple_command(:post, 'v1/{+name}:deleteState', options)
252
+ command.request_representation = Google::Apis::ConfigV1::DeleteStatefileRequest::Representation
253
+ command.request_object = delete_statefile_request_object
254
+ command.response_representation = Google::Apis::ConfigV1::Empty::Representation
255
+ command.response_class = Google::Apis::ConfigV1::Empty
256
+ command.params['name'] = name unless name.nil?
257
+ command.query['fields'] = fields unless fields.nil?
258
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
259
+ execute_or_queue_command(command, &block)
260
+ end
261
+
262
+ # Exports the lock info on a locked deployment.
263
+ # @param [String] name
264
+ # Required. The name of the deployment in the format: 'projects/`project_id`/
265
+ # locations/`location`/deployments/`deployment`'.
266
+ # @param [String] fields
267
+ # Selector specifying which fields to include in a partial response.
268
+ # @param [String] quota_user
269
+ # Available to use for quota purposes for server-side applications. Can be any
270
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
271
+ # @param [Google::Apis::RequestOptions] options
272
+ # Request-specific options
273
+ #
274
+ # @yield [result, err] Result & error if block supplied
275
+ # @yieldparam result [Google::Apis::ConfigV1::LockInfo] parsed result object
276
+ # @yieldparam err [StandardError] error object if request failed
277
+ #
278
+ # @return [Google::Apis::ConfigV1::LockInfo]
279
+ #
280
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
281
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
282
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
283
+ def export_project_location_deployment_lock(name, fields: nil, quota_user: nil, options: nil, &block)
284
+ command = make_simple_command(:get, 'v1/{+name}:exportLock', options)
285
+ command.response_representation = Google::Apis::ConfigV1::LockInfo::Representation
286
+ command.response_class = Google::Apis::ConfigV1::LockInfo
287
+ command.params['name'] = name unless name.nil?
288
+ command.query['fields'] = fields unless fields.nil?
289
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
290
+ execute_or_queue_command(command, &block)
291
+ end
292
+
293
+ # Exports Terraform state file from a given deployment.
294
+ # @param [String] parent
295
+ # Required. The parent in whose context the statefile is listed. The parent
296
+ # value is in the format: 'projects/`project_id`/locations/`location`/
297
+ # deployments/`deployment`'.
298
+ # @param [Google::Apis::ConfigV1::ExportDeploymentStatefileRequest] export_deployment_statefile_request_object
299
+ # @param [String] fields
300
+ # Selector specifying which fields to include in a partial response.
301
+ # @param [String] quota_user
302
+ # Available to use for quota purposes for server-side applications. Can be any
303
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
304
+ # @param [Google::Apis::RequestOptions] options
305
+ # Request-specific options
306
+ #
307
+ # @yield [result, err] Result & error if block supplied
308
+ # @yieldparam result [Google::Apis::ConfigV1::Statefile] parsed result object
309
+ # @yieldparam err [StandardError] error object if request failed
310
+ #
311
+ # @return [Google::Apis::ConfigV1::Statefile]
312
+ #
313
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
314
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
315
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
316
+ def export_project_location_deployment_state(parent, export_deployment_statefile_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
317
+ command = make_simple_command(:post, 'v1/{+parent}:exportState', options)
318
+ command.request_representation = Google::Apis::ConfigV1::ExportDeploymentStatefileRequest::Representation
319
+ command.request_object = export_deployment_statefile_request_object
320
+ command.response_representation = Google::Apis::ConfigV1::Statefile::Representation
321
+ command.response_class = Google::Apis::ConfigV1::Statefile
322
+ command.params['parent'] = parent unless parent.nil?
323
+ command.query['fields'] = fields unless fields.nil?
324
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
325
+ execute_or_queue_command(command, &block)
326
+ end
327
+
328
+ # Gets details about a Deployment.
329
+ # @param [String] name
330
+ # Required. The name of the deployment. Format: 'projects/`project_id`/locations/
331
+ # `location`/deployments/`deployment`'.
332
+ # @param [String] fields
333
+ # Selector specifying which fields to include in a partial response.
334
+ # @param [String] quota_user
335
+ # Available to use for quota purposes for server-side applications. Can be any
336
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
337
+ # @param [Google::Apis::RequestOptions] options
338
+ # Request-specific options
339
+ #
340
+ # @yield [result, err] Result & error if block supplied
341
+ # @yieldparam result [Google::Apis::ConfigV1::Deployment] parsed result object
342
+ # @yieldparam err [StandardError] error object if request failed
343
+ #
344
+ # @return [Google::Apis::ConfigV1::Deployment]
345
+ #
346
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
347
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
348
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
349
+ def get_project_location_deployment(name, fields: nil, quota_user: nil, options: nil, &block)
350
+ command = make_simple_command(:get, 'v1/{+name}', options)
351
+ command.response_representation = Google::Apis::ConfigV1::Deployment::Representation
352
+ command.response_class = Google::Apis::ConfigV1::Deployment
353
+ command.params['name'] = name unless name.nil?
354
+ command.query['fields'] = fields unless fields.nil?
355
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
356
+ execute_or_queue_command(command, &block)
357
+ end
358
+
359
+ # Gets the access control policy for a resource. Returns an empty policy if the
360
+ # resource exists and does not have a policy set.
361
+ # @param [String] resource
362
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
363
+ # names](https://cloud.google.com/apis/design/resource_names) for the
364
+ # appropriate value for this field.
365
+ # @param [Fixnum] options_requested_policy_version
366
+ # Optional. The maximum policy version that will be used to format the policy.
367
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
368
+ # rejected. Requests for policies with any conditional role bindings must
369
+ # specify version 3. Policies with no conditional role bindings may specify any
370
+ # valid value or leave the field unset. The policy in the response might use the
371
+ # policy version that you specified, or it might use a lower policy version. For
372
+ # example, if you specify version 3, but the policy has no conditional role
373
+ # bindings, the response uses version 1. To learn which resources support
374
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
375
+ # google.com/iam/help/conditions/resource-policies).
376
+ # @param [String] fields
377
+ # Selector specifying which fields to include in a partial response.
378
+ # @param [String] quota_user
379
+ # Available to use for quota purposes for server-side applications. Can be any
380
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
381
+ # @param [Google::Apis::RequestOptions] options
382
+ # Request-specific options
383
+ #
384
+ # @yield [result, err] Result & error if block supplied
385
+ # @yieldparam result [Google::Apis::ConfigV1::Policy] parsed result object
386
+ # @yieldparam err [StandardError] error object if request failed
387
+ #
388
+ # @return [Google::Apis::ConfigV1::Policy]
389
+ #
390
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
391
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
392
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
393
+ def get_project_location_deployment_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
394
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
395
+ command.response_representation = Google::Apis::ConfigV1::Policy::Representation
396
+ command.response_class = Google::Apis::ConfigV1::Policy
397
+ command.params['resource'] = resource unless resource.nil?
398
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
399
+ command.query['fields'] = fields unless fields.nil?
400
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
401
+ execute_or_queue_command(command, &block)
402
+ end
403
+
404
+ # Imports Terraform state file in a given deployment. The state file does not
405
+ # take effect until the Deployment has been unlocked.
406
+ # @param [String] parent
407
+ # Required. The parent in whose context the statefile is listed. The parent
408
+ # value is in the format: 'projects/`project_id`/locations/`location`/
409
+ # deployments/`deployment`'.
410
+ # @param [Google::Apis::ConfigV1::ImportStatefileRequest] import_statefile_request_object
411
+ # @param [String] fields
412
+ # Selector specifying which fields to include in a partial response.
413
+ # @param [String] quota_user
414
+ # Available to use for quota purposes for server-side applications. Can be any
415
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
416
+ # @param [Google::Apis::RequestOptions] options
417
+ # Request-specific options
418
+ #
419
+ # @yield [result, err] Result & error if block supplied
420
+ # @yieldparam result [Google::Apis::ConfigV1::Statefile] parsed result object
421
+ # @yieldparam err [StandardError] error object if request failed
422
+ #
423
+ # @return [Google::Apis::ConfigV1::Statefile]
424
+ #
425
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
426
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
427
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
428
+ def import_project_location_deployment_state(parent, import_statefile_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
429
+ command = make_simple_command(:post, 'v1/{+parent}:importState', options)
430
+ command.request_representation = Google::Apis::ConfigV1::ImportStatefileRequest::Representation
431
+ command.request_object = import_statefile_request_object
432
+ command.response_representation = Google::Apis::ConfigV1::Statefile::Representation
433
+ command.response_class = Google::Apis::ConfigV1::Statefile
434
+ command.params['parent'] = parent unless parent.nil?
435
+ command.query['fields'] = fields unless fields.nil?
436
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
437
+ execute_or_queue_command(command, &block)
438
+ end
439
+
440
+ # Lists Deployments in a given project and location.
441
+ # @param [String] parent
442
+ # Required. The parent in whose context the Deployments are listed. The parent
443
+ # value is in the format: 'projects/`project_id`/locations/`location`'.
444
+ # @param [String] filter
445
+ # Lists the Deployments that match the filter expression. A filter expression
446
+ # filters the resources listed in the response. The expression must be of the
447
+ # form '`field` `operator` `value`' where operators: '<', '>', '<=', '>=', '!=',
448
+ # '=', ':' are supported (colon ':' represents a HAS operator which is roughly
449
+ # synonymous with equality). `field` can refer to a proto or JSON field, or a
450
+ # synthetic field. Field names can be camelCase or snake_case. Examples: -
451
+ # Filter by name: name = "projects/foo/locations/us-central1/deployments/bar -
452
+ # Filter by labels: - Resources that have a key called 'foo' labels.foo:* -
453
+ # Resources that have a key called 'foo' whose value is 'bar' labels.foo = bar -
454
+ # Filter by state: - Deployments in CREATING state. state=CREATING
455
+ # @param [String] order_by
456
+ # Field to use to sort the list.
457
+ # @param [Fixnum] page_size
458
+ # When requesting a page of resources, 'page_size' specifies number of resources
459
+ # to return. If unspecified, at most 500 will be returned. The maximum value is
460
+ # 1000.
461
+ # @param [String] page_token
462
+ # Token returned by previous call to 'ListDeployments' which specifies the
463
+ # position in the list from where to continue listing the resources.
464
+ # @param [String] fields
465
+ # Selector specifying which fields to include in a partial response.
466
+ # @param [String] quota_user
467
+ # Available to use for quota purposes for server-side applications. Can be any
468
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
469
+ # @param [Google::Apis::RequestOptions] options
470
+ # Request-specific options
471
+ #
472
+ # @yield [result, err] Result & error if block supplied
473
+ # @yieldparam result [Google::Apis::ConfigV1::ListDeploymentsResponse] parsed result object
474
+ # @yieldparam err [StandardError] error object if request failed
475
+ #
476
+ # @return [Google::Apis::ConfigV1::ListDeploymentsResponse]
477
+ #
478
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
479
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
480
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
481
+ def list_project_location_deployments(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
482
+ command = make_simple_command(:get, 'v1/{+parent}/deployments', options)
483
+ command.response_representation = Google::Apis::ConfigV1::ListDeploymentsResponse::Representation
484
+ command.response_class = Google::Apis::ConfigV1::ListDeploymentsResponse
485
+ command.params['parent'] = parent unless parent.nil?
486
+ command.query['filter'] = filter unless filter.nil?
487
+ command.query['orderBy'] = order_by unless order_by.nil?
488
+ command.query['pageSize'] = page_size unless page_size.nil?
489
+ command.query['pageToken'] = page_token unless page_token.nil?
490
+ command.query['fields'] = fields unless fields.nil?
491
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
492
+ execute_or_queue_command(command, &block)
493
+ end
494
+
495
+ # Locks a deployment.
496
+ # @param [String] name
497
+ # Required. The name of the deployment in the format: 'projects/`project_id`/
498
+ # locations/`location`/deployments/`deployment`'.
499
+ # @param [Google::Apis::ConfigV1::LockDeploymentRequest] lock_deployment_request_object
500
+ # @param [String] fields
501
+ # Selector specifying which fields to include in a partial response.
502
+ # @param [String] quota_user
503
+ # Available to use for quota purposes for server-side applications. Can be any
504
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
505
+ # @param [Google::Apis::RequestOptions] options
506
+ # Request-specific options
507
+ #
508
+ # @yield [result, err] Result & error if block supplied
509
+ # @yieldparam result [Google::Apis::ConfigV1::Operation] parsed result object
510
+ # @yieldparam err [StandardError] error object if request failed
511
+ #
512
+ # @return [Google::Apis::ConfigV1::Operation]
513
+ #
514
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
515
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
516
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
517
+ def lock_deployment(name, lock_deployment_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
518
+ command = make_simple_command(:post, 'v1/{+name}:lock', options)
519
+ command.request_representation = Google::Apis::ConfigV1::LockDeploymentRequest::Representation
520
+ command.request_object = lock_deployment_request_object
521
+ command.response_representation = Google::Apis::ConfigV1::Operation::Representation
522
+ command.response_class = Google::Apis::ConfigV1::Operation
523
+ command.params['name'] = name unless name.nil?
524
+ command.query['fields'] = fields unless fields.nil?
525
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
526
+ execute_or_queue_command(command, &block)
527
+ end
528
+
529
+ # Updates a Deployment.
530
+ # @param [String] name
531
+ # Resource name of the deployment. Format: `projects/`project`/locations/`
532
+ # location`/deployments/`deployment``
533
+ # @param [Google::Apis::ConfigV1::Deployment] deployment_object
534
+ # @param [String] request_id
535
+ # Optional. An optional request ID to identify requests. Specify a unique
536
+ # request ID so that if you must retry your request, the server will know to
537
+ # ignore the request if it has already been completed. The server will guarantee
538
+ # that for at least 60 minutes since the first request. For example, consider a
539
+ # situation where you make an initial request and the request times out. If you
540
+ # make the request again with the same request ID, the server can check if
541
+ # original operation with the same request ID was received, and if so, will
542
+ # ignore the second request. This prevents clients from accidentally creating
543
+ # duplicate commitments. The request ID must be a valid UUID with the exception
544
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
545
+ # @param [String] update_mask
546
+ # Optional. Field mask used to specify the fields to be overwritten in the
547
+ # Deployment resource by the update. The fields specified in the update_mask are
548
+ # relative to the resource, not the full request. A field will be overwritten if
549
+ # it is in the mask. If the user does not provide a mask then all fields will be
550
+ # overwritten.
551
+ # @param [String] fields
552
+ # Selector specifying which fields to include in a partial response.
553
+ # @param [String] quota_user
554
+ # Available to use for quota purposes for server-side applications. Can be any
555
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
556
+ # @param [Google::Apis::RequestOptions] options
557
+ # Request-specific options
558
+ #
559
+ # @yield [result, err] Result & error if block supplied
560
+ # @yieldparam result [Google::Apis::ConfigV1::Operation] parsed result object
561
+ # @yieldparam err [StandardError] error object if request failed
562
+ #
563
+ # @return [Google::Apis::ConfigV1::Operation]
564
+ #
565
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
566
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
567
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
568
+ def patch_project_location_deployment(name, deployment_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
569
+ command = make_simple_command(:patch, 'v1/{+name}', options)
570
+ command.request_representation = Google::Apis::ConfigV1::Deployment::Representation
571
+ command.request_object = deployment_object
572
+ command.response_representation = Google::Apis::ConfigV1::Operation::Representation
573
+ command.response_class = Google::Apis::ConfigV1::Operation
574
+ command.params['name'] = name unless name.nil?
575
+ command.query['requestId'] = request_id unless request_id.nil?
576
+ command.query['updateMask'] = update_mask unless update_mask.nil?
577
+ command.query['fields'] = fields unless fields.nil?
578
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
579
+ execute_or_queue_command(command, &block)
580
+ end
581
+
582
+ # Sets the access control policy on the specified resource. Replaces any
583
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
584
+ # PERMISSION_DENIED` errors.
585
+ # @param [String] resource
586
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
587
+ # names](https://cloud.google.com/apis/design/resource_names) for the
588
+ # appropriate value for this field.
589
+ # @param [Google::Apis::ConfigV1::SetIamPolicyRequest] set_iam_policy_request_object
590
+ # @param [String] fields
591
+ # Selector specifying which fields to include in a partial response.
592
+ # @param [String] quota_user
593
+ # Available to use for quota purposes for server-side applications. Can be any
594
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
595
+ # @param [Google::Apis::RequestOptions] options
596
+ # Request-specific options
597
+ #
598
+ # @yield [result, err] Result & error if block supplied
599
+ # @yieldparam result [Google::Apis::ConfigV1::Policy] parsed result object
600
+ # @yieldparam err [StandardError] error object if request failed
601
+ #
602
+ # @return [Google::Apis::ConfigV1::Policy]
603
+ #
604
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
605
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
606
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
607
+ def set_deployment_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
608
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
609
+ command.request_representation = Google::Apis::ConfigV1::SetIamPolicyRequest::Representation
610
+ command.request_object = set_iam_policy_request_object
611
+ command.response_representation = Google::Apis::ConfigV1::Policy::Representation
612
+ command.response_class = Google::Apis::ConfigV1::Policy
613
+ command.params['resource'] = resource unless resource.nil?
614
+ command.query['fields'] = fields unless fields.nil?
615
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
616
+ execute_or_queue_command(command, &block)
617
+ end
618
+
619
+ # Returns permissions that a caller has on the specified resource. If the
620
+ # resource does not exist, this will return an empty set of permissions, not a `
621
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
622
+ # permission-aware UIs and command-line tools, not for authorization checking.
623
+ # This operation may "fail open" without warning.
624
+ # @param [String] resource
625
+ # REQUIRED: The resource for which the policy detail is being requested. See [
626
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
627
+ # appropriate value for this field.
628
+ # @param [Google::Apis::ConfigV1::TestIamPermissionsRequest] test_iam_permissions_request_object
629
+ # @param [String] fields
630
+ # Selector specifying which fields to include in a partial response.
631
+ # @param [String] quota_user
632
+ # Available to use for quota purposes for server-side applications. Can be any
633
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
634
+ # @param [Google::Apis::RequestOptions] options
635
+ # Request-specific options
636
+ #
637
+ # @yield [result, err] Result & error if block supplied
638
+ # @yieldparam result [Google::Apis::ConfigV1::TestIamPermissionsResponse] parsed result object
639
+ # @yieldparam err [StandardError] error object if request failed
640
+ #
641
+ # @return [Google::Apis::ConfigV1::TestIamPermissionsResponse]
642
+ #
643
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
644
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
645
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
646
+ def test_deployment_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
647
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
648
+ command.request_representation = Google::Apis::ConfigV1::TestIamPermissionsRequest::Representation
649
+ command.request_object = test_iam_permissions_request_object
650
+ command.response_representation = Google::Apis::ConfigV1::TestIamPermissionsResponse::Representation
651
+ command.response_class = Google::Apis::ConfigV1::TestIamPermissionsResponse
652
+ command.params['resource'] = resource unless resource.nil?
653
+ command.query['fields'] = fields unless fields.nil?
654
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
655
+ execute_or_queue_command(command, &block)
656
+ end
657
+
658
+ # Unlocks a locked deployment.
659
+ # @param [String] name
660
+ # Required. The name of the deployment in the format: 'projects/`project_id`/
661
+ # locations/`location`/deployments/`deployment`'.
662
+ # @param [Google::Apis::ConfigV1::UnlockDeploymentRequest] unlock_deployment_request_object
663
+ # @param [String] fields
664
+ # Selector specifying which fields to include in a partial response.
665
+ # @param [String] quota_user
666
+ # Available to use for quota purposes for server-side applications. Can be any
667
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
668
+ # @param [Google::Apis::RequestOptions] options
669
+ # Request-specific options
670
+ #
671
+ # @yield [result, err] Result & error if block supplied
672
+ # @yieldparam result [Google::Apis::ConfigV1::Operation] parsed result object
673
+ # @yieldparam err [StandardError] error object if request failed
674
+ #
675
+ # @return [Google::Apis::ConfigV1::Operation]
676
+ #
677
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
678
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
679
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
680
+ def unlock_deployment(name, unlock_deployment_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
681
+ command = make_simple_command(:post, 'v1/{+name}:unlock', options)
682
+ command.request_representation = Google::Apis::ConfigV1::UnlockDeploymentRequest::Representation
683
+ command.request_object = unlock_deployment_request_object
684
+ command.response_representation = Google::Apis::ConfigV1::Operation::Representation
685
+ command.response_class = Google::Apis::ConfigV1::Operation
686
+ command.params['name'] = name unless name.nil?
687
+ command.query['fields'] = fields unless fields.nil?
688
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
689
+ execute_or_queue_command(command, &block)
690
+ end
691
+
692
+ # Exports Terraform state file from a given revision.
693
+ # @param [String] parent
694
+ # Required. The parent in whose context the statefile is listed. The parent
695
+ # value is in the format: 'projects/`project_id`/locations/`location`/
696
+ # deployments/`deployment`/revisions/`revision`'.
697
+ # @param [Google::Apis::ConfigV1::ExportRevisionStatefileRequest] export_revision_statefile_request_object
698
+ # @param [String] fields
699
+ # Selector specifying which fields to include in a partial response.
700
+ # @param [String] quota_user
701
+ # Available to use for quota purposes for server-side applications. Can be any
702
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
703
+ # @param [Google::Apis::RequestOptions] options
704
+ # Request-specific options
705
+ #
706
+ # @yield [result, err] Result & error if block supplied
707
+ # @yieldparam result [Google::Apis::ConfigV1::Statefile] parsed result object
708
+ # @yieldparam err [StandardError] error object if request failed
709
+ #
710
+ # @return [Google::Apis::ConfigV1::Statefile]
711
+ #
712
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
713
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
714
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
715
+ def export_project_location_deployment_revision_state(parent, export_revision_statefile_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
716
+ command = make_simple_command(:post, 'v1/{+parent}:exportState', options)
717
+ command.request_representation = Google::Apis::ConfigV1::ExportRevisionStatefileRequest::Representation
718
+ command.request_object = export_revision_statefile_request_object
719
+ command.response_representation = Google::Apis::ConfigV1::Statefile::Representation
720
+ command.response_class = Google::Apis::ConfigV1::Statefile
721
+ command.params['parent'] = parent unless parent.nil?
722
+ command.query['fields'] = fields unless fields.nil?
723
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
724
+ execute_or_queue_command(command, &block)
725
+ end
726
+
727
+ # Gets details about a Revision.
728
+ # @param [String] name
729
+ # Required. The name of the Revision in the format: 'projects/`project_id`/
730
+ # locations/`location`/deployments/`deployment`/revisions/`revision`'.
731
+ # @param [String] fields
732
+ # Selector specifying which fields to include in a partial response.
733
+ # @param [String] quota_user
734
+ # Available to use for quota purposes for server-side applications. Can be any
735
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
736
+ # @param [Google::Apis::RequestOptions] options
737
+ # Request-specific options
738
+ #
739
+ # @yield [result, err] Result & error if block supplied
740
+ # @yieldparam result [Google::Apis::ConfigV1::Revision] parsed result object
741
+ # @yieldparam err [StandardError] error object if request failed
742
+ #
743
+ # @return [Google::Apis::ConfigV1::Revision]
744
+ #
745
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
746
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
747
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
748
+ def get_project_location_deployment_revision(name, fields: nil, quota_user: nil, options: nil, &block)
749
+ command = make_simple_command(:get, 'v1/{+name}', options)
750
+ command.response_representation = Google::Apis::ConfigV1::Revision::Representation
751
+ command.response_class = Google::Apis::ConfigV1::Revision
752
+ command.params['name'] = name unless name.nil?
753
+ command.query['fields'] = fields unless fields.nil?
754
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
755
+ execute_or_queue_command(command, &block)
756
+ end
757
+
758
+ # Lists Revisions of a deployment.
759
+ # @param [String] parent
760
+ # Required. The parent in whose context the Revisions are listed. The parent
761
+ # value is in the format: 'projects/`project_id`/locations/`location`/
762
+ # deployments/`deployment`'.
763
+ # @param [String] filter
764
+ # Lists the Revisions that match the filter expression. A filter expression
765
+ # filters the resources listed in the response. The expression must be of the
766
+ # form '`field` `operator` `value`' where operators: '<', '>', '<=', '>=', '!=',
767
+ # '=', ':' are supported (colon ':' represents a HAS operator which is roughly
768
+ # synonymous with equality). `field` can refer to a proto or JSON field, or a
769
+ # synthetic field. Field names can be camelCase or snake_case. Examples: -
770
+ # Filter by name: name = "projects/foo/locations/us-central1/deployments/dep/
771
+ # revisions/bar - Filter by labels: - Resources that have a key called 'foo'
772
+ # labels.foo:* - Resources that have a key called 'foo' whose value is 'bar'
773
+ # labels.foo = bar - Filter by state: - Revisions in CREATING state. state=
774
+ # CREATING
775
+ # @param [String] order_by
776
+ # Field to use to sort the list.
777
+ # @param [Fixnum] page_size
778
+ # When requesting a page of resources, `page_size` specifies number of resources
779
+ # to return. If unspecified, at most 500 will be returned. The maximum value is
780
+ # 1000.
781
+ # @param [String] page_token
782
+ # Token returned by previous call to 'ListRevisions' which specifies the
783
+ # position in the list from where to continue listing the resources.
784
+ # @param [String] fields
785
+ # Selector specifying which fields to include in a partial response.
786
+ # @param [String] quota_user
787
+ # Available to use for quota purposes for server-side applications. Can be any
788
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
789
+ # @param [Google::Apis::RequestOptions] options
790
+ # Request-specific options
791
+ #
792
+ # @yield [result, err] Result & error if block supplied
793
+ # @yieldparam result [Google::Apis::ConfigV1::ListRevisionsResponse] parsed result object
794
+ # @yieldparam err [StandardError] error object if request failed
795
+ #
796
+ # @return [Google::Apis::ConfigV1::ListRevisionsResponse]
797
+ #
798
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
799
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
800
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
801
+ def list_project_location_deployment_revisions(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
802
+ command = make_simple_command(:get, 'v1/{+parent}/revisions', options)
803
+ command.response_representation = Google::Apis::ConfigV1::ListRevisionsResponse::Representation
804
+ command.response_class = Google::Apis::ConfigV1::ListRevisionsResponse
805
+ command.params['parent'] = parent unless parent.nil?
806
+ command.query['filter'] = filter unless filter.nil?
807
+ command.query['orderBy'] = order_by unless order_by.nil?
808
+ command.query['pageSize'] = page_size unless page_size.nil?
809
+ command.query['pageToken'] = page_token unless page_token.nil?
810
+ command.query['fields'] = fields unless fields.nil?
811
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
812
+ execute_or_queue_command(command, &block)
813
+ end
814
+
815
+ # Gets details about a Resource deployed by Infra Manager.
816
+ # @param [String] name
817
+ # Required. The name of the Resource in the format: 'projects/`project_id`/
818
+ # locations/`location`/deployments/`deployment`/revisions/`revision`/resource/`
819
+ # resource`'.
820
+ # @param [String] fields
821
+ # Selector specifying which fields to include in a partial response.
822
+ # @param [String] quota_user
823
+ # Available to use for quota purposes for server-side applications. Can be any
824
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
825
+ # @param [Google::Apis::RequestOptions] options
826
+ # Request-specific options
827
+ #
828
+ # @yield [result, err] Result & error if block supplied
829
+ # @yieldparam result [Google::Apis::ConfigV1::Resource] parsed result object
830
+ # @yieldparam err [StandardError] error object if request failed
831
+ #
832
+ # @return [Google::Apis::ConfigV1::Resource]
833
+ #
834
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
835
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
836
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
837
+ def get_project_location_deployment_revision_resource(name, fields: nil, quota_user: nil, options: nil, &block)
838
+ command = make_simple_command(:get, 'v1/{+name}', options)
839
+ command.response_representation = Google::Apis::ConfigV1::Resource::Representation
840
+ command.response_class = Google::Apis::ConfigV1::Resource
841
+ command.params['name'] = name unless name.nil?
842
+ command.query['fields'] = fields unless fields.nil?
843
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
844
+ execute_or_queue_command(command, &block)
845
+ end
846
+
847
+ # Lists Resources in a given revision.
848
+ # @param [String] parent
849
+ # Required. The parent in whose context the Resources are listed. The parent
850
+ # value is in the format: 'projects/`project_id`/locations/`location`/
851
+ # deployments/`deployment`/revisions/`revision`'.
852
+ # @param [String] filter
853
+ # Lists the Resources that match the filter expression. A filter expression
854
+ # filters the resources listed in the response. The expression must be of the
855
+ # form '`field` `operator` `value`' where operators: '<', '>', '<=', '>=', '!=',
856
+ # '=', ':' are supported (colon ':' represents a HAS operator which is roughly
857
+ # synonymous with equality). `field` can refer to a proto or JSON field, or a
858
+ # synthetic field. Field names can be camelCase or snake_case. Examples: -
859
+ # Filter by name: name = "projects/foo/locations/us-central1/deployments/dep/
860
+ # revisions/bar/resources/baz
861
+ # @param [String] order_by
862
+ # Field to use to sort the list.
863
+ # @param [Fixnum] page_size
864
+ # When requesting a page of resources, 'page_size' specifies number of resources
865
+ # to return. If unspecified, at most 500 will be returned. The maximum value is
866
+ # 1000.
867
+ # @param [String] page_token
868
+ # Token returned by previous call to 'ListResources' which specifies the
869
+ # position in the list from where to continue listing the resources.
870
+ # @param [String] fields
871
+ # Selector specifying which fields to include in a partial response.
872
+ # @param [String] quota_user
873
+ # Available to use for quota purposes for server-side applications. Can be any
874
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
875
+ # @param [Google::Apis::RequestOptions] options
876
+ # Request-specific options
877
+ #
878
+ # @yield [result, err] Result & error if block supplied
879
+ # @yieldparam result [Google::Apis::ConfigV1::ListResourcesResponse] parsed result object
880
+ # @yieldparam err [StandardError] error object if request failed
881
+ #
882
+ # @return [Google::Apis::ConfigV1::ListResourcesResponse]
883
+ #
884
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
885
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
886
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
887
+ def list_project_location_deployment_revision_resources(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
888
+ command = make_simple_command(:get, 'v1/{+parent}/resources', options)
889
+ command.response_representation = Google::Apis::ConfigV1::ListResourcesResponse::Representation
890
+ command.response_class = Google::Apis::ConfigV1::ListResourcesResponse
891
+ command.params['parent'] = parent unless parent.nil?
892
+ command.query['filter'] = filter unless filter.nil?
893
+ command.query['orderBy'] = order_by unless order_by.nil?
894
+ command.query['pageSize'] = page_size unless page_size.nil?
895
+ command.query['pageToken'] = page_token unless page_token.nil?
896
+ command.query['fields'] = fields unless fields.nil?
897
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
898
+ execute_or_queue_command(command, &block)
899
+ end
900
+
901
+ # Starts asynchronous cancellation on a long-running operation. The server makes
902
+ # a best effort to cancel the operation, but success is not guaranteed. If the
903
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
904
+ # Clients can use Operations.GetOperation or other methods to check whether the
905
+ # cancellation succeeded or whether the operation completed despite cancellation.
906
+ # On successful cancellation, the operation is not deleted; instead, it becomes
907
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
908
+ # corresponding to `Code.CANCELLED`.
909
+ # @param [String] name
910
+ # The name of the operation resource to be cancelled.
911
+ # @param [Google::Apis::ConfigV1::CancelOperationRequest] cancel_operation_request_object
912
+ # @param [String] fields
913
+ # Selector specifying which fields to include in a partial response.
914
+ # @param [String] quota_user
915
+ # Available to use for quota purposes for server-side applications. Can be any
916
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
917
+ # @param [Google::Apis::RequestOptions] options
918
+ # Request-specific options
919
+ #
920
+ # @yield [result, err] Result & error if block supplied
921
+ # @yieldparam result [Google::Apis::ConfigV1::Empty] parsed result object
922
+ # @yieldparam err [StandardError] error object if request failed
923
+ #
924
+ # @return [Google::Apis::ConfigV1::Empty]
925
+ #
926
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
927
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
928
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
929
+ def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
930
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
931
+ command.request_representation = Google::Apis::ConfigV1::CancelOperationRequest::Representation
932
+ command.request_object = cancel_operation_request_object
933
+ command.response_representation = Google::Apis::ConfigV1::Empty::Representation
934
+ command.response_class = Google::Apis::ConfigV1::Empty
935
+ command.params['name'] = name unless name.nil?
936
+ command.query['fields'] = fields unless fields.nil?
937
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
938
+ execute_or_queue_command(command, &block)
939
+ end
940
+
941
+ # Deletes a long-running operation. This method indicates that the client is no
942
+ # longer interested in the operation result. It does not cancel the operation.
943
+ # If the server doesn't support this method, it returns `google.rpc.Code.
944
+ # UNIMPLEMENTED`.
945
+ # @param [String] name
946
+ # The name of the operation resource to be deleted.
947
+ # @param [String] fields
948
+ # Selector specifying which fields to include in a partial response.
949
+ # @param [String] quota_user
950
+ # Available to use for quota purposes for server-side applications. Can be any
951
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
952
+ # @param [Google::Apis::RequestOptions] options
953
+ # Request-specific options
954
+ #
955
+ # @yield [result, err] Result & error if block supplied
956
+ # @yieldparam result [Google::Apis::ConfigV1::Empty] parsed result object
957
+ # @yieldparam err [StandardError] error object if request failed
958
+ #
959
+ # @return [Google::Apis::ConfigV1::Empty]
960
+ #
961
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
962
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
963
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
964
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
965
+ command = make_simple_command(:delete, 'v1/{+name}', options)
966
+ command.response_representation = Google::Apis::ConfigV1::Empty::Representation
967
+ command.response_class = Google::Apis::ConfigV1::Empty
968
+ command.params['name'] = name unless name.nil?
969
+ command.query['fields'] = fields unless fields.nil?
970
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
971
+ execute_or_queue_command(command, &block)
972
+ end
973
+
974
+ # Gets the latest state of a long-running operation. Clients can use this method
975
+ # to poll the operation result at intervals as recommended by the API service.
976
+ # @param [String] name
977
+ # The name of the operation resource.
978
+ # @param [String] fields
979
+ # Selector specifying which fields to include in a partial response.
980
+ # @param [String] quota_user
981
+ # Available to use for quota purposes for server-side applications. Can be any
982
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
983
+ # @param [Google::Apis::RequestOptions] options
984
+ # Request-specific options
985
+ #
986
+ # @yield [result, err] Result & error if block supplied
987
+ # @yieldparam result [Google::Apis::ConfigV1::Operation] parsed result object
988
+ # @yieldparam err [StandardError] error object if request failed
989
+ #
990
+ # @return [Google::Apis::ConfigV1::Operation]
991
+ #
992
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
993
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
994
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
995
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
996
+ command = make_simple_command(:get, 'v1/{+name}', options)
997
+ command.response_representation = Google::Apis::ConfigV1::Operation::Representation
998
+ command.response_class = Google::Apis::ConfigV1::Operation
999
+ command.params['name'] = name unless name.nil?
1000
+ command.query['fields'] = fields unless fields.nil?
1001
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1002
+ execute_or_queue_command(command, &block)
1003
+ end
1004
+
1005
+ # Lists operations that match the specified filter in the request. If the server
1006
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
1007
+ # @param [String] name
1008
+ # The name of the operation's parent resource.
1009
+ # @param [String] filter
1010
+ # The standard list filter.
1011
+ # @param [Fixnum] page_size
1012
+ # The standard list page size.
1013
+ # @param [String] page_token
1014
+ # The standard list page token.
1015
+ # @param [String] fields
1016
+ # Selector specifying which fields to include in a partial response.
1017
+ # @param [String] quota_user
1018
+ # Available to use for quota purposes for server-side applications. Can be any
1019
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1020
+ # @param [Google::Apis::RequestOptions] options
1021
+ # Request-specific options
1022
+ #
1023
+ # @yield [result, err] Result & error if block supplied
1024
+ # @yieldparam result [Google::Apis::ConfigV1::ListOperationsResponse] parsed result object
1025
+ # @yieldparam err [StandardError] error object if request failed
1026
+ #
1027
+ # @return [Google::Apis::ConfigV1::ListOperationsResponse]
1028
+ #
1029
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1030
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1031
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1032
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1033
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
1034
+ command.response_representation = Google::Apis::ConfigV1::ListOperationsResponse::Representation
1035
+ command.response_class = Google::Apis::ConfigV1::ListOperationsResponse
1036
+ command.params['name'] = name unless name.nil?
1037
+ command.query['filter'] = filter unless filter.nil?
1038
+ command.query['pageSize'] = page_size unless page_size.nil?
1039
+ command.query['pageToken'] = page_token unless page_token.nil?
1040
+ command.query['fields'] = fields unless fields.nil?
1041
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1042
+ execute_or_queue_command(command, &block)
1043
+ end
1044
+
1045
+ # Creates a Preview.
1046
+ # @param [String] parent
1047
+ # Required. The parent in whose context the Preview is created. The parent value
1048
+ # is in the format: 'projects/`project_id`/locations/`location`'.
1049
+ # @param [Google::Apis::ConfigV1::Preview] preview_object
1050
+ # @param [String] preview_id
1051
+ # Optional. The preview ID.
1052
+ # @param [String] request_id
1053
+ # Optional. An optional request ID to identify requests. Specify a unique
1054
+ # request ID so that if you must retry your request, the server will know to
1055
+ # ignore the request if it has already been completed. The server will guarantee
1056
+ # that for at least 60 minutes since the first request. For example, consider a
1057
+ # situation where you make an initial request and the request times out. If you
1058
+ # make the request again with the same request ID, the server can check if
1059
+ # original operation with the same request ID was received, and if so, will
1060
+ # ignore the second request. This prevents clients from accidentally creating
1061
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1062
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1063
+ # @param [String] fields
1064
+ # Selector specifying which fields to include in a partial response.
1065
+ # @param [String] quota_user
1066
+ # Available to use for quota purposes for server-side applications. Can be any
1067
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1068
+ # @param [Google::Apis::RequestOptions] options
1069
+ # Request-specific options
1070
+ #
1071
+ # @yield [result, err] Result & error if block supplied
1072
+ # @yieldparam result [Google::Apis::ConfigV1::Operation] parsed result object
1073
+ # @yieldparam err [StandardError] error object if request failed
1074
+ #
1075
+ # @return [Google::Apis::ConfigV1::Operation]
1076
+ #
1077
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1078
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1079
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1080
+ def create_project_location_preview(parent, preview_object = nil, preview_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1081
+ command = make_simple_command(:post, 'v1/{+parent}/previews', options)
1082
+ command.request_representation = Google::Apis::ConfigV1::Preview::Representation
1083
+ command.request_object = preview_object
1084
+ command.response_representation = Google::Apis::ConfigV1::Operation::Representation
1085
+ command.response_class = Google::Apis::ConfigV1::Operation
1086
+ command.params['parent'] = parent unless parent.nil?
1087
+ command.query['previewId'] = preview_id unless preview_id.nil?
1088
+ command.query['requestId'] = request_id unless request_id.nil?
1089
+ command.query['fields'] = fields unless fields.nil?
1090
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1091
+ execute_or_queue_command(command, &block)
1092
+ end
1093
+
1094
+ # Deletes a Preview.
1095
+ # @param [String] name
1096
+ # Required. The name of the Preview in the format: 'projects/`project_id`/
1097
+ # locations/`location`/previews/`preview`'.
1098
+ # @param [String] request_id
1099
+ # Optional. An optional request ID to identify requests. Specify a unique
1100
+ # request ID so that if you must retry your request, the server will know to
1101
+ # ignore the request if it has already been completed. The server will guarantee
1102
+ # that for at least 60 minutes after the first request. For example, consider a
1103
+ # situation where you make an initial request and the request times out. If you
1104
+ # make the request again with the same request ID, the server can check if
1105
+ # original operation with the same request ID was received, and if so, will
1106
+ # ignore the second request. This prevents clients from accidentally creating
1107
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1108
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1109
+ # @param [String] fields
1110
+ # Selector specifying which fields to include in a partial response.
1111
+ # @param [String] quota_user
1112
+ # Available to use for quota purposes for server-side applications. Can be any
1113
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1114
+ # @param [Google::Apis::RequestOptions] options
1115
+ # Request-specific options
1116
+ #
1117
+ # @yield [result, err] Result & error if block supplied
1118
+ # @yieldparam result [Google::Apis::ConfigV1::Operation] parsed result object
1119
+ # @yieldparam err [StandardError] error object if request failed
1120
+ #
1121
+ # @return [Google::Apis::ConfigV1::Operation]
1122
+ #
1123
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1124
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1125
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1126
+ def delete_project_location_preview(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1127
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1128
+ command.response_representation = Google::Apis::ConfigV1::Operation::Representation
1129
+ command.response_class = Google::Apis::ConfigV1::Operation
1130
+ command.params['name'] = name unless name.nil?
1131
+ command.query['requestId'] = request_id unless request_id.nil?
1132
+ command.query['fields'] = fields unless fields.nil?
1133
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1134
+ execute_or_queue_command(command, &block)
1135
+ end
1136
+
1137
+ # Export Preview results.
1138
+ # @param [String] parent
1139
+ # Required. The preview whose results should be exported. The preview value is
1140
+ # in the format: 'projects/`project_id`/locations/`location`/previews/`preview`'.
1141
+ # @param [Google::Apis::ConfigV1::ExportPreviewResultRequest] export_preview_result_request_object
1142
+ # @param [String] fields
1143
+ # Selector specifying which fields to include in a partial response.
1144
+ # @param [String] quota_user
1145
+ # Available to use for quota purposes for server-side applications. Can be any
1146
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1147
+ # @param [Google::Apis::RequestOptions] options
1148
+ # Request-specific options
1149
+ #
1150
+ # @yield [result, err] Result & error if block supplied
1151
+ # @yieldparam result [Google::Apis::ConfigV1::ExportPreviewResultResponse] parsed result object
1152
+ # @yieldparam err [StandardError] error object if request failed
1153
+ #
1154
+ # @return [Google::Apis::ConfigV1::ExportPreviewResultResponse]
1155
+ #
1156
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1157
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1158
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1159
+ def export_preview_result(parent, export_preview_result_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1160
+ command = make_simple_command(:post, 'v1/{+parent}:export', options)
1161
+ command.request_representation = Google::Apis::ConfigV1::ExportPreviewResultRequest::Representation
1162
+ command.request_object = export_preview_result_request_object
1163
+ command.response_representation = Google::Apis::ConfigV1::ExportPreviewResultResponse::Representation
1164
+ command.response_class = Google::Apis::ConfigV1::ExportPreviewResultResponse
1165
+ command.params['parent'] = parent unless parent.nil?
1166
+ command.query['fields'] = fields unless fields.nil?
1167
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1168
+ execute_or_queue_command(command, &block)
1169
+ end
1170
+
1171
+ # Gets details about a Preview.
1172
+ # @param [String] name
1173
+ # Required. The name of the preview. Format: 'projects/`project_id`/locations/`
1174
+ # location`/previews/`preview`'.
1175
+ # @param [String] fields
1176
+ # Selector specifying which fields to include in a partial response.
1177
+ # @param [String] quota_user
1178
+ # Available to use for quota purposes for server-side applications. Can be any
1179
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1180
+ # @param [Google::Apis::RequestOptions] options
1181
+ # Request-specific options
1182
+ #
1183
+ # @yield [result, err] Result & error if block supplied
1184
+ # @yieldparam result [Google::Apis::ConfigV1::Preview] parsed result object
1185
+ # @yieldparam err [StandardError] error object if request failed
1186
+ #
1187
+ # @return [Google::Apis::ConfigV1::Preview]
1188
+ #
1189
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1190
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1191
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1192
+ def get_project_location_preview(name, fields: nil, quota_user: nil, options: nil, &block)
1193
+ command = make_simple_command(:get, 'v1/{+name}', options)
1194
+ command.response_representation = Google::Apis::ConfigV1::Preview::Representation
1195
+ command.response_class = Google::Apis::ConfigV1::Preview
1196
+ command.params['name'] = name unless name.nil?
1197
+ command.query['fields'] = fields unless fields.nil?
1198
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1199
+ execute_or_queue_command(command, &block)
1200
+ end
1201
+
1202
+ # Lists Previews in a given project and location.
1203
+ # @param [String] parent
1204
+ # Required. The parent in whose context the Previews are listed. The parent
1205
+ # value is in the format: 'projects/`project_id`/locations/`location`'.
1206
+ # @param [String] filter
1207
+ # Optional. Lists the Deployments that match the filter expression. A filter
1208
+ # expression filters the resources listed in the response. The expression must
1209
+ # be of the form '`field` `operator` `value`' where operators: '<', '>', '<=', '>
1210
+ # =', '!=', '=', ':' are supported (colon ':' represents a HAS operator which is
1211
+ # roughly synonymous with equality). `field` can refer to a proto or JSON field,
1212
+ # or a synthetic field. Field names can be camelCase or snake_case. Examples: -
1213
+ # Filter by name: name = "projects/foo/locations/us-central1/deployments/bar -
1214
+ # Filter by labels: - Resources that have a key called 'foo' labels.foo:* -
1215
+ # Resources that have a key called 'foo' whose value is 'bar' labels.foo = bar -
1216
+ # Filter by state: - Deployments in CREATING state. state=CREATING
1217
+ # @param [String] order_by
1218
+ # Optional. Field to use to sort the list.
1219
+ # @param [Fixnum] page_size
1220
+ # Optional. When requesting a page of resources, 'page_size' specifies number of
1221
+ # resources to return. If unspecified, at most 500 will be returned. The maximum
1222
+ # value is 1000.
1223
+ # @param [String] page_token
1224
+ # Optional. Token returned by previous call to 'ListDeployments' which specifies
1225
+ # the position in the list from where to continue listing the resources.
1226
+ # @param [String] fields
1227
+ # Selector specifying which fields to include in a partial response.
1228
+ # @param [String] quota_user
1229
+ # Available to use for quota purposes for server-side applications. Can be any
1230
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1231
+ # @param [Google::Apis::RequestOptions] options
1232
+ # Request-specific options
1233
+ #
1234
+ # @yield [result, err] Result & error if block supplied
1235
+ # @yieldparam result [Google::Apis::ConfigV1::ListPreviewsResponse] parsed result object
1236
+ # @yieldparam err [StandardError] error object if request failed
1237
+ #
1238
+ # @return [Google::Apis::ConfigV1::ListPreviewsResponse]
1239
+ #
1240
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1241
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1242
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1243
+ def list_project_location_previews(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1244
+ command = make_simple_command(:get, 'v1/{+parent}/previews', options)
1245
+ command.response_representation = Google::Apis::ConfigV1::ListPreviewsResponse::Representation
1246
+ command.response_class = Google::Apis::ConfigV1::ListPreviewsResponse
1247
+ command.params['parent'] = parent unless parent.nil?
1248
+ command.query['filter'] = filter unless filter.nil?
1249
+ command.query['orderBy'] = order_by unless order_by.nil?
1250
+ command.query['pageSize'] = page_size unless page_size.nil?
1251
+ command.query['pageToken'] = page_token unless page_token.nil?
1252
+ command.query['fields'] = fields unless fields.nil?
1253
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1254
+ execute_or_queue_command(command, &block)
1255
+ end
1256
+
1257
+ # Gets details about a TerraformVersion.
1258
+ # @param [String] name
1259
+ # Required. The name of the TerraformVersion. Format: 'projects/`project_id`/
1260
+ # locations/`location`/terraformVersions/`terraform_version`'
1261
+ # @param [String] fields
1262
+ # Selector specifying which fields to include in a partial response.
1263
+ # @param [String] quota_user
1264
+ # Available to use for quota purposes for server-side applications. Can be any
1265
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1266
+ # @param [Google::Apis::RequestOptions] options
1267
+ # Request-specific options
1268
+ #
1269
+ # @yield [result, err] Result & error if block supplied
1270
+ # @yieldparam result [Google::Apis::ConfigV1::TerraformVersion] parsed result object
1271
+ # @yieldparam err [StandardError] error object if request failed
1272
+ #
1273
+ # @return [Google::Apis::ConfigV1::TerraformVersion]
1274
+ #
1275
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1276
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1277
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1278
+ def get_project_location_terraform_version(name, fields: nil, quota_user: nil, options: nil, &block)
1279
+ command = make_simple_command(:get, 'v1/{+name}', options)
1280
+ command.response_representation = Google::Apis::ConfigV1::TerraformVersion::Representation
1281
+ command.response_class = Google::Apis::ConfigV1::TerraformVersion
1282
+ command.params['name'] = name unless name.nil?
1283
+ command.query['fields'] = fields unless fields.nil?
1284
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1285
+ execute_or_queue_command(command, &block)
1286
+ end
1287
+
1288
+ # Lists TerraformVersions in a given project and location.
1289
+ # @param [String] parent
1290
+ # Required. The parent in whose context the TerraformVersions are listed. The
1291
+ # parent value is in the format: 'projects/`project_id`/locations/`location`'.
1292
+ # @param [String] filter
1293
+ # Optional. Lists the TerraformVersions that match the filter expression. A
1294
+ # filter expression filters the resources listed in the response. The expression
1295
+ # must be of the form '`field` `operator` `value`' where operators: '<', '>', '<=
1296
+ # ', '>=', '!=', '=', ':' are supported (colon ':' represents a HAS operator
1297
+ # which is roughly synonymous with equality). `field` can refer to a proto or
1298
+ # JSON field, or a synthetic field. Field names can be camelCase or snake_case.
1299
+ # @param [String] order_by
1300
+ # Optional. Field to use to sort the list.
1301
+ # @param [Fixnum] page_size
1302
+ # Optional. When requesting a page of resources, 'page_size' specifies number of
1303
+ # resources to return. If unspecified, at most 500 will be returned. The maximum
1304
+ # value is 1000.
1305
+ # @param [String] page_token
1306
+ # Optional. Token returned by previous call to 'ListTerraformVersions' which
1307
+ # specifies the position in the list from where to continue listing the
1308
+ # resources.
1309
+ # @param [String] fields
1310
+ # Selector specifying which fields to include in a partial response.
1311
+ # @param [String] quota_user
1312
+ # Available to use for quota purposes for server-side applications. Can be any
1313
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1314
+ # @param [Google::Apis::RequestOptions] options
1315
+ # Request-specific options
1316
+ #
1317
+ # @yield [result, err] Result & error if block supplied
1318
+ # @yieldparam result [Google::Apis::ConfigV1::ListTerraformVersionsResponse] parsed result object
1319
+ # @yieldparam err [StandardError] error object if request failed
1320
+ #
1321
+ # @return [Google::Apis::ConfigV1::ListTerraformVersionsResponse]
1322
+ #
1323
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1324
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1325
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1326
+ def list_project_location_terraform_versions(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1327
+ command = make_simple_command(:get, 'v1/{+parent}/terraformVersions', options)
1328
+ command.response_representation = Google::Apis::ConfigV1::ListTerraformVersionsResponse::Representation
1329
+ command.response_class = Google::Apis::ConfigV1::ListTerraformVersionsResponse
1330
+ command.params['parent'] = parent unless parent.nil?
1331
+ command.query['filter'] = filter unless filter.nil?
1332
+ command.query['orderBy'] = order_by unless order_by.nil?
1333
+ command.query['pageSize'] = page_size unless page_size.nil?
1334
+ command.query['pageToken'] = page_token unless page_token.nil?
1335
+ command.query['fields'] = fields unless fields.nil?
1336
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1337
+ execute_or_queue_command(command, &block)
1338
+ end
1339
+
1340
+ protected
1341
+
1342
+ def apply_command_defaults(command)
1343
+ command.query['key'] = key unless key.nil?
1344
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1345
+ end
1346
+ end
1347
+ end
1348
+ end
1349
+ end