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