google-apis-dataform_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,2744 @@
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 DataformV1
23
+ # Dataform API
24
+ #
25
+ # Service to develop, version control, and operationalize SQL pipelines in
26
+ # BigQuery.
27
+ #
28
+ # @example
29
+ # require 'google/apis/dataform_v1'
30
+ #
31
+ # Dataform = Google::Apis::DataformV1 # Alias the module
32
+ # service = Dataform::DataformService.new
33
+ #
34
+ # @see https://cloud.google.com/dataform/docs
35
+ class DataformService < Google::Apis::Core::BaseService
36
+ DEFAULT_ENDPOINT_TEMPLATE = "https://dataform.$UNIVERSE_DOMAIN$/"
37
+
38
+ # @return [String]
39
+ # API key. Your API key identifies your project and provides you with API access,
40
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
41
+ attr_accessor :key
42
+
43
+ # @return [String]
44
+ # Available to use for quota purposes for server-side applications. Can be any
45
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
46
+ attr_accessor :quota_user
47
+
48
+ def initialize
49
+ super(DEFAULT_ENDPOINT_TEMPLATE, '',
50
+ client_name: 'google-apis-dataform_v1',
51
+ client_version: Google::Apis::DataformV1::GEM_VERSION)
52
+ @batch_path = 'batch'
53
+ end
54
+
55
+ # Gets information about a location.
56
+ # @param [String] name
57
+ # Resource name for the location.
58
+ # @param [String] fields
59
+ # Selector specifying which fields to include in a partial response.
60
+ # @param [String] quota_user
61
+ # Available to use for quota purposes for server-side applications. Can be any
62
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
63
+ # @param [Google::Apis::RequestOptions] options
64
+ # Request-specific options
65
+ #
66
+ # @yield [result, err] Result & error if block supplied
67
+ # @yieldparam result [Google::Apis::DataformV1::Location] parsed result object
68
+ # @yieldparam err [StandardError] error object if request failed
69
+ #
70
+ # @return [Google::Apis::DataformV1::Location]
71
+ #
72
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
73
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
74
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
75
+ def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
76
+ command = make_simple_command(:get, 'v1/{+name}', options)
77
+ command.response_representation = Google::Apis::DataformV1::Location::Representation
78
+ command.response_class = Google::Apis::DataformV1::Location
79
+ command.params['name'] = name unless name.nil?
80
+ command.query['fields'] = fields unless fields.nil?
81
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
82
+ execute_or_queue_command(command, &block)
83
+ end
84
+
85
+ # Get default config for a given project and location.
86
+ # @param [String] name
87
+ # Required. The config name.
88
+ # @param [String] fields
89
+ # Selector specifying which fields to include in a partial response.
90
+ # @param [String] quota_user
91
+ # Available to use for quota purposes for server-side applications. Can be any
92
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
93
+ # @param [Google::Apis::RequestOptions] options
94
+ # Request-specific options
95
+ #
96
+ # @yield [result, err] Result & error if block supplied
97
+ # @yieldparam result [Google::Apis::DataformV1::Config] parsed result object
98
+ # @yieldparam err [StandardError] error object if request failed
99
+ #
100
+ # @return [Google::Apis::DataformV1::Config]
101
+ #
102
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
103
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
104
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
105
+ def get_project_location_config(name, fields: nil, quota_user: nil, options: nil, &block)
106
+ command = make_simple_command(:get, 'v1/{+name}', options)
107
+ command.response_representation = Google::Apis::DataformV1::Config::Representation
108
+ command.response_class = Google::Apis::DataformV1::Config
109
+ command.params['name'] = name unless name.nil?
110
+ command.query['fields'] = fields unless fields.nil?
111
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
112
+ execute_or_queue_command(command, &block)
113
+ end
114
+
115
+ # Lists information about the supported locations for this service.
116
+ # @param [String] name
117
+ # The resource that owns the locations collection, if applicable.
118
+ # @param [Array<String>, String] extra_location_types
119
+ # Optional. Unless explicitly documented otherwise, don't use this unsupported
120
+ # field which is primarily intended for internal usage.
121
+ # @param [String] filter
122
+ # A filter to narrow down results to a preferred subset. The filtering language
123
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
124
+ # in [AIP-160](https://google.aip.dev/160).
125
+ # @param [Fixnum] page_size
126
+ # The maximum number of results to return. If not set, the service selects a
127
+ # default.
128
+ # @param [String] page_token
129
+ # A page token received from the `next_page_token` field in the response. Send
130
+ # that page token to receive the subsequent page.
131
+ # @param [String] fields
132
+ # Selector specifying which fields to include in a partial response.
133
+ # @param [String] quota_user
134
+ # Available to use for quota purposes for server-side applications. Can be any
135
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
136
+ # @param [Google::Apis::RequestOptions] options
137
+ # Request-specific options
138
+ #
139
+ # @yield [result, err] Result & error if block supplied
140
+ # @yieldparam result [Google::Apis::DataformV1::ListLocationsResponse] parsed result object
141
+ # @yieldparam err [StandardError] error object if request failed
142
+ #
143
+ # @return [Google::Apis::DataformV1::ListLocationsResponse]
144
+ #
145
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
146
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
147
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
148
+ def list_project_locations(name, extra_location_types: nil, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
149
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
150
+ command.response_representation = Google::Apis::DataformV1::ListLocationsResponse::Representation
151
+ command.response_class = Google::Apis::DataformV1::ListLocationsResponse
152
+ command.params['name'] = name unless name.nil?
153
+ command.query['extraLocationTypes'] = extra_location_types unless extra_location_types.nil?
154
+ command.query['filter'] = filter unless filter.nil?
155
+ command.query['pageSize'] = page_size unless page_size.nil?
156
+ command.query['pageToken'] = page_token unless page_token.nil?
157
+ command.query['fields'] = fields unless fields.nil?
158
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
159
+ execute_or_queue_command(command, &block)
160
+ end
161
+
162
+ # Update default config for a given project and location. **Note:** *This method
163
+ # does not fully implement [AIP/134](https://google.aip.dev/134). The wildcard
164
+ # entry (\*) is treated as a bad request, and when the `field_mask` is omitted,
165
+ # the request is treated as a full update on all modifiable fields.*
166
+ # @param [String] name
167
+ # Identifier. The config name.
168
+ # @param [Google::Apis::DataformV1::Config] config_object
169
+ # @param [String] update_mask
170
+ # Optional. Specifies the fields to be updated in the config.
171
+ # @param [String] fields
172
+ # Selector specifying which fields to include in a partial response.
173
+ # @param [String] quota_user
174
+ # Available to use for quota purposes for server-side applications. Can be any
175
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
176
+ # @param [Google::Apis::RequestOptions] options
177
+ # Request-specific options
178
+ #
179
+ # @yield [result, err] Result & error if block supplied
180
+ # @yieldparam result [Google::Apis::DataformV1::Config] parsed result object
181
+ # @yieldparam err [StandardError] error object if request failed
182
+ #
183
+ # @return [Google::Apis::DataformV1::Config]
184
+ #
185
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
186
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
187
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
188
+ def update_project_location_config(name, config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
189
+ command = make_simple_command(:patch, 'v1/{+name}', options)
190
+ command.request_representation = Google::Apis::DataformV1::Config::Representation
191
+ command.request_object = config_object
192
+ command.response_representation = Google::Apis::DataformV1::Config::Representation
193
+ command.response_class = Google::Apis::DataformV1::Config
194
+ command.params['name'] = name unless name.nil?
195
+ command.query['updateMask'] = update_mask unless update_mask.nil?
196
+ command.query['fields'] = fields unless fields.nil?
197
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
198
+ execute_or_queue_command(command, &block)
199
+ end
200
+
201
+ # Gets the access control policy for a resource. Returns an empty policy if the
202
+ # resource exists and does not have a policy set.
203
+ # @param [String] resource
204
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
205
+ # names](https://cloud.google.com/apis/design/resource_names) for the
206
+ # appropriate value for this field.
207
+ # @param [Fixnum] options_requested_policy_version
208
+ # Optional. The maximum policy version that will be used to format the policy.
209
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
210
+ # rejected. Requests for policies with any conditional role bindings must
211
+ # specify version 3. Policies with no conditional role bindings may specify any
212
+ # valid value or leave the field unset. The policy in the response might use the
213
+ # policy version that you specified, or it might use a lower policy version. For
214
+ # example, if you specify version 3, but the policy has no conditional role
215
+ # bindings, the response uses version 1. To learn which resources support
216
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
217
+ # google.com/iam/help/conditions/resource-policies).
218
+ # @param [String] fields
219
+ # Selector specifying which fields to include in a partial response.
220
+ # @param [String] quota_user
221
+ # Available to use for quota purposes for server-side applications. Can be any
222
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
223
+ # @param [Google::Apis::RequestOptions] options
224
+ # Request-specific options
225
+ #
226
+ # @yield [result, err] Result & error if block supplied
227
+ # @yieldparam result [Google::Apis::DataformV1::Policy] parsed result object
228
+ # @yieldparam err [StandardError] error object if request failed
229
+ #
230
+ # @return [Google::Apis::DataformV1::Policy]
231
+ #
232
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
233
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
234
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
235
+ def get_project_location_folder_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
236
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
237
+ command.response_representation = Google::Apis::DataformV1::Policy::Representation
238
+ command.response_class = Google::Apis::DataformV1::Policy
239
+ command.params['resource'] = resource unless resource.nil?
240
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
241
+ command.query['fields'] = fields unless fields.nil?
242
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
243
+ execute_or_queue_command(command, &block)
244
+ end
245
+
246
+ # Sets the access control policy on the specified resource. Replaces any
247
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
248
+ # PERMISSION_DENIED` errors.
249
+ # @param [String] resource
250
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
251
+ # names](https://cloud.google.com/apis/design/resource_names) for the
252
+ # appropriate value for this field.
253
+ # @param [Google::Apis::DataformV1::SetIamPolicyRequest] set_iam_policy_request_object
254
+ # @param [String] fields
255
+ # Selector specifying which fields to include in a partial response.
256
+ # @param [String] quota_user
257
+ # Available to use for quota purposes for server-side applications. Can be any
258
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
259
+ # @param [Google::Apis::RequestOptions] options
260
+ # Request-specific options
261
+ #
262
+ # @yield [result, err] Result & error if block supplied
263
+ # @yieldparam result [Google::Apis::DataformV1::Policy] parsed result object
264
+ # @yieldparam err [StandardError] error object if request failed
265
+ #
266
+ # @return [Google::Apis::DataformV1::Policy]
267
+ #
268
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
269
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
270
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
271
+ def set_folder_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
272
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
273
+ command.request_representation = Google::Apis::DataformV1::SetIamPolicyRequest::Representation
274
+ command.request_object = set_iam_policy_request_object
275
+ command.response_representation = Google::Apis::DataformV1::Policy::Representation
276
+ command.response_class = Google::Apis::DataformV1::Policy
277
+ command.params['resource'] = resource unless resource.nil?
278
+ command.query['fields'] = fields unless fields.nil?
279
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
280
+ execute_or_queue_command(command, &block)
281
+ end
282
+
283
+ # Returns permissions that a caller has on the specified resource. If the
284
+ # resource does not exist, this will return an empty set of permissions, not a `
285
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
286
+ # permission-aware UIs and command-line tools, not for authorization checking.
287
+ # This operation may "fail open" without warning.
288
+ # @param [String] resource
289
+ # REQUIRED: The resource for which the policy detail is being requested. See [
290
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
291
+ # appropriate value for this field.
292
+ # @param [Google::Apis::DataformV1::TestIamPermissionsRequest] test_iam_permissions_request_object
293
+ # @param [String] fields
294
+ # Selector specifying which fields to include in a partial response.
295
+ # @param [String] quota_user
296
+ # Available to use for quota purposes for server-side applications. Can be any
297
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
298
+ # @param [Google::Apis::RequestOptions] options
299
+ # Request-specific options
300
+ #
301
+ # @yield [result, err] Result & error if block supplied
302
+ # @yieldparam result [Google::Apis::DataformV1::TestIamPermissionsResponse] parsed result object
303
+ # @yieldparam err [StandardError] error object if request failed
304
+ #
305
+ # @return [Google::Apis::DataformV1::TestIamPermissionsResponse]
306
+ #
307
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
308
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
309
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
310
+ def test_folder_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
311
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
312
+ command.request_representation = Google::Apis::DataformV1::TestIamPermissionsRequest::Representation
313
+ command.request_object = test_iam_permissions_request_object
314
+ command.response_representation = Google::Apis::DataformV1::TestIamPermissionsResponse::Representation
315
+ command.response_class = Google::Apis::DataformV1::TestIamPermissionsResponse
316
+ command.params['resource'] = resource unless resource.nil?
317
+ command.query['fields'] = fields unless fields.nil?
318
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
319
+ execute_or_queue_command(command, &block)
320
+ end
321
+
322
+ # Starts asynchronous cancellation on a long-running operation. The server makes
323
+ # a best effort to cancel the operation, but success is not guaranteed. If the
324
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
325
+ # Clients can use Operations.GetOperation or other methods to check whether the
326
+ # cancellation succeeded or whether the operation completed despite cancellation.
327
+ # On successful cancellation, the operation is not deleted; instead, it becomes
328
+ # an operation with an Operation.error value with a google.rpc.Status.code of `1`
329
+ # , corresponding to `Code.CANCELLED`.
330
+ # @param [String] name
331
+ # The name of the operation resource to be cancelled.
332
+ # @param [Google::Apis::DataformV1::CancelOperationRequest] cancel_operation_request_object
333
+ # @param [String] fields
334
+ # Selector specifying which fields to include in a partial response.
335
+ # @param [String] quota_user
336
+ # Available to use for quota purposes for server-side applications. Can be any
337
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
338
+ # @param [Google::Apis::RequestOptions] options
339
+ # Request-specific options
340
+ #
341
+ # @yield [result, err] Result & error if block supplied
342
+ # @yieldparam result [Google::Apis::DataformV1::Empty] parsed result object
343
+ # @yieldparam err [StandardError] error object if request failed
344
+ #
345
+ # @return [Google::Apis::DataformV1::Empty]
346
+ #
347
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
348
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
349
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
350
+ def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
351
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
352
+ command.request_representation = Google::Apis::DataformV1::CancelOperationRequest::Representation
353
+ command.request_object = cancel_operation_request_object
354
+ command.response_representation = Google::Apis::DataformV1::Empty::Representation
355
+ command.response_class = Google::Apis::DataformV1::Empty
356
+ command.params['name'] = name unless name.nil?
357
+ command.query['fields'] = fields unless fields.nil?
358
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
359
+ execute_or_queue_command(command, &block)
360
+ end
361
+
362
+ # Deletes a long-running operation. This method indicates that the client is no
363
+ # longer interested in the operation result. It does not cancel the operation.
364
+ # If the server doesn't support this method, it returns `google.rpc.Code.
365
+ # UNIMPLEMENTED`.
366
+ # @param [String] name
367
+ # The name of the operation resource to be deleted.
368
+ # @param [String] fields
369
+ # Selector specifying which fields to include in a partial response.
370
+ # @param [String] quota_user
371
+ # Available to use for quota purposes for server-side applications. Can be any
372
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
373
+ # @param [Google::Apis::RequestOptions] options
374
+ # Request-specific options
375
+ #
376
+ # @yield [result, err] Result & error if block supplied
377
+ # @yieldparam result [Google::Apis::DataformV1::Empty] parsed result object
378
+ # @yieldparam err [StandardError] error object if request failed
379
+ #
380
+ # @return [Google::Apis::DataformV1::Empty]
381
+ #
382
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
383
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
384
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
385
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
386
+ command = make_simple_command(:delete, 'v1/{+name}', options)
387
+ command.response_representation = Google::Apis::DataformV1::Empty::Representation
388
+ command.response_class = Google::Apis::DataformV1::Empty
389
+ command.params['name'] = name unless name.nil?
390
+ command.query['fields'] = fields unless fields.nil?
391
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
392
+ execute_or_queue_command(command, &block)
393
+ end
394
+
395
+ # Gets the latest state of a long-running operation. Clients can use this method
396
+ # to poll the operation result at intervals as recommended by the API service.
397
+ # @param [String] name
398
+ # The name of the operation resource.
399
+ # @param [String] fields
400
+ # Selector specifying which fields to include in a partial response.
401
+ # @param [String] quota_user
402
+ # Available to use for quota purposes for server-side applications. Can be any
403
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
404
+ # @param [Google::Apis::RequestOptions] options
405
+ # Request-specific options
406
+ #
407
+ # @yield [result, err] Result & error if block supplied
408
+ # @yieldparam result [Google::Apis::DataformV1::Operation] parsed result object
409
+ # @yieldparam err [StandardError] error object if request failed
410
+ #
411
+ # @return [Google::Apis::DataformV1::Operation]
412
+ #
413
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
414
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
415
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
416
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
417
+ command = make_simple_command(:get, 'v1/{+name}', options)
418
+ command.response_representation = Google::Apis::DataformV1::Operation::Representation
419
+ command.response_class = Google::Apis::DataformV1::Operation
420
+ command.params['name'] = name unless name.nil?
421
+ command.query['fields'] = fields unless fields.nil?
422
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
423
+ execute_or_queue_command(command, &block)
424
+ end
425
+
426
+ # Lists operations that match the specified filter in the request. If the server
427
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
428
+ # @param [String] name
429
+ # The name of the operation's parent resource.
430
+ # @param [String] filter
431
+ # The standard list filter.
432
+ # @param [Fixnum] page_size
433
+ # The standard list page size.
434
+ # @param [String] page_token
435
+ # The standard list page token.
436
+ # @param [Boolean] return_partial_success
437
+ # When set to `true`, operations that are reachable are returned as normal, and
438
+ # those that are unreachable are returned in the [ListOperationsResponse.
439
+ # unreachable] field. This can only be `true` when reading across collections e.
440
+ # g. when `parent` is set to `"projects/example/locations/-"`. This field is not
441
+ # by default supported and will result in an `UNIMPLEMENTED` error if set unless
442
+ # explicitly documented otherwise in service or product specific documentation.
443
+ # @param [String] fields
444
+ # Selector specifying which fields to include in a partial response.
445
+ # @param [String] quota_user
446
+ # Available to use for quota purposes for server-side applications. Can be any
447
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
448
+ # @param [Google::Apis::RequestOptions] options
449
+ # Request-specific options
450
+ #
451
+ # @yield [result, err] Result & error if block supplied
452
+ # @yieldparam result [Google::Apis::DataformV1::ListOperationsResponse] parsed result object
453
+ # @yieldparam err [StandardError] error object if request failed
454
+ #
455
+ # @return [Google::Apis::DataformV1::ListOperationsResponse]
456
+ #
457
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
458
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
459
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
460
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
461
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
462
+ command.response_representation = Google::Apis::DataformV1::ListOperationsResponse::Representation
463
+ command.response_class = Google::Apis::DataformV1::ListOperationsResponse
464
+ command.params['name'] = name unless name.nil?
465
+ command.query['filter'] = filter unless filter.nil?
466
+ command.query['pageSize'] = page_size unless page_size.nil?
467
+ command.query['pageToken'] = page_token unless page_token.nil?
468
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
469
+ command.query['fields'] = fields unless fields.nil?
470
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
471
+ execute_or_queue_command(command, &block)
472
+ end
473
+
474
+ # Applies a Git commit to a Repository. The Repository must not have a value for
475
+ # `git_remote_settings.url`.
476
+ # @param [String] name
477
+ # Required. The repository's name.
478
+ # @param [Google::Apis::DataformV1::CommitRepositoryChangesRequest] commit_repository_changes_request_object
479
+ # @param [String] fields
480
+ # Selector specifying which fields to include in a partial response.
481
+ # @param [String] quota_user
482
+ # Available to use for quota purposes for server-side applications. Can be any
483
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
484
+ # @param [Google::Apis::RequestOptions] options
485
+ # Request-specific options
486
+ #
487
+ # @yield [result, err] Result & error if block supplied
488
+ # @yieldparam result [Google::Apis::DataformV1::CommitRepositoryChangesResponse] parsed result object
489
+ # @yieldparam err [StandardError] error object if request failed
490
+ #
491
+ # @return [Google::Apis::DataformV1::CommitRepositoryChangesResponse]
492
+ #
493
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
494
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
495
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
496
+ def commit_repository_changes(name, commit_repository_changes_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
497
+ command = make_simple_command(:post, 'v1/{+name}:commit', options)
498
+ command.request_representation = Google::Apis::DataformV1::CommitRepositoryChangesRequest::Representation
499
+ command.request_object = commit_repository_changes_request_object
500
+ command.response_representation = Google::Apis::DataformV1::CommitRepositoryChangesResponse::Representation
501
+ command.response_class = Google::Apis::DataformV1::CommitRepositoryChangesResponse
502
+ command.params['name'] = name unless name.nil?
503
+ command.query['fields'] = fields unless fields.nil?
504
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
505
+ execute_or_queue_command(command, &block)
506
+ end
507
+
508
+ # Computes a Repository's Git access token status.
509
+ # @param [String] name
510
+ # Required. The repository's name.
511
+ # @param [String] fields
512
+ # Selector specifying which fields to include in a partial response.
513
+ # @param [String] quota_user
514
+ # Available to use for quota purposes for server-side applications. Can be any
515
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
516
+ # @param [Google::Apis::RequestOptions] options
517
+ # Request-specific options
518
+ #
519
+ # @yield [result, err] Result & error if block supplied
520
+ # @yieldparam result [Google::Apis::DataformV1::ComputeRepositoryAccessTokenStatusResponse] parsed result object
521
+ # @yieldparam err [StandardError] error object if request failed
522
+ #
523
+ # @return [Google::Apis::DataformV1::ComputeRepositoryAccessTokenStatusResponse]
524
+ #
525
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
526
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
527
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
528
+ def compute_project_location_repository_access_token_status(name, fields: nil, quota_user: nil, options: nil, &block)
529
+ command = make_simple_command(:get, 'v1/{+name}:computeAccessTokenStatus', options)
530
+ command.response_representation = Google::Apis::DataformV1::ComputeRepositoryAccessTokenStatusResponse::Representation
531
+ command.response_class = Google::Apis::DataformV1::ComputeRepositoryAccessTokenStatusResponse
532
+ command.params['name'] = name unless name.nil?
533
+ command.query['fields'] = fields unless fields.nil?
534
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
535
+ execute_or_queue_command(command, &block)
536
+ end
537
+
538
+ # Creates a new Repository in a given project and location.
539
+ # @param [String] parent
540
+ # Required. The location in which to create the repository. Must be in the
541
+ # format `projects/*/locations/*`.
542
+ # @param [Google::Apis::DataformV1::Repository] repository_object
543
+ # @param [String] repository_id
544
+ # Required. The ID to use for the repository, which will become the final
545
+ # component of the repository's resource name.
546
+ # @param [String] fields
547
+ # Selector specifying which fields to include in a partial response.
548
+ # @param [String] quota_user
549
+ # Available to use for quota purposes for server-side applications. Can be any
550
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
551
+ # @param [Google::Apis::RequestOptions] options
552
+ # Request-specific options
553
+ #
554
+ # @yield [result, err] Result & error if block supplied
555
+ # @yieldparam result [Google::Apis::DataformV1::Repository] parsed result object
556
+ # @yieldparam err [StandardError] error object if request failed
557
+ #
558
+ # @return [Google::Apis::DataformV1::Repository]
559
+ #
560
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
561
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
562
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
563
+ def create_project_location_repository(parent, repository_object = nil, repository_id: nil, fields: nil, quota_user: nil, options: nil, &block)
564
+ command = make_simple_command(:post, 'v1/{+parent}/repositories', options)
565
+ command.request_representation = Google::Apis::DataformV1::Repository::Representation
566
+ command.request_object = repository_object
567
+ command.response_representation = Google::Apis::DataformV1::Repository::Representation
568
+ command.response_class = Google::Apis::DataformV1::Repository
569
+ command.params['parent'] = parent unless parent.nil?
570
+ command.query['repositoryId'] = repository_id unless repository_id.nil?
571
+ command.query['fields'] = fields unless fields.nil?
572
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
573
+ execute_or_queue_command(command, &block)
574
+ end
575
+
576
+ # Deletes a single Repository.
577
+ # @param [String] name
578
+ # Required. The repository's name.
579
+ # @param [Boolean] force
580
+ # Optional. If set to true, child resources of this repository (compilation
581
+ # results and workflow invocations) will also be deleted. Otherwise, the request
582
+ # will only succeed if the repository has no child resources. **Note:** *This
583
+ # flag doesn't support deletion of workspaces, release configs or workflow
584
+ # configs. If any of such resources exists in the repository, the request will
585
+ # fail.*.
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::DataformV1::Empty] parsed result object
596
+ # @yieldparam err [StandardError] error object if request failed
597
+ #
598
+ # @return [Google::Apis::DataformV1::Empty]
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 delete_project_location_repository(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
604
+ command = make_simple_command(:delete, 'v1/{+name}', options)
605
+ command.response_representation = Google::Apis::DataformV1::Empty::Representation
606
+ command.response_class = Google::Apis::DataformV1::Empty
607
+ command.params['name'] = name unless name.nil?
608
+ command.query['force'] = force unless force.nil?
609
+ command.query['fields'] = fields unless fields.nil?
610
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
611
+ execute_or_queue_command(command, &block)
612
+ end
613
+
614
+ # Fetches a Repository's history of commits. The Repository must not have a
615
+ # value for `git_remote_settings.url`.
616
+ # @param [String] name
617
+ # Required. The repository's name.
618
+ # @param [Fixnum] page_size
619
+ # Optional. Maximum number of commits to return. The server may return fewer
620
+ # items than requested. If unspecified, the server will pick an appropriate
621
+ # default.
622
+ # @param [String] page_token
623
+ # Optional. Page token received from a previous `FetchRepositoryHistory` call.
624
+ # Provide this to retrieve the subsequent page. When paginating, all other
625
+ # parameters provided to `FetchRepositoryHistory`, with the exception of `
626
+ # page_size`, must match the call that provided the page token.
627
+ # @param [String] fields
628
+ # Selector specifying which fields to include in a partial response.
629
+ # @param [String] quota_user
630
+ # Available to use for quota purposes for server-side applications. Can be any
631
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
632
+ # @param [Google::Apis::RequestOptions] options
633
+ # Request-specific options
634
+ #
635
+ # @yield [result, err] Result & error if block supplied
636
+ # @yieldparam result [Google::Apis::DataformV1::FetchRepositoryHistoryResponse] parsed result object
637
+ # @yieldparam err [StandardError] error object if request failed
638
+ #
639
+ # @return [Google::Apis::DataformV1::FetchRepositoryHistoryResponse]
640
+ #
641
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
642
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
643
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
644
+ def fetch_project_location_repository_history(name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
645
+ command = make_simple_command(:get, 'v1/{+name}:fetchHistory', options)
646
+ command.response_representation = Google::Apis::DataformV1::FetchRepositoryHistoryResponse::Representation
647
+ command.response_class = Google::Apis::DataformV1::FetchRepositoryHistoryResponse
648
+ command.params['name'] = name unless name.nil?
649
+ command.query['pageSize'] = page_size unless page_size.nil?
650
+ command.query['pageToken'] = page_token unless page_token.nil?
651
+ command.query['fields'] = fields unless fields.nil?
652
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
653
+ execute_or_queue_command(command, &block)
654
+ end
655
+
656
+ # Fetches a Repository's remote branches.
657
+ # @param [String] name
658
+ # Required. The repository's name.
659
+ # @param [String] fields
660
+ # Selector specifying which fields to include in a partial response.
661
+ # @param [String] quota_user
662
+ # Available to use for quota purposes for server-side applications. Can be any
663
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
664
+ # @param [Google::Apis::RequestOptions] options
665
+ # Request-specific options
666
+ #
667
+ # @yield [result, err] Result & error if block supplied
668
+ # @yieldparam result [Google::Apis::DataformV1::FetchRemoteBranchesResponse] parsed result object
669
+ # @yieldparam err [StandardError] error object if request failed
670
+ #
671
+ # @return [Google::Apis::DataformV1::FetchRemoteBranchesResponse]
672
+ #
673
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
674
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
675
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
676
+ def fetch_project_location_repository_remote_branches(name, fields: nil, quota_user: nil, options: nil, &block)
677
+ command = make_simple_command(:get, 'v1/{+name}:fetchRemoteBranches', options)
678
+ command.response_representation = Google::Apis::DataformV1::FetchRemoteBranchesResponse::Representation
679
+ command.response_class = Google::Apis::DataformV1::FetchRemoteBranchesResponse
680
+ command.params['name'] = name unless name.nil?
681
+ command.query['fields'] = fields unless fields.nil?
682
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
683
+ execute_or_queue_command(command, &block)
684
+ end
685
+
686
+ # Fetches a single Repository.
687
+ # @param [String] name
688
+ # Required. The repository's name.
689
+ # @param [String] fields
690
+ # Selector specifying which fields to include in a partial response.
691
+ # @param [String] quota_user
692
+ # Available to use for quota purposes for server-side applications. Can be any
693
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
694
+ # @param [Google::Apis::RequestOptions] options
695
+ # Request-specific options
696
+ #
697
+ # @yield [result, err] Result & error if block supplied
698
+ # @yieldparam result [Google::Apis::DataformV1::Repository] parsed result object
699
+ # @yieldparam err [StandardError] error object if request failed
700
+ #
701
+ # @return [Google::Apis::DataformV1::Repository]
702
+ #
703
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
704
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
705
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
706
+ def get_project_location_repository(name, fields: nil, quota_user: nil, options: nil, &block)
707
+ command = make_simple_command(:get, 'v1/{+name}', options)
708
+ command.response_representation = Google::Apis::DataformV1::Repository::Representation
709
+ command.response_class = Google::Apis::DataformV1::Repository
710
+ command.params['name'] = name unless name.nil?
711
+ command.query['fields'] = fields unless fields.nil?
712
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
713
+ execute_or_queue_command(command, &block)
714
+ end
715
+
716
+ # Gets the access control policy for a resource. Returns an empty policy if the
717
+ # resource exists and does not have a policy set.
718
+ # @param [String] resource
719
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
720
+ # names](https://cloud.google.com/apis/design/resource_names) for the
721
+ # appropriate value for this field.
722
+ # @param [Fixnum] options_requested_policy_version
723
+ # Optional. The maximum policy version that will be used to format the policy.
724
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
725
+ # rejected. Requests for policies with any conditional role bindings must
726
+ # specify version 3. Policies with no conditional role bindings may specify any
727
+ # valid value or leave the field unset. The policy in the response might use the
728
+ # policy version that you specified, or it might use a lower policy version. For
729
+ # example, if you specify version 3, but the policy has no conditional role
730
+ # bindings, the response uses version 1. To learn which resources support
731
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
732
+ # google.com/iam/help/conditions/resource-policies).
733
+ # @param [String] fields
734
+ # Selector specifying which fields to include in a partial response.
735
+ # @param [String] quota_user
736
+ # Available to use for quota purposes for server-side applications. Can be any
737
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
738
+ # @param [Google::Apis::RequestOptions] options
739
+ # Request-specific options
740
+ #
741
+ # @yield [result, err] Result & error if block supplied
742
+ # @yieldparam result [Google::Apis::DataformV1::Policy] parsed result object
743
+ # @yieldparam err [StandardError] error object if request failed
744
+ #
745
+ # @return [Google::Apis::DataformV1::Policy]
746
+ #
747
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
748
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
749
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
750
+ def get_project_location_repository_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
751
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
752
+ command.response_representation = Google::Apis::DataformV1::Policy::Representation
753
+ command.response_class = Google::Apis::DataformV1::Policy
754
+ command.params['resource'] = resource unless resource.nil?
755
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
756
+ command.query['fields'] = fields unless fields.nil?
757
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
758
+ execute_or_queue_command(command, &block)
759
+ end
760
+
761
+ # Lists Repositories in a given project and location. **Note:** *This method can
762
+ # return repositories not shown in the [Dataform UI](https://console.cloud.
763
+ # google.com/bigquery/dataform)*.
764
+ # @param [String] parent
765
+ # Required. The location in which to list repositories. Must be in the format `
766
+ # projects/*/locations/*`.
767
+ # @param [String] filter
768
+ # Optional. Filter for the returned list.
769
+ # @param [String] order_by
770
+ # Optional. This field only supports ordering by `name`. If unspecified, the
771
+ # server will choose the ordering. If specified, the default order is ascending
772
+ # for the `name` field.
773
+ # @param [Fixnum] page_size
774
+ # Optional. Maximum number of repositories to return. The server may return
775
+ # fewer items than requested. If unspecified, the server will pick an
776
+ # appropriate default.
777
+ # @param [String] page_token
778
+ # Optional. Page token received from a previous `ListRepositories` call. Provide
779
+ # this to retrieve the subsequent page. When paginating, all other parameters
780
+ # provided to `ListRepositories`, with the exception of `page_size`, must match
781
+ # the call that provided the page token.
782
+ # @param [String] fields
783
+ # Selector specifying which fields to include in a partial response.
784
+ # @param [String] quota_user
785
+ # Available to use for quota purposes for server-side applications. Can be any
786
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
787
+ # @param [Google::Apis::RequestOptions] options
788
+ # Request-specific options
789
+ #
790
+ # @yield [result, err] Result & error if block supplied
791
+ # @yieldparam result [Google::Apis::DataformV1::ListRepositoriesResponse] parsed result object
792
+ # @yieldparam err [StandardError] error object if request failed
793
+ #
794
+ # @return [Google::Apis::DataformV1::ListRepositoriesResponse]
795
+ #
796
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
797
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
798
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
799
+ def list_project_location_repositories(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
800
+ command = make_simple_command(:get, 'v1/{+parent}/repositories', options)
801
+ command.response_representation = Google::Apis::DataformV1::ListRepositoriesResponse::Representation
802
+ command.response_class = Google::Apis::DataformV1::ListRepositoriesResponse
803
+ command.params['parent'] = parent unless parent.nil?
804
+ command.query['filter'] = filter unless filter.nil?
805
+ command.query['orderBy'] = order_by unless order_by.nil?
806
+ command.query['pageSize'] = page_size unless page_size.nil?
807
+ command.query['pageToken'] = page_token unless page_token.nil?
808
+ command.query['fields'] = fields unless fields.nil?
809
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
810
+ execute_or_queue_command(command, &block)
811
+ end
812
+
813
+ # Updates a single Repository. **Note:** *This method does not fully implement [
814
+ # AIP/134](https://google.aip.dev/134). The wildcard entry (\*) is treated as a
815
+ # bad request, and when the `field_mask` is omitted, the request is treated as a
816
+ # full update on all modifiable fields.*
817
+ # @param [String] name
818
+ # Identifier. The repository's name.
819
+ # @param [Google::Apis::DataformV1::Repository] repository_object
820
+ # @param [String] update_mask
821
+ # Optional. Specifies the fields to be updated in the repository. If left unset,
822
+ # all fields will be updated.
823
+ # @param [String] fields
824
+ # Selector specifying which fields to include in a partial response.
825
+ # @param [String] quota_user
826
+ # Available to use for quota purposes for server-side applications. Can be any
827
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
828
+ # @param [Google::Apis::RequestOptions] options
829
+ # Request-specific options
830
+ #
831
+ # @yield [result, err] Result & error if block supplied
832
+ # @yieldparam result [Google::Apis::DataformV1::Repository] parsed result object
833
+ # @yieldparam err [StandardError] error object if request failed
834
+ #
835
+ # @return [Google::Apis::DataformV1::Repository]
836
+ #
837
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
838
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
839
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
840
+ def patch_project_location_repository(name, repository_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
841
+ command = make_simple_command(:patch, 'v1/{+name}', options)
842
+ command.request_representation = Google::Apis::DataformV1::Repository::Representation
843
+ command.request_object = repository_object
844
+ command.response_representation = Google::Apis::DataformV1::Repository::Representation
845
+ command.response_class = Google::Apis::DataformV1::Repository
846
+ command.params['name'] = name unless name.nil?
847
+ command.query['updateMask'] = update_mask unless update_mask.nil?
848
+ command.query['fields'] = fields unless fields.nil?
849
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
850
+ execute_or_queue_command(command, &block)
851
+ end
852
+
853
+ # Returns the contents of a given Repository directory. The Repository must not
854
+ # have a value for `git_remote_settings.url`.
855
+ # @param [String] name
856
+ # Required. The repository's name.
857
+ # @param [String] commit_sha
858
+ # Optional. The Commit SHA for the commit to query from. If unset, the directory
859
+ # will be queried from HEAD.
860
+ # @param [Fixnum] page_size
861
+ # Optional. Maximum number of paths to return. The server may return fewer items
862
+ # than requested. If unspecified, the server will pick an appropriate default.
863
+ # @param [String] page_token
864
+ # Optional. Page token received from a previous `
865
+ # QueryRepositoryDirectoryContents` call. Provide this to retrieve the
866
+ # subsequent page. When paginating, all other parameters provided to `
867
+ # QueryRepositoryDirectoryContents`, with the exception of `page_size`, must
868
+ # match the call that provided the page token.
869
+ # @param [String] path
870
+ # Optional. The directory's full path including directory name, relative to root.
871
+ # If left unset, the root is used.
872
+ # @param [String] fields
873
+ # Selector specifying which fields to include in a partial response.
874
+ # @param [String] quota_user
875
+ # Available to use for quota purposes for server-side applications. Can be any
876
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
877
+ # @param [Google::Apis::RequestOptions] options
878
+ # Request-specific options
879
+ #
880
+ # @yield [result, err] Result & error if block supplied
881
+ # @yieldparam result [Google::Apis::DataformV1::QueryRepositoryDirectoryContentsResponse] parsed result object
882
+ # @yieldparam err [StandardError] error object if request failed
883
+ #
884
+ # @return [Google::Apis::DataformV1::QueryRepositoryDirectoryContentsResponse]
885
+ #
886
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
887
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
888
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
889
+ def query_project_location_repository_directory_contents(name, commit_sha: nil, page_size: nil, page_token: nil, path: nil, fields: nil, quota_user: nil, options: nil, &block)
890
+ command = make_simple_command(:get, 'v1/{+name}:queryDirectoryContents', options)
891
+ command.response_representation = Google::Apis::DataformV1::QueryRepositoryDirectoryContentsResponse::Representation
892
+ command.response_class = Google::Apis::DataformV1::QueryRepositoryDirectoryContentsResponse
893
+ command.params['name'] = name unless name.nil?
894
+ command.query['commitSha'] = commit_sha unless commit_sha.nil?
895
+ command.query['pageSize'] = page_size unless page_size.nil?
896
+ command.query['pageToken'] = page_token unless page_token.nil?
897
+ command.query['path'] = path unless path.nil?
898
+ command.query['fields'] = fields unless fields.nil?
899
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
900
+ execute_or_queue_command(command, &block)
901
+ end
902
+
903
+ # Returns the contents of a file (inside a Repository). The Repository must not
904
+ # have a value for `git_remote_settings.url`.
905
+ # @param [String] name
906
+ # Required. The repository's name.
907
+ # @param [String] commit_sha
908
+ # Optional. The commit SHA for the commit to read from. If unset, the file will
909
+ # be read from HEAD.
910
+ # @param [String] path
911
+ # Required. Full file path to read including filename, from repository root.
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::DataformV1::ReadRepositoryFileResponse] parsed result object
922
+ # @yieldparam err [StandardError] error object if request failed
923
+ #
924
+ # @return [Google::Apis::DataformV1::ReadRepositoryFileResponse]
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 read_project_location_repository_file(name, commit_sha: nil, path: nil, fields: nil, quota_user: nil, options: nil, &block)
930
+ command = make_simple_command(:get, 'v1/{+name}:readFile', options)
931
+ command.response_representation = Google::Apis::DataformV1::ReadRepositoryFileResponse::Representation
932
+ command.response_class = Google::Apis::DataformV1::ReadRepositoryFileResponse
933
+ command.params['name'] = name unless name.nil?
934
+ command.query['commitSha'] = commit_sha unless commit_sha.nil?
935
+ command.query['path'] = path unless path.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
+ # Sets the access control policy on the specified resource. Replaces any
942
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
943
+ # PERMISSION_DENIED` errors.
944
+ # @param [String] resource
945
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
946
+ # names](https://cloud.google.com/apis/design/resource_names) for the
947
+ # appropriate value for this field.
948
+ # @param [Google::Apis::DataformV1::SetIamPolicyRequest] set_iam_policy_request_object
949
+ # @param [String] fields
950
+ # Selector specifying which fields to include in a partial response.
951
+ # @param [String] quota_user
952
+ # Available to use for quota purposes for server-side applications. Can be any
953
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
954
+ # @param [Google::Apis::RequestOptions] options
955
+ # Request-specific options
956
+ #
957
+ # @yield [result, err] Result & error if block supplied
958
+ # @yieldparam result [Google::Apis::DataformV1::Policy] parsed result object
959
+ # @yieldparam err [StandardError] error object if request failed
960
+ #
961
+ # @return [Google::Apis::DataformV1::Policy]
962
+ #
963
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
964
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
965
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
966
+ def set_repository_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
967
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
968
+ command.request_representation = Google::Apis::DataformV1::SetIamPolicyRequest::Representation
969
+ command.request_object = set_iam_policy_request_object
970
+ command.response_representation = Google::Apis::DataformV1::Policy::Representation
971
+ command.response_class = Google::Apis::DataformV1::Policy
972
+ command.params['resource'] = resource unless resource.nil?
973
+ command.query['fields'] = fields unless fields.nil?
974
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
975
+ execute_or_queue_command(command, &block)
976
+ end
977
+
978
+ # Returns permissions that a caller has on the specified resource. If the
979
+ # resource does not exist, this will return an empty set of permissions, not a `
980
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
981
+ # permission-aware UIs and command-line tools, not for authorization checking.
982
+ # This operation may "fail open" without warning.
983
+ # @param [String] resource
984
+ # REQUIRED: The resource for which the policy detail is being requested. See [
985
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
986
+ # appropriate value for this field.
987
+ # @param [Google::Apis::DataformV1::TestIamPermissionsRequest] test_iam_permissions_request_object
988
+ # @param [String] fields
989
+ # Selector specifying which fields to include in a partial response.
990
+ # @param [String] quota_user
991
+ # Available to use for quota purposes for server-side applications. Can be any
992
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
993
+ # @param [Google::Apis::RequestOptions] options
994
+ # Request-specific options
995
+ #
996
+ # @yield [result, err] Result & error if block supplied
997
+ # @yieldparam result [Google::Apis::DataformV1::TestIamPermissionsResponse] parsed result object
998
+ # @yieldparam err [StandardError] error object if request failed
999
+ #
1000
+ # @return [Google::Apis::DataformV1::TestIamPermissionsResponse]
1001
+ #
1002
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1003
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1004
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1005
+ def test_repository_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1006
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1007
+ command.request_representation = Google::Apis::DataformV1::TestIamPermissionsRequest::Representation
1008
+ command.request_object = test_iam_permissions_request_object
1009
+ command.response_representation = Google::Apis::DataformV1::TestIamPermissionsResponse::Representation
1010
+ command.response_class = Google::Apis::DataformV1::TestIamPermissionsResponse
1011
+ command.params['resource'] = resource unless resource.nil?
1012
+ command.query['fields'] = fields unless fields.nil?
1013
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1014
+ execute_or_queue_command(command, &block)
1015
+ end
1016
+
1017
+ # Creates a new CompilationResult in a given project and location.
1018
+ # @param [String] parent
1019
+ # Required. The repository in which to create the compilation result. Must be in
1020
+ # the format `projects/*/locations/*/repositories/*`.
1021
+ # @param [Google::Apis::DataformV1::CompilationResult] compilation_result_object
1022
+ # @param [String] fields
1023
+ # Selector specifying which fields to include in a partial response.
1024
+ # @param [String] quota_user
1025
+ # Available to use for quota purposes for server-side applications. Can be any
1026
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1027
+ # @param [Google::Apis::RequestOptions] options
1028
+ # Request-specific options
1029
+ #
1030
+ # @yield [result, err] Result & error if block supplied
1031
+ # @yieldparam result [Google::Apis::DataformV1::CompilationResult] parsed result object
1032
+ # @yieldparam err [StandardError] error object if request failed
1033
+ #
1034
+ # @return [Google::Apis::DataformV1::CompilationResult]
1035
+ #
1036
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1037
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1038
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1039
+ def create_project_location_repository_compilation_result(parent, compilation_result_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1040
+ command = make_simple_command(:post, 'v1/{+parent}/compilationResults', options)
1041
+ command.request_representation = Google::Apis::DataformV1::CompilationResult::Representation
1042
+ command.request_object = compilation_result_object
1043
+ command.response_representation = Google::Apis::DataformV1::CompilationResult::Representation
1044
+ command.response_class = Google::Apis::DataformV1::CompilationResult
1045
+ command.params['parent'] = parent unless parent.nil?
1046
+ command.query['fields'] = fields unless fields.nil?
1047
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1048
+ execute_or_queue_command(command, &block)
1049
+ end
1050
+
1051
+ # Fetches a single CompilationResult.
1052
+ # @param [String] name
1053
+ # Required. The compilation result's name.
1054
+ # @param [String] fields
1055
+ # Selector specifying which fields to include in a partial response.
1056
+ # @param [String] quota_user
1057
+ # Available to use for quota purposes for server-side applications. Can be any
1058
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1059
+ # @param [Google::Apis::RequestOptions] options
1060
+ # Request-specific options
1061
+ #
1062
+ # @yield [result, err] Result & error if block supplied
1063
+ # @yieldparam result [Google::Apis::DataformV1::CompilationResult] parsed result object
1064
+ # @yieldparam err [StandardError] error object if request failed
1065
+ #
1066
+ # @return [Google::Apis::DataformV1::CompilationResult]
1067
+ #
1068
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1069
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1070
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1071
+ def get_project_location_repository_compilation_result(name, fields: nil, quota_user: nil, options: nil, &block)
1072
+ command = make_simple_command(:get, 'v1/{+name}', options)
1073
+ command.response_representation = Google::Apis::DataformV1::CompilationResult::Representation
1074
+ command.response_class = Google::Apis::DataformV1::CompilationResult
1075
+ command.params['name'] = name unless name.nil?
1076
+ command.query['fields'] = fields unless fields.nil?
1077
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1078
+ execute_or_queue_command(command, &block)
1079
+ end
1080
+
1081
+ # Lists CompilationResults in a given Repository.
1082
+ # @param [String] parent
1083
+ # Required. The repository in which to list compilation results. Must be in the
1084
+ # format `projects/*/locations/*/repositories/*`.
1085
+ # @param [String] filter
1086
+ # Optional. Filter for the returned list.
1087
+ # @param [String] order_by
1088
+ # Optional. This field only supports ordering by `name` and `create_time`. If
1089
+ # unspecified, the server will choose the ordering. If specified, the default
1090
+ # order is ascending for the `name` field.
1091
+ # @param [Fixnum] page_size
1092
+ # Optional. Maximum number of compilation results to return. The server may
1093
+ # return fewer items than requested. If unspecified, the server will pick an
1094
+ # appropriate default.
1095
+ # @param [String] page_token
1096
+ # Optional. Page token received from a previous `ListCompilationResults` call.
1097
+ # Provide this to retrieve the subsequent page. When paginating, all other
1098
+ # parameters provided to `ListCompilationResults`, with the exception of `
1099
+ # page_size`, must match the call that provided the page token.
1100
+ # @param [String] fields
1101
+ # Selector specifying which fields to include in a partial response.
1102
+ # @param [String] quota_user
1103
+ # Available to use for quota purposes for server-side applications. Can be any
1104
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1105
+ # @param [Google::Apis::RequestOptions] options
1106
+ # Request-specific options
1107
+ #
1108
+ # @yield [result, err] Result & error if block supplied
1109
+ # @yieldparam result [Google::Apis::DataformV1::ListCompilationResultsResponse] parsed result object
1110
+ # @yieldparam err [StandardError] error object if request failed
1111
+ #
1112
+ # @return [Google::Apis::DataformV1::ListCompilationResultsResponse]
1113
+ #
1114
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1115
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1116
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1117
+ def list_project_location_repository_compilation_results(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1118
+ command = make_simple_command(:get, 'v1/{+parent}/compilationResults', options)
1119
+ command.response_representation = Google::Apis::DataformV1::ListCompilationResultsResponse::Representation
1120
+ command.response_class = Google::Apis::DataformV1::ListCompilationResultsResponse
1121
+ command.params['parent'] = parent unless parent.nil?
1122
+ command.query['filter'] = filter unless filter.nil?
1123
+ command.query['orderBy'] = order_by unless order_by.nil?
1124
+ command.query['pageSize'] = page_size unless page_size.nil?
1125
+ command.query['pageToken'] = page_token unless page_token.nil?
1126
+ command.query['fields'] = fields unless fields.nil?
1127
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1128
+ execute_or_queue_command(command, &block)
1129
+ end
1130
+
1131
+ # Returns CompilationResultActions in a given CompilationResult.
1132
+ # @param [String] name
1133
+ # Required. The compilation result's name.
1134
+ # @param [String] filter
1135
+ # Optional. Optional filter for the returned list. Filtering is only currently
1136
+ # supported on the `file_path` field.
1137
+ # @param [Fixnum] page_size
1138
+ # Optional. Maximum number of compilation results to return. The server may
1139
+ # return fewer items than requested. If unspecified, the server will pick an
1140
+ # appropriate default.
1141
+ # @param [String] page_token
1142
+ # Optional. Page token received from a previous `QueryCompilationResultActions`
1143
+ # call. Provide this to retrieve the subsequent page. When paginating, all other
1144
+ # parameters provided to `QueryCompilationResultActions`, with the exception of `
1145
+ # page_size`, must match the call that provided the page token.
1146
+ # @param [String] fields
1147
+ # Selector specifying which fields to include in a partial response.
1148
+ # @param [String] quota_user
1149
+ # Available to use for quota purposes for server-side applications. Can be any
1150
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1151
+ # @param [Google::Apis::RequestOptions] options
1152
+ # Request-specific options
1153
+ #
1154
+ # @yield [result, err] Result & error if block supplied
1155
+ # @yieldparam result [Google::Apis::DataformV1::QueryCompilationResultActionsResponse] parsed result object
1156
+ # @yieldparam err [StandardError] error object if request failed
1157
+ #
1158
+ # @return [Google::Apis::DataformV1::QueryCompilationResultActionsResponse]
1159
+ #
1160
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1161
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1162
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1163
+ def query_project_location_repository_compilation_result(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1164
+ command = make_simple_command(:get, 'v1/{+name}:query', options)
1165
+ command.response_representation = Google::Apis::DataformV1::QueryCompilationResultActionsResponse::Representation
1166
+ command.response_class = Google::Apis::DataformV1::QueryCompilationResultActionsResponse
1167
+ command.params['name'] = name unless name.nil?
1168
+ command.query['filter'] = filter unless filter.nil?
1169
+ command.query['pageSize'] = page_size unless page_size.nil?
1170
+ command.query['pageToken'] = page_token unless page_token.nil?
1171
+ command.query['fields'] = fields unless fields.nil?
1172
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1173
+ execute_or_queue_command(command, &block)
1174
+ end
1175
+
1176
+ # Creates a new ReleaseConfig in a given Repository.
1177
+ # @param [String] parent
1178
+ # Required. The repository in which to create the release config. Must be in the
1179
+ # format `projects/*/locations/*/repositories/*`.
1180
+ # @param [Google::Apis::DataformV1::ReleaseConfig] release_config_object
1181
+ # @param [String] release_config_id
1182
+ # Required. The ID to use for the release config, which will become the final
1183
+ # component of the release config's resource name.
1184
+ # @param [String] fields
1185
+ # Selector specifying which fields to include in a partial response.
1186
+ # @param [String] quota_user
1187
+ # Available to use for quota purposes for server-side applications. Can be any
1188
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1189
+ # @param [Google::Apis::RequestOptions] options
1190
+ # Request-specific options
1191
+ #
1192
+ # @yield [result, err] Result & error if block supplied
1193
+ # @yieldparam result [Google::Apis::DataformV1::ReleaseConfig] parsed result object
1194
+ # @yieldparam err [StandardError] error object if request failed
1195
+ #
1196
+ # @return [Google::Apis::DataformV1::ReleaseConfig]
1197
+ #
1198
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1199
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1200
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1201
+ def create_project_location_repository_release_config(parent, release_config_object = nil, release_config_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1202
+ command = make_simple_command(:post, 'v1/{+parent}/releaseConfigs', options)
1203
+ command.request_representation = Google::Apis::DataformV1::ReleaseConfig::Representation
1204
+ command.request_object = release_config_object
1205
+ command.response_representation = Google::Apis::DataformV1::ReleaseConfig::Representation
1206
+ command.response_class = Google::Apis::DataformV1::ReleaseConfig
1207
+ command.params['parent'] = parent unless parent.nil?
1208
+ command.query['releaseConfigId'] = release_config_id unless release_config_id.nil?
1209
+ command.query['fields'] = fields unless fields.nil?
1210
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1211
+ execute_or_queue_command(command, &block)
1212
+ end
1213
+
1214
+ # Deletes a single ReleaseConfig.
1215
+ # @param [String] name
1216
+ # Required. The release config's name.
1217
+ # @param [String] fields
1218
+ # Selector specifying which fields to include in a partial response.
1219
+ # @param [String] quota_user
1220
+ # Available to use for quota purposes for server-side applications. Can be any
1221
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1222
+ # @param [Google::Apis::RequestOptions] options
1223
+ # Request-specific options
1224
+ #
1225
+ # @yield [result, err] Result & error if block supplied
1226
+ # @yieldparam result [Google::Apis::DataformV1::Empty] parsed result object
1227
+ # @yieldparam err [StandardError] error object if request failed
1228
+ #
1229
+ # @return [Google::Apis::DataformV1::Empty]
1230
+ #
1231
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1232
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1233
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1234
+ def delete_project_location_repository_release_config(name, fields: nil, quota_user: nil, options: nil, &block)
1235
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1236
+ command.response_representation = Google::Apis::DataformV1::Empty::Representation
1237
+ command.response_class = Google::Apis::DataformV1::Empty
1238
+ command.params['name'] = name unless name.nil?
1239
+ command.query['fields'] = fields unless fields.nil?
1240
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1241
+ execute_or_queue_command(command, &block)
1242
+ end
1243
+
1244
+ # Fetches a single ReleaseConfig.
1245
+ # @param [String] name
1246
+ # Required. The release config's name.
1247
+ # @param [String] fields
1248
+ # Selector specifying which fields to include in a partial response.
1249
+ # @param [String] quota_user
1250
+ # Available to use for quota purposes for server-side applications. Can be any
1251
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1252
+ # @param [Google::Apis::RequestOptions] options
1253
+ # Request-specific options
1254
+ #
1255
+ # @yield [result, err] Result & error if block supplied
1256
+ # @yieldparam result [Google::Apis::DataformV1::ReleaseConfig] parsed result object
1257
+ # @yieldparam err [StandardError] error object if request failed
1258
+ #
1259
+ # @return [Google::Apis::DataformV1::ReleaseConfig]
1260
+ #
1261
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1262
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1263
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1264
+ def get_project_location_repository_release_config(name, fields: nil, quota_user: nil, options: nil, &block)
1265
+ command = make_simple_command(:get, 'v1/{+name}', options)
1266
+ command.response_representation = Google::Apis::DataformV1::ReleaseConfig::Representation
1267
+ command.response_class = Google::Apis::DataformV1::ReleaseConfig
1268
+ command.params['name'] = name unless name.nil?
1269
+ command.query['fields'] = fields unless fields.nil?
1270
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1271
+ execute_or_queue_command(command, &block)
1272
+ end
1273
+
1274
+ # Lists ReleaseConfigs in a given Repository.
1275
+ # @param [String] parent
1276
+ # Required. The repository in which to list release configs. Must be in the
1277
+ # format `projects/*/locations/*/repositories/*`.
1278
+ # @param [Fixnum] page_size
1279
+ # Optional. Maximum number of release configs to return. The server may return
1280
+ # fewer items than requested. If unspecified, the server will pick an
1281
+ # appropriate default.
1282
+ # @param [String] page_token
1283
+ # Optional. Page token received from a previous `ListReleaseConfigs` call.
1284
+ # Provide this to retrieve the subsequent page. When paginating, all other
1285
+ # parameters provided to `ListReleaseConfigs`, with the exception of `page_size`,
1286
+ # must match the call that provided the page token.
1287
+ # @param [String] fields
1288
+ # Selector specifying which fields to include in a partial response.
1289
+ # @param [String] quota_user
1290
+ # Available to use for quota purposes for server-side applications. Can be any
1291
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1292
+ # @param [Google::Apis::RequestOptions] options
1293
+ # Request-specific options
1294
+ #
1295
+ # @yield [result, err] Result & error if block supplied
1296
+ # @yieldparam result [Google::Apis::DataformV1::ListReleaseConfigsResponse] parsed result object
1297
+ # @yieldparam err [StandardError] error object if request failed
1298
+ #
1299
+ # @return [Google::Apis::DataformV1::ListReleaseConfigsResponse]
1300
+ #
1301
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1302
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1303
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1304
+ def list_project_location_repository_release_configs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1305
+ command = make_simple_command(:get, 'v1/{+parent}/releaseConfigs', options)
1306
+ command.response_representation = Google::Apis::DataformV1::ListReleaseConfigsResponse::Representation
1307
+ command.response_class = Google::Apis::DataformV1::ListReleaseConfigsResponse
1308
+ command.params['parent'] = parent unless parent.nil?
1309
+ command.query['pageSize'] = page_size unless page_size.nil?
1310
+ command.query['pageToken'] = page_token unless page_token.nil?
1311
+ command.query['fields'] = fields unless fields.nil?
1312
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1313
+ execute_or_queue_command(command, &block)
1314
+ end
1315
+
1316
+ # Updates a single ReleaseConfig. **Note:** *This method does not fully
1317
+ # implement [AIP/134](https://google.aip.dev/134). The wildcard entry (\*) is
1318
+ # treated as a bad request, and when the `field_mask` is omitted, the request is
1319
+ # treated as a full update on all modifiable fields.*
1320
+ # @param [String] name
1321
+ # Identifier. The release config's name.
1322
+ # @param [Google::Apis::DataformV1::ReleaseConfig] release_config_object
1323
+ # @param [String] update_mask
1324
+ # Optional. Specifies the fields to be updated in the release config. If left
1325
+ # unset, all fields will be updated.
1326
+ # @param [String] fields
1327
+ # Selector specifying which fields to include in a partial response.
1328
+ # @param [String] quota_user
1329
+ # Available to use for quota purposes for server-side applications. Can be any
1330
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1331
+ # @param [Google::Apis::RequestOptions] options
1332
+ # Request-specific options
1333
+ #
1334
+ # @yield [result, err] Result & error if block supplied
1335
+ # @yieldparam result [Google::Apis::DataformV1::ReleaseConfig] parsed result object
1336
+ # @yieldparam err [StandardError] error object if request failed
1337
+ #
1338
+ # @return [Google::Apis::DataformV1::ReleaseConfig]
1339
+ #
1340
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1341
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1342
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1343
+ def patch_project_location_repository_release_config(name, release_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1344
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1345
+ command.request_representation = Google::Apis::DataformV1::ReleaseConfig::Representation
1346
+ command.request_object = release_config_object
1347
+ command.response_representation = Google::Apis::DataformV1::ReleaseConfig::Representation
1348
+ command.response_class = Google::Apis::DataformV1::ReleaseConfig
1349
+ command.params['name'] = name unless name.nil?
1350
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1351
+ command.query['fields'] = fields unless fields.nil?
1352
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1353
+ execute_or_queue_command(command, &block)
1354
+ end
1355
+
1356
+ # Creates a new WorkflowConfig in a given Repository.
1357
+ # @param [String] parent
1358
+ # Required. The repository in which to create the workflow config. Must be in
1359
+ # the format `projects/*/locations/*/repositories/*`.
1360
+ # @param [Google::Apis::DataformV1::WorkflowConfig] workflow_config_object
1361
+ # @param [String] workflow_config_id
1362
+ # Required. The ID to use for the workflow config, which will become the final
1363
+ # component of the workflow config's resource name.
1364
+ # @param [String] fields
1365
+ # Selector specifying which fields to include in a partial response.
1366
+ # @param [String] quota_user
1367
+ # Available to use for quota purposes for server-side applications. Can be any
1368
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1369
+ # @param [Google::Apis::RequestOptions] options
1370
+ # Request-specific options
1371
+ #
1372
+ # @yield [result, err] Result & error if block supplied
1373
+ # @yieldparam result [Google::Apis::DataformV1::WorkflowConfig] parsed result object
1374
+ # @yieldparam err [StandardError] error object if request failed
1375
+ #
1376
+ # @return [Google::Apis::DataformV1::WorkflowConfig]
1377
+ #
1378
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1379
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1380
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1381
+ def create_project_location_repository_workflow_config(parent, workflow_config_object = nil, workflow_config_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1382
+ command = make_simple_command(:post, 'v1/{+parent}/workflowConfigs', options)
1383
+ command.request_representation = Google::Apis::DataformV1::WorkflowConfig::Representation
1384
+ command.request_object = workflow_config_object
1385
+ command.response_representation = Google::Apis::DataformV1::WorkflowConfig::Representation
1386
+ command.response_class = Google::Apis::DataformV1::WorkflowConfig
1387
+ command.params['parent'] = parent unless parent.nil?
1388
+ command.query['workflowConfigId'] = workflow_config_id unless workflow_config_id.nil?
1389
+ command.query['fields'] = fields unless fields.nil?
1390
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1391
+ execute_or_queue_command(command, &block)
1392
+ end
1393
+
1394
+ # Deletes a single WorkflowConfig.
1395
+ # @param [String] name
1396
+ # Required. The workflow config's name.
1397
+ # @param [String] fields
1398
+ # Selector specifying which fields to include in a partial response.
1399
+ # @param [String] quota_user
1400
+ # Available to use for quota purposes for server-side applications. Can be any
1401
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1402
+ # @param [Google::Apis::RequestOptions] options
1403
+ # Request-specific options
1404
+ #
1405
+ # @yield [result, err] Result & error if block supplied
1406
+ # @yieldparam result [Google::Apis::DataformV1::Empty] parsed result object
1407
+ # @yieldparam err [StandardError] error object if request failed
1408
+ #
1409
+ # @return [Google::Apis::DataformV1::Empty]
1410
+ #
1411
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1412
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1413
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1414
+ def delete_project_location_repository_workflow_config(name, fields: nil, quota_user: nil, options: nil, &block)
1415
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1416
+ command.response_representation = Google::Apis::DataformV1::Empty::Representation
1417
+ command.response_class = Google::Apis::DataformV1::Empty
1418
+ command.params['name'] = name unless name.nil?
1419
+ command.query['fields'] = fields unless fields.nil?
1420
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1421
+ execute_or_queue_command(command, &block)
1422
+ end
1423
+
1424
+ # Fetches a single WorkflowConfig.
1425
+ # @param [String] name
1426
+ # Required. The workflow config's name.
1427
+ # @param [String] fields
1428
+ # Selector specifying which fields to include in a partial response.
1429
+ # @param [String] quota_user
1430
+ # Available to use for quota purposes for server-side applications. Can be any
1431
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1432
+ # @param [Google::Apis::RequestOptions] options
1433
+ # Request-specific options
1434
+ #
1435
+ # @yield [result, err] Result & error if block supplied
1436
+ # @yieldparam result [Google::Apis::DataformV1::WorkflowConfig] parsed result object
1437
+ # @yieldparam err [StandardError] error object if request failed
1438
+ #
1439
+ # @return [Google::Apis::DataformV1::WorkflowConfig]
1440
+ #
1441
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1442
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1443
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1444
+ def get_project_location_repository_workflow_config(name, fields: nil, quota_user: nil, options: nil, &block)
1445
+ command = make_simple_command(:get, 'v1/{+name}', options)
1446
+ command.response_representation = Google::Apis::DataformV1::WorkflowConfig::Representation
1447
+ command.response_class = Google::Apis::DataformV1::WorkflowConfig
1448
+ command.params['name'] = name unless name.nil?
1449
+ command.query['fields'] = fields unless fields.nil?
1450
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1451
+ execute_or_queue_command(command, &block)
1452
+ end
1453
+
1454
+ # Lists WorkflowConfigs in a given Repository.
1455
+ # @param [String] parent
1456
+ # Required. The repository in which to list workflow configs. Must be in the
1457
+ # format `projects/*/locations/*/repositories/*`.
1458
+ # @param [Fixnum] page_size
1459
+ # Optional. Maximum number of workflow configs to return. The server may return
1460
+ # fewer items than requested. If unspecified, the server will pick an
1461
+ # appropriate default.
1462
+ # @param [String] page_token
1463
+ # Optional. Page token received from a previous `ListWorkflowConfigs` call.
1464
+ # Provide this to retrieve the subsequent page. When paginating, all other
1465
+ # parameters provided to `ListWorkflowConfigs`, with the exception of `page_size`
1466
+ # , must match the call that provided the page token.
1467
+ # @param [String] fields
1468
+ # Selector specifying which fields to include in a partial response.
1469
+ # @param [String] quota_user
1470
+ # Available to use for quota purposes for server-side applications. Can be any
1471
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1472
+ # @param [Google::Apis::RequestOptions] options
1473
+ # Request-specific options
1474
+ #
1475
+ # @yield [result, err] Result & error if block supplied
1476
+ # @yieldparam result [Google::Apis::DataformV1::ListWorkflowConfigsResponse] parsed result object
1477
+ # @yieldparam err [StandardError] error object if request failed
1478
+ #
1479
+ # @return [Google::Apis::DataformV1::ListWorkflowConfigsResponse]
1480
+ #
1481
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1482
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1483
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1484
+ def list_project_location_repository_workflow_configs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1485
+ command = make_simple_command(:get, 'v1/{+parent}/workflowConfigs', options)
1486
+ command.response_representation = Google::Apis::DataformV1::ListWorkflowConfigsResponse::Representation
1487
+ command.response_class = Google::Apis::DataformV1::ListWorkflowConfigsResponse
1488
+ command.params['parent'] = parent unless parent.nil?
1489
+ command.query['pageSize'] = page_size unless page_size.nil?
1490
+ command.query['pageToken'] = page_token unless page_token.nil?
1491
+ command.query['fields'] = fields unless fields.nil?
1492
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1493
+ execute_or_queue_command(command, &block)
1494
+ end
1495
+
1496
+ # Updates a single WorkflowConfig. **Note:** *This method does not fully
1497
+ # implement [AIP/134](https://google.aip.dev/134). The wildcard entry (\*) is
1498
+ # treated as a bad request, and when the `field_mask` is omitted, the request is
1499
+ # treated as a full update on all modifiable fields.*
1500
+ # @param [String] name
1501
+ # Identifier. The workflow config's name.
1502
+ # @param [Google::Apis::DataformV1::WorkflowConfig] workflow_config_object
1503
+ # @param [String] update_mask
1504
+ # Optional. Specifies the fields to be updated in the workflow config. If left
1505
+ # unset, all fields will be updated.
1506
+ # @param [String] fields
1507
+ # Selector specifying which fields to include in a partial response.
1508
+ # @param [String] quota_user
1509
+ # Available to use for quota purposes for server-side applications. Can be any
1510
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1511
+ # @param [Google::Apis::RequestOptions] options
1512
+ # Request-specific options
1513
+ #
1514
+ # @yield [result, err] Result & error if block supplied
1515
+ # @yieldparam result [Google::Apis::DataformV1::WorkflowConfig] parsed result object
1516
+ # @yieldparam err [StandardError] error object if request failed
1517
+ #
1518
+ # @return [Google::Apis::DataformV1::WorkflowConfig]
1519
+ #
1520
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1521
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1522
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1523
+ def patch_project_location_repository_workflow_config(name, workflow_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1524
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1525
+ command.request_representation = Google::Apis::DataformV1::WorkflowConfig::Representation
1526
+ command.request_object = workflow_config_object
1527
+ command.response_representation = Google::Apis::DataformV1::WorkflowConfig::Representation
1528
+ command.response_class = Google::Apis::DataformV1::WorkflowConfig
1529
+ command.params['name'] = name unless name.nil?
1530
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1531
+ command.query['fields'] = fields unless fields.nil?
1532
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1533
+ execute_or_queue_command(command, &block)
1534
+ end
1535
+
1536
+ # Requests cancellation of a running WorkflowInvocation.
1537
+ # @param [String] name
1538
+ # Required. The workflow invocation resource's name.
1539
+ # @param [Google::Apis::DataformV1::CancelWorkflowInvocationRequest] cancel_workflow_invocation_request_object
1540
+ # @param [String] fields
1541
+ # Selector specifying which fields to include in a partial response.
1542
+ # @param [String] quota_user
1543
+ # Available to use for quota purposes for server-side applications. Can be any
1544
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1545
+ # @param [Google::Apis::RequestOptions] options
1546
+ # Request-specific options
1547
+ #
1548
+ # @yield [result, err] Result & error if block supplied
1549
+ # @yieldparam result [Google::Apis::DataformV1::CancelWorkflowInvocationResponse] parsed result object
1550
+ # @yieldparam err [StandardError] error object if request failed
1551
+ #
1552
+ # @return [Google::Apis::DataformV1::CancelWorkflowInvocationResponse]
1553
+ #
1554
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1555
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1556
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1557
+ def cancel_workflow_invocation(name, cancel_workflow_invocation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1558
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
1559
+ command.request_representation = Google::Apis::DataformV1::CancelWorkflowInvocationRequest::Representation
1560
+ command.request_object = cancel_workflow_invocation_request_object
1561
+ command.response_representation = Google::Apis::DataformV1::CancelWorkflowInvocationResponse::Representation
1562
+ command.response_class = Google::Apis::DataformV1::CancelWorkflowInvocationResponse
1563
+ command.params['name'] = name unless name.nil?
1564
+ command.query['fields'] = fields unless fields.nil?
1565
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1566
+ execute_or_queue_command(command, &block)
1567
+ end
1568
+
1569
+ # Creates a new WorkflowInvocation in a given Repository.
1570
+ # @param [String] parent
1571
+ # Required. The repository in which to create the workflow invocation. Must be
1572
+ # in the format `projects/*/locations/*/repositories/*`.
1573
+ # @param [Google::Apis::DataformV1::WorkflowInvocation] workflow_invocation_object
1574
+ # @param [String] fields
1575
+ # Selector specifying which fields to include in a partial response.
1576
+ # @param [String] quota_user
1577
+ # Available to use for quota purposes for server-side applications. Can be any
1578
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1579
+ # @param [Google::Apis::RequestOptions] options
1580
+ # Request-specific options
1581
+ #
1582
+ # @yield [result, err] Result & error if block supplied
1583
+ # @yieldparam result [Google::Apis::DataformV1::WorkflowInvocation] parsed result object
1584
+ # @yieldparam err [StandardError] error object if request failed
1585
+ #
1586
+ # @return [Google::Apis::DataformV1::WorkflowInvocation]
1587
+ #
1588
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1589
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1590
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1591
+ def create_project_location_repository_workflow_invocation(parent, workflow_invocation_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1592
+ command = make_simple_command(:post, 'v1/{+parent}/workflowInvocations', options)
1593
+ command.request_representation = Google::Apis::DataformV1::WorkflowInvocation::Representation
1594
+ command.request_object = workflow_invocation_object
1595
+ command.response_representation = Google::Apis::DataformV1::WorkflowInvocation::Representation
1596
+ command.response_class = Google::Apis::DataformV1::WorkflowInvocation
1597
+ command.params['parent'] = parent unless parent.nil?
1598
+ command.query['fields'] = fields unless fields.nil?
1599
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1600
+ execute_or_queue_command(command, &block)
1601
+ end
1602
+
1603
+ # Deletes a single WorkflowInvocation.
1604
+ # @param [String] name
1605
+ # Required. The workflow invocation resource's name.
1606
+ # @param [String] fields
1607
+ # Selector specifying which fields to include in a partial response.
1608
+ # @param [String] quota_user
1609
+ # Available to use for quota purposes for server-side applications. Can be any
1610
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1611
+ # @param [Google::Apis::RequestOptions] options
1612
+ # Request-specific options
1613
+ #
1614
+ # @yield [result, err] Result & error if block supplied
1615
+ # @yieldparam result [Google::Apis::DataformV1::Empty] parsed result object
1616
+ # @yieldparam err [StandardError] error object if request failed
1617
+ #
1618
+ # @return [Google::Apis::DataformV1::Empty]
1619
+ #
1620
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1621
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1622
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1623
+ def delete_project_location_repository_workflow_invocation(name, fields: nil, quota_user: nil, options: nil, &block)
1624
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1625
+ command.response_representation = Google::Apis::DataformV1::Empty::Representation
1626
+ command.response_class = Google::Apis::DataformV1::Empty
1627
+ command.params['name'] = name unless name.nil?
1628
+ command.query['fields'] = fields unless fields.nil?
1629
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1630
+ execute_or_queue_command(command, &block)
1631
+ end
1632
+
1633
+ # Fetches a single WorkflowInvocation.
1634
+ # @param [String] name
1635
+ # Required. The workflow invocation resource's name.
1636
+ # @param [String] fields
1637
+ # Selector specifying which fields to include in a partial response.
1638
+ # @param [String] quota_user
1639
+ # Available to use for quota purposes for server-side applications. Can be any
1640
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1641
+ # @param [Google::Apis::RequestOptions] options
1642
+ # Request-specific options
1643
+ #
1644
+ # @yield [result, err] Result & error if block supplied
1645
+ # @yieldparam result [Google::Apis::DataformV1::WorkflowInvocation] parsed result object
1646
+ # @yieldparam err [StandardError] error object if request failed
1647
+ #
1648
+ # @return [Google::Apis::DataformV1::WorkflowInvocation]
1649
+ #
1650
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1651
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1652
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1653
+ def get_project_location_repository_workflow_invocation(name, fields: nil, quota_user: nil, options: nil, &block)
1654
+ command = make_simple_command(:get, 'v1/{+name}', options)
1655
+ command.response_representation = Google::Apis::DataformV1::WorkflowInvocation::Representation
1656
+ command.response_class = Google::Apis::DataformV1::WorkflowInvocation
1657
+ command.params['name'] = name unless name.nil?
1658
+ command.query['fields'] = fields unless fields.nil?
1659
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1660
+ execute_or_queue_command(command, &block)
1661
+ end
1662
+
1663
+ # Lists WorkflowInvocations in a given Repository.
1664
+ # @param [String] parent
1665
+ # Required. The parent resource of the WorkflowInvocation type. Must be in the
1666
+ # format `projects/*/locations/*/repositories/*`.
1667
+ # @param [String] filter
1668
+ # Optional. Filter for the returned list.
1669
+ # @param [String] order_by
1670
+ # Optional. This field only supports ordering by `name`. If unspecified, the
1671
+ # server will choose the ordering. If specified, the default order is ascending
1672
+ # for the `name` field.
1673
+ # @param [Fixnum] page_size
1674
+ # Optional. Maximum number of workflow invocations to return. The server may
1675
+ # return fewer items than requested. If unspecified, the server will pick an
1676
+ # appropriate default.
1677
+ # @param [String] page_token
1678
+ # Optional. Page token received from a previous `ListWorkflowInvocations` call.
1679
+ # Provide this to retrieve the subsequent page. When paginating, all other
1680
+ # parameters provided to `ListWorkflowInvocations`, with the exception of `
1681
+ # page_size`, must match the call that provided the page token.
1682
+ # @param [String] fields
1683
+ # Selector specifying which fields to include in a partial response.
1684
+ # @param [String] quota_user
1685
+ # Available to use for quota purposes for server-side applications. Can be any
1686
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1687
+ # @param [Google::Apis::RequestOptions] options
1688
+ # Request-specific options
1689
+ #
1690
+ # @yield [result, err] Result & error if block supplied
1691
+ # @yieldparam result [Google::Apis::DataformV1::ListWorkflowInvocationsResponse] parsed result object
1692
+ # @yieldparam err [StandardError] error object if request failed
1693
+ #
1694
+ # @return [Google::Apis::DataformV1::ListWorkflowInvocationsResponse]
1695
+ #
1696
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1697
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1698
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1699
+ def list_project_location_repository_workflow_invocations(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1700
+ command = make_simple_command(:get, 'v1/{+parent}/workflowInvocations', options)
1701
+ command.response_representation = Google::Apis::DataformV1::ListWorkflowInvocationsResponse::Representation
1702
+ command.response_class = Google::Apis::DataformV1::ListWorkflowInvocationsResponse
1703
+ command.params['parent'] = parent unless parent.nil?
1704
+ command.query['filter'] = filter unless filter.nil?
1705
+ command.query['orderBy'] = order_by unless order_by.nil?
1706
+ command.query['pageSize'] = page_size unless page_size.nil?
1707
+ command.query['pageToken'] = page_token unless page_token.nil?
1708
+ command.query['fields'] = fields unless fields.nil?
1709
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1710
+ execute_or_queue_command(command, &block)
1711
+ end
1712
+
1713
+ # Returns WorkflowInvocationActions in a given WorkflowInvocation.
1714
+ # @param [String] name
1715
+ # Required. The workflow invocation's name.
1716
+ # @param [Fixnum] page_size
1717
+ # Optional. Maximum number of workflow invocations to return. The server may
1718
+ # return fewer items than requested. If unspecified, the server will pick an
1719
+ # appropriate default.
1720
+ # @param [String] page_token
1721
+ # Optional. Page token received from a previous `QueryWorkflowInvocationActions`
1722
+ # call. Provide this to retrieve the subsequent page. When paginating, all other
1723
+ # parameters provided to `QueryWorkflowInvocationActions`, with the exception of
1724
+ # `page_size`, must match the call that provided the page token.
1725
+ # @param [String] fields
1726
+ # Selector specifying which fields to include in a partial response.
1727
+ # @param [String] quota_user
1728
+ # Available to use for quota purposes for server-side applications. Can be any
1729
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1730
+ # @param [Google::Apis::RequestOptions] options
1731
+ # Request-specific options
1732
+ #
1733
+ # @yield [result, err] Result & error if block supplied
1734
+ # @yieldparam result [Google::Apis::DataformV1::QueryWorkflowInvocationActionsResponse] parsed result object
1735
+ # @yieldparam err [StandardError] error object if request failed
1736
+ #
1737
+ # @return [Google::Apis::DataformV1::QueryWorkflowInvocationActionsResponse]
1738
+ #
1739
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1740
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1741
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1742
+ def query_project_location_repository_workflow_invocation(name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1743
+ command = make_simple_command(:get, 'v1/{+name}:query', options)
1744
+ command.response_representation = Google::Apis::DataformV1::QueryWorkflowInvocationActionsResponse::Representation
1745
+ command.response_class = Google::Apis::DataformV1::QueryWorkflowInvocationActionsResponse
1746
+ command.params['name'] = name unless name.nil?
1747
+ command.query['pageSize'] = page_size unless page_size.nil?
1748
+ command.query['pageToken'] = page_token unless page_token.nil?
1749
+ command.query['fields'] = fields unless fields.nil?
1750
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1751
+ execute_or_queue_command(command, &block)
1752
+ end
1753
+
1754
+ # Applies a Git commit for uncommitted files in a Workspace.
1755
+ # @param [String] name
1756
+ # Required. The workspace's name.
1757
+ # @param [Google::Apis::DataformV1::CommitWorkspaceChangesRequest] commit_workspace_changes_request_object
1758
+ # @param [String] fields
1759
+ # Selector specifying which fields to include in a partial response.
1760
+ # @param [String] quota_user
1761
+ # Available to use for quota purposes for server-side applications. Can be any
1762
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1763
+ # @param [Google::Apis::RequestOptions] options
1764
+ # Request-specific options
1765
+ #
1766
+ # @yield [result, err] Result & error if block supplied
1767
+ # @yieldparam result [Google::Apis::DataformV1::CommitWorkspaceChangesResponse] parsed result object
1768
+ # @yieldparam err [StandardError] error object if request failed
1769
+ #
1770
+ # @return [Google::Apis::DataformV1::CommitWorkspaceChangesResponse]
1771
+ #
1772
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1773
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1774
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1775
+ def commit_workspace_changes(name, commit_workspace_changes_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1776
+ command = make_simple_command(:post, 'v1/{+name}:commit', options)
1777
+ command.request_representation = Google::Apis::DataformV1::CommitWorkspaceChangesRequest::Representation
1778
+ command.request_object = commit_workspace_changes_request_object
1779
+ command.response_representation = Google::Apis::DataformV1::CommitWorkspaceChangesResponse::Representation
1780
+ command.response_class = Google::Apis::DataformV1::CommitWorkspaceChangesResponse
1781
+ command.params['name'] = name unless name.nil?
1782
+ command.query['fields'] = fields unless fields.nil?
1783
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1784
+ execute_or_queue_command(command, &block)
1785
+ end
1786
+
1787
+ # Creates a new Workspace in a given Repository.
1788
+ # @param [String] parent
1789
+ # Required. The repository in which to create the workspace. Must be in the
1790
+ # format `projects/*/locations/*/repositories/*`.
1791
+ # @param [Google::Apis::DataformV1::Workspace] workspace_object
1792
+ # @param [String] workspace_id
1793
+ # Required. The ID to use for the workspace, which will become the final
1794
+ # component of the workspace's resource name.
1795
+ # @param [String] fields
1796
+ # Selector specifying which fields to include in a partial response.
1797
+ # @param [String] quota_user
1798
+ # Available to use for quota purposes for server-side applications. Can be any
1799
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1800
+ # @param [Google::Apis::RequestOptions] options
1801
+ # Request-specific options
1802
+ #
1803
+ # @yield [result, err] Result & error if block supplied
1804
+ # @yieldparam result [Google::Apis::DataformV1::Workspace] parsed result object
1805
+ # @yieldparam err [StandardError] error object if request failed
1806
+ #
1807
+ # @return [Google::Apis::DataformV1::Workspace]
1808
+ #
1809
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1810
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1811
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1812
+ def create_project_location_repository_workspace(parent, workspace_object = nil, workspace_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1813
+ command = make_simple_command(:post, 'v1/{+parent}/workspaces', options)
1814
+ command.request_representation = Google::Apis::DataformV1::Workspace::Representation
1815
+ command.request_object = workspace_object
1816
+ command.response_representation = Google::Apis::DataformV1::Workspace::Representation
1817
+ command.response_class = Google::Apis::DataformV1::Workspace
1818
+ command.params['parent'] = parent unless parent.nil?
1819
+ command.query['workspaceId'] = workspace_id unless workspace_id.nil?
1820
+ command.query['fields'] = fields unless fields.nil?
1821
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1822
+ execute_or_queue_command(command, &block)
1823
+ end
1824
+
1825
+ # Deletes a single Workspace.
1826
+ # @param [String] name
1827
+ # Required. The workspace resource's name.
1828
+ # @param [String] fields
1829
+ # Selector specifying which fields to include in a partial response.
1830
+ # @param [String] quota_user
1831
+ # Available to use for quota purposes for server-side applications. Can be any
1832
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1833
+ # @param [Google::Apis::RequestOptions] options
1834
+ # Request-specific options
1835
+ #
1836
+ # @yield [result, err] Result & error if block supplied
1837
+ # @yieldparam result [Google::Apis::DataformV1::Empty] parsed result object
1838
+ # @yieldparam err [StandardError] error object if request failed
1839
+ #
1840
+ # @return [Google::Apis::DataformV1::Empty]
1841
+ #
1842
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1843
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1844
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1845
+ def delete_project_location_repository_workspace(name, fields: nil, quota_user: nil, options: nil, &block)
1846
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1847
+ command.response_representation = Google::Apis::DataformV1::Empty::Representation
1848
+ command.response_class = Google::Apis::DataformV1::Empty
1849
+ command.params['name'] = name unless name.nil?
1850
+ command.query['fields'] = fields unless fields.nil?
1851
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1852
+ execute_or_queue_command(command, &block)
1853
+ end
1854
+
1855
+ # Fetches Git diff for an uncommitted file in a Workspace.
1856
+ # @param [String] workspace
1857
+ # Required. The workspace's name.
1858
+ # @param [String] path
1859
+ # Required. The file's full path including filename, relative to the workspace
1860
+ # root.
1861
+ # @param [String] fields
1862
+ # Selector specifying which fields to include in a partial response.
1863
+ # @param [String] quota_user
1864
+ # Available to use for quota purposes for server-side applications. Can be any
1865
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1866
+ # @param [Google::Apis::RequestOptions] options
1867
+ # Request-specific options
1868
+ #
1869
+ # @yield [result, err] Result & error if block supplied
1870
+ # @yieldparam result [Google::Apis::DataformV1::FetchFileDiffResponse] parsed result object
1871
+ # @yieldparam err [StandardError] error object if request failed
1872
+ #
1873
+ # @return [Google::Apis::DataformV1::FetchFileDiffResponse]
1874
+ #
1875
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1876
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1877
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1878
+ def fetch_project_location_repository_workspace_file_diff(workspace, path: nil, fields: nil, quota_user: nil, options: nil, &block)
1879
+ command = make_simple_command(:get, 'v1/{+workspace}:fetchFileDiff', options)
1880
+ command.response_representation = Google::Apis::DataformV1::FetchFileDiffResponse::Representation
1881
+ command.response_class = Google::Apis::DataformV1::FetchFileDiffResponse
1882
+ command.params['workspace'] = workspace unless workspace.nil?
1883
+ command.query['path'] = path unless path.nil?
1884
+ command.query['fields'] = fields unless fields.nil?
1885
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1886
+ execute_or_queue_command(command, &block)
1887
+ end
1888
+
1889
+ # Fetches Git statuses for the files in a Workspace.
1890
+ # @param [String] name
1891
+ # Required. The workspace's name.
1892
+ # @param [String] fields
1893
+ # Selector specifying which fields to include in a partial response.
1894
+ # @param [String] quota_user
1895
+ # Available to use for quota purposes for server-side applications. Can be any
1896
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1897
+ # @param [Google::Apis::RequestOptions] options
1898
+ # Request-specific options
1899
+ #
1900
+ # @yield [result, err] Result & error if block supplied
1901
+ # @yieldparam result [Google::Apis::DataformV1::FetchFileGitStatusesResponse] parsed result object
1902
+ # @yieldparam err [StandardError] error object if request failed
1903
+ #
1904
+ # @return [Google::Apis::DataformV1::FetchFileGitStatusesResponse]
1905
+ #
1906
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1907
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1908
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1909
+ def fetch_project_location_repository_workspace_file_git_statuses(name, fields: nil, quota_user: nil, options: nil, &block)
1910
+ command = make_simple_command(:get, 'v1/{+name}:fetchFileGitStatuses', options)
1911
+ command.response_representation = Google::Apis::DataformV1::FetchFileGitStatusesResponse::Representation
1912
+ command.response_class = Google::Apis::DataformV1::FetchFileGitStatusesResponse
1913
+ command.params['name'] = name unless name.nil?
1914
+ command.query['fields'] = fields unless fields.nil?
1915
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1916
+ execute_or_queue_command(command, &block)
1917
+ end
1918
+
1919
+ # Fetches Git ahead/behind against a remote branch.
1920
+ # @param [String] name
1921
+ # Required. The workspace's name.
1922
+ # @param [String] remote_branch
1923
+ # Optional. The name of the branch in the Git remote against which this
1924
+ # workspace should be compared. If left unset, the repository's default branch
1925
+ # name will be used.
1926
+ # @param [String] fields
1927
+ # Selector specifying which fields to include in a partial response.
1928
+ # @param [String] quota_user
1929
+ # Available to use for quota purposes for server-side applications. Can be any
1930
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1931
+ # @param [Google::Apis::RequestOptions] options
1932
+ # Request-specific options
1933
+ #
1934
+ # @yield [result, err] Result & error if block supplied
1935
+ # @yieldparam result [Google::Apis::DataformV1::FetchGitAheadBehindResponse] parsed result object
1936
+ # @yieldparam err [StandardError] error object if request failed
1937
+ #
1938
+ # @return [Google::Apis::DataformV1::FetchGitAheadBehindResponse]
1939
+ #
1940
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1941
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1942
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1943
+ def fetch_project_location_repository_workspace_git_ahead_behind(name, remote_branch: nil, fields: nil, quota_user: nil, options: nil, &block)
1944
+ command = make_simple_command(:get, 'v1/{+name}:fetchGitAheadBehind', options)
1945
+ command.response_representation = Google::Apis::DataformV1::FetchGitAheadBehindResponse::Representation
1946
+ command.response_class = Google::Apis::DataformV1::FetchGitAheadBehindResponse
1947
+ command.params['name'] = name unless name.nil?
1948
+ command.query['remoteBranch'] = remote_branch unless remote_branch.nil?
1949
+ command.query['fields'] = fields unless fields.nil?
1950
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1951
+ execute_or_queue_command(command, &block)
1952
+ end
1953
+
1954
+ # Fetches a single Workspace.
1955
+ # @param [String] name
1956
+ # Required. The workspace's name.
1957
+ # @param [String] fields
1958
+ # Selector specifying which fields to include in a partial response.
1959
+ # @param [String] quota_user
1960
+ # Available to use for quota purposes for server-side applications. Can be any
1961
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1962
+ # @param [Google::Apis::RequestOptions] options
1963
+ # Request-specific options
1964
+ #
1965
+ # @yield [result, err] Result & error if block supplied
1966
+ # @yieldparam result [Google::Apis::DataformV1::Workspace] parsed result object
1967
+ # @yieldparam err [StandardError] error object if request failed
1968
+ #
1969
+ # @return [Google::Apis::DataformV1::Workspace]
1970
+ #
1971
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1972
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1973
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1974
+ def get_project_location_repository_workspace(name, fields: nil, quota_user: nil, options: nil, &block)
1975
+ command = make_simple_command(:get, 'v1/{+name}', options)
1976
+ command.response_representation = Google::Apis::DataformV1::Workspace::Representation
1977
+ command.response_class = Google::Apis::DataformV1::Workspace
1978
+ command.params['name'] = name unless name.nil?
1979
+ command.query['fields'] = fields unless fields.nil?
1980
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1981
+ execute_or_queue_command(command, &block)
1982
+ end
1983
+
1984
+ # Gets the access control policy for a resource. Returns an empty policy if the
1985
+ # resource exists and does not have a policy set.
1986
+ # @param [String] resource
1987
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
1988
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1989
+ # appropriate value for this field.
1990
+ # @param [Fixnum] options_requested_policy_version
1991
+ # Optional. The maximum policy version that will be used to format the policy.
1992
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
1993
+ # rejected. Requests for policies with any conditional role bindings must
1994
+ # specify version 3. Policies with no conditional role bindings may specify any
1995
+ # valid value or leave the field unset. The policy in the response might use the
1996
+ # policy version that you specified, or it might use a lower policy version. For
1997
+ # example, if you specify version 3, but the policy has no conditional role
1998
+ # bindings, the response uses version 1. To learn which resources support
1999
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
2000
+ # google.com/iam/help/conditions/resource-policies).
2001
+ # @param [String] fields
2002
+ # Selector specifying which fields to include in a partial response.
2003
+ # @param [String] quota_user
2004
+ # Available to use for quota purposes for server-side applications. Can be any
2005
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2006
+ # @param [Google::Apis::RequestOptions] options
2007
+ # Request-specific options
2008
+ #
2009
+ # @yield [result, err] Result & error if block supplied
2010
+ # @yieldparam result [Google::Apis::DataformV1::Policy] parsed result object
2011
+ # @yieldparam err [StandardError] error object if request failed
2012
+ #
2013
+ # @return [Google::Apis::DataformV1::Policy]
2014
+ #
2015
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2016
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2017
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2018
+ def get_project_location_repository_workspace_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
2019
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
2020
+ command.response_representation = Google::Apis::DataformV1::Policy::Representation
2021
+ command.response_class = Google::Apis::DataformV1::Policy
2022
+ command.params['resource'] = resource unless resource.nil?
2023
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
2024
+ command.query['fields'] = fields unless fields.nil?
2025
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2026
+ execute_or_queue_command(command, &block)
2027
+ end
2028
+
2029
+ # Installs dependency NPM packages (inside a Workspace).
2030
+ # @param [String] workspace
2031
+ # Required. The workspace's name.
2032
+ # @param [Google::Apis::DataformV1::InstallNpmPackagesRequest] install_npm_packages_request_object
2033
+ # @param [String] fields
2034
+ # Selector specifying which fields to include in a partial response.
2035
+ # @param [String] quota_user
2036
+ # Available to use for quota purposes for server-side applications. Can be any
2037
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2038
+ # @param [Google::Apis::RequestOptions] options
2039
+ # Request-specific options
2040
+ #
2041
+ # @yield [result, err] Result & error if block supplied
2042
+ # @yieldparam result [Google::Apis::DataformV1::InstallNpmPackagesResponse] parsed result object
2043
+ # @yieldparam err [StandardError] error object if request failed
2044
+ #
2045
+ # @return [Google::Apis::DataformV1::InstallNpmPackagesResponse]
2046
+ #
2047
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2048
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2049
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2050
+ def install_workspace_npm_packages(workspace, install_npm_packages_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2051
+ command = make_simple_command(:post, 'v1/{+workspace}:installNpmPackages', options)
2052
+ command.request_representation = Google::Apis::DataformV1::InstallNpmPackagesRequest::Representation
2053
+ command.request_object = install_npm_packages_request_object
2054
+ command.response_representation = Google::Apis::DataformV1::InstallNpmPackagesResponse::Representation
2055
+ command.response_class = Google::Apis::DataformV1::InstallNpmPackagesResponse
2056
+ command.params['workspace'] = workspace unless workspace.nil?
2057
+ command.query['fields'] = fields unless fields.nil?
2058
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2059
+ execute_or_queue_command(command, &block)
2060
+ end
2061
+
2062
+ # Lists Workspaces in a given Repository.
2063
+ # @param [String] parent
2064
+ # Required. The repository in which to list workspaces. Must be in the format `
2065
+ # projects/*/locations/*/repositories/*`.
2066
+ # @param [String] filter
2067
+ # Optional. Filter for the returned list.
2068
+ # @param [String] order_by
2069
+ # Optional. This field only supports ordering by `name`. If unspecified, the
2070
+ # server will choose the ordering. If specified, the default order is ascending
2071
+ # for the `name` field.
2072
+ # @param [Fixnum] page_size
2073
+ # Optional. Maximum number of workspaces to return. The server may return fewer
2074
+ # items than requested. If unspecified, the server will pick an appropriate
2075
+ # default.
2076
+ # @param [String] page_token
2077
+ # Optional. Page token received from a previous `ListWorkspaces` call. Provide
2078
+ # this to retrieve the subsequent page. When paginating, all other parameters
2079
+ # provided to `ListWorkspaces`, with the exception of `page_size`, must match
2080
+ # the call that provided the page token.
2081
+ # @param [String] fields
2082
+ # Selector specifying which fields to include in a partial response.
2083
+ # @param [String] quota_user
2084
+ # Available to use for quota purposes for server-side applications. Can be any
2085
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2086
+ # @param [Google::Apis::RequestOptions] options
2087
+ # Request-specific options
2088
+ #
2089
+ # @yield [result, err] Result & error if block supplied
2090
+ # @yieldparam result [Google::Apis::DataformV1::ListWorkspacesResponse] parsed result object
2091
+ # @yieldparam err [StandardError] error object if request failed
2092
+ #
2093
+ # @return [Google::Apis::DataformV1::ListWorkspacesResponse]
2094
+ #
2095
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2096
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2097
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2098
+ def list_project_location_repository_workspaces(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2099
+ command = make_simple_command(:get, 'v1/{+parent}/workspaces', options)
2100
+ command.response_representation = Google::Apis::DataformV1::ListWorkspacesResponse::Representation
2101
+ command.response_class = Google::Apis::DataformV1::ListWorkspacesResponse
2102
+ command.params['parent'] = parent unless parent.nil?
2103
+ command.query['filter'] = filter unless filter.nil?
2104
+ command.query['orderBy'] = order_by unless order_by.nil?
2105
+ command.query['pageSize'] = page_size unless page_size.nil?
2106
+ command.query['pageToken'] = page_token unless page_token.nil?
2107
+ command.query['fields'] = fields unless fields.nil?
2108
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2109
+ execute_or_queue_command(command, &block)
2110
+ end
2111
+
2112
+ # Creates a directory inside a Workspace.
2113
+ # @param [String] workspace
2114
+ # Required. The workspace's name.
2115
+ # @param [Google::Apis::DataformV1::MakeDirectoryRequest] make_directory_request_object
2116
+ # @param [String] fields
2117
+ # Selector specifying which fields to include in a partial response.
2118
+ # @param [String] quota_user
2119
+ # Available to use for quota purposes for server-side applications. Can be any
2120
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2121
+ # @param [Google::Apis::RequestOptions] options
2122
+ # Request-specific options
2123
+ #
2124
+ # @yield [result, err] Result & error if block supplied
2125
+ # @yieldparam result [Google::Apis::DataformV1::MakeDirectoryResponse] parsed result object
2126
+ # @yieldparam err [StandardError] error object if request failed
2127
+ #
2128
+ # @return [Google::Apis::DataformV1::MakeDirectoryResponse]
2129
+ #
2130
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2131
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2132
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2133
+ def make_workspace_directory(workspace, make_directory_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2134
+ command = make_simple_command(:post, 'v1/{+workspace}:makeDirectory', options)
2135
+ command.request_representation = Google::Apis::DataformV1::MakeDirectoryRequest::Representation
2136
+ command.request_object = make_directory_request_object
2137
+ command.response_representation = Google::Apis::DataformV1::MakeDirectoryResponse::Representation
2138
+ command.response_class = Google::Apis::DataformV1::MakeDirectoryResponse
2139
+ command.params['workspace'] = workspace unless workspace.nil?
2140
+ command.query['fields'] = fields unless fields.nil?
2141
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2142
+ execute_or_queue_command(command, &block)
2143
+ end
2144
+
2145
+ # Moves a directory (inside a Workspace), and all of its contents, to a new
2146
+ # location.
2147
+ # @param [String] workspace
2148
+ # Required. The workspace's name.
2149
+ # @param [Google::Apis::DataformV1::MoveDirectoryRequest] move_directory_request_object
2150
+ # @param [String] fields
2151
+ # Selector specifying which fields to include in a partial response.
2152
+ # @param [String] quota_user
2153
+ # Available to use for quota purposes for server-side applications. Can be any
2154
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2155
+ # @param [Google::Apis::RequestOptions] options
2156
+ # Request-specific options
2157
+ #
2158
+ # @yield [result, err] Result & error if block supplied
2159
+ # @yieldparam result [Google::Apis::DataformV1::MoveDirectoryResponse] parsed result object
2160
+ # @yieldparam err [StandardError] error object if request failed
2161
+ #
2162
+ # @return [Google::Apis::DataformV1::MoveDirectoryResponse]
2163
+ #
2164
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2165
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2166
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2167
+ def move_workspace_directory(workspace, move_directory_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2168
+ command = make_simple_command(:post, 'v1/{+workspace}:moveDirectory', options)
2169
+ command.request_representation = Google::Apis::DataformV1::MoveDirectoryRequest::Representation
2170
+ command.request_object = move_directory_request_object
2171
+ command.response_representation = Google::Apis::DataformV1::MoveDirectoryResponse::Representation
2172
+ command.response_class = Google::Apis::DataformV1::MoveDirectoryResponse
2173
+ command.params['workspace'] = workspace unless workspace.nil?
2174
+ command.query['fields'] = fields unless fields.nil?
2175
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2176
+ execute_or_queue_command(command, &block)
2177
+ end
2178
+
2179
+ # Moves a file (inside a Workspace) to a new location.
2180
+ # @param [String] workspace
2181
+ # Required. The workspace's name.
2182
+ # @param [Google::Apis::DataformV1::MoveFileRequest] move_file_request_object
2183
+ # @param [String] fields
2184
+ # Selector specifying which fields to include in a partial response.
2185
+ # @param [String] quota_user
2186
+ # Available to use for quota purposes for server-side applications. Can be any
2187
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2188
+ # @param [Google::Apis::RequestOptions] options
2189
+ # Request-specific options
2190
+ #
2191
+ # @yield [result, err] Result & error if block supplied
2192
+ # @yieldparam result [Google::Apis::DataformV1::MoveFileResponse] parsed result object
2193
+ # @yieldparam err [StandardError] error object if request failed
2194
+ #
2195
+ # @return [Google::Apis::DataformV1::MoveFileResponse]
2196
+ #
2197
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2198
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2199
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2200
+ def move_workspace_file(workspace, move_file_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2201
+ command = make_simple_command(:post, 'v1/{+workspace}:moveFile', options)
2202
+ command.request_representation = Google::Apis::DataformV1::MoveFileRequest::Representation
2203
+ command.request_object = move_file_request_object
2204
+ command.response_representation = Google::Apis::DataformV1::MoveFileResponse::Representation
2205
+ command.response_class = Google::Apis::DataformV1::MoveFileResponse
2206
+ command.params['workspace'] = workspace unless workspace.nil?
2207
+ command.query['fields'] = fields unless fields.nil?
2208
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2209
+ execute_or_queue_command(command, &block)
2210
+ end
2211
+
2212
+ # Pulls Git commits from the Repository's remote into a Workspace.
2213
+ # @param [String] name
2214
+ # Required. The workspace's name.
2215
+ # @param [Google::Apis::DataformV1::PullGitCommitsRequest] pull_git_commits_request_object
2216
+ # @param [String] fields
2217
+ # Selector specifying which fields to include in a partial response.
2218
+ # @param [String] quota_user
2219
+ # Available to use for quota purposes for server-side applications. Can be any
2220
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2221
+ # @param [Google::Apis::RequestOptions] options
2222
+ # Request-specific options
2223
+ #
2224
+ # @yield [result, err] Result & error if block supplied
2225
+ # @yieldparam result [Google::Apis::DataformV1::PullGitCommitsResponse] parsed result object
2226
+ # @yieldparam err [StandardError] error object if request failed
2227
+ #
2228
+ # @return [Google::Apis::DataformV1::PullGitCommitsResponse]
2229
+ #
2230
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2231
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2232
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2233
+ def pull_workspace_git_commits(name, pull_git_commits_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2234
+ command = make_simple_command(:post, 'v1/{+name}:pull', options)
2235
+ command.request_representation = Google::Apis::DataformV1::PullGitCommitsRequest::Representation
2236
+ command.request_object = pull_git_commits_request_object
2237
+ command.response_representation = Google::Apis::DataformV1::PullGitCommitsResponse::Representation
2238
+ command.response_class = Google::Apis::DataformV1::PullGitCommitsResponse
2239
+ command.params['name'] = name unless name.nil?
2240
+ command.query['fields'] = fields unless fields.nil?
2241
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2242
+ execute_or_queue_command(command, &block)
2243
+ end
2244
+
2245
+ # Pushes Git commits from a Workspace to the Repository's remote.
2246
+ # @param [String] name
2247
+ # Required. The workspace's name.
2248
+ # @param [Google::Apis::DataformV1::PushGitCommitsRequest] push_git_commits_request_object
2249
+ # @param [String] fields
2250
+ # Selector specifying which fields to include in a partial response.
2251
+ # @param [String] quota_user
2252
+ # Available to use for quota purposes for server-side applications. Can be any
2253
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2254
+ # @param [Google::Apis::RequestOptions] options
2255
+ # Request-specific options
2256
+ #
2257
+ # @yield [result, err] Result & error if block supplied
2258
+ # @yieldparam result [Google::Apis::DataformV1::PushGitCommitsResponse] parsed result object
2259
+ # @yieldparam err [StandardError] error object if request failed
2260
+ #
2261
+ # @return [Google::Apis::DataformV1::PushGitCommitsResponse]
2262
+ #
2263
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2264
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2265
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2266
+ def push_workspace_git_commits(name, push_git_commits_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2267
+ command = make_simple_command(:post, 'v1/{+name}:push', options)
2268
+ command.request_representation = Google::Apis::DataformV1::PushGitCommitsRequest::Representation
2269
+ command.request_object = push_git_commits_request_object
2270
+ command.response_representation = Google::Apis::DataformV1::PushGitCommitsResponse::Representation
2271
+ command.response_class = Google::Apis::DataformV1::PushGitCommitsResponse
2272
+ command.params['name'] = name unless name.nil?
2273
+ command.query['fields'] = fields unless fields.nil?
2274
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2275
+ execute_or_queue_command(command, &block)
2276
+ end
2277
+
2278
+ # Returns the contents of a given Workspace directory.
2279
+ # @param [String] workspace
2280
+ # Required. The workspace's name.
2281
+ # @param [Fixnum] page_size
2282
+ # Optional. Maximum number of paths to return. The server may return fewer items
2283
+ # than requested. If unspecified, the server will pick an appropriate default.
2284
+ # @param [String] page_token
2285
+ # Optional. Page token received from a previous `QueryDirectoryContents` call.
2286
+ # Provide this to retrieve the subsequent page. When paginating, all other
2287
+ # parameters provided to `QueryDirectoryContents`, with the exception of `
2288
+ # page_size`, must match the call that provided the page token.
2289
+ # @param [String] path
2290
+ # Optional. The directory's full path including directory name, relative to the
2291
+ # workspace root. If left unset, the workspace root is used.
2292
+ # @param [String] fields
2293
+ # Selector specifying which fields to include in a partial response.
2294
+ # @param [String] quota_user
2295
+ # Available to use for quota purposes for server-side applications. Can be any
2296
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2297
+ # @param [Google::Apis::RequestOptions] options
2298
+ # Request-specific options
2299
+ #
2300
+ # @yield [result, err] Result & error if block supplied
2301
+ # @yieldparam result [Google::Apis::DataformV1::QueryDirectoryContentsResponse] parsed result object
2302
+ # @yieldparam err [StandardError] error object if request failed
2303
+ #
2304
+ # @return [Google::Apis::DataformV1::QueryDirectoryContentsResponse]
2305
+ #
2306
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2307
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2308
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2309
+ def query_project_location_repository_workspace_directory_contents(workspace, page_size: nil, page_token: nil, path: nil, fields: nil, quota_user: nil, options: nil, &block)
2310
+ command = make_simple_command(:get, 'v1/{+workspace}:queryDirectoryContents', options)
2311
+ command.response_representation = Google::Apis::DataformV1::QueryDirectoryContentsResponse::Representation
2312
+ command.response_class = Google::Apis::DataformV1::QueryDirectoryContentsResponse
2313
+ command.params['workspace'] = workspace unless workspace.nil?
2314
+ command.query['pageSize'] = page_size unless page_size.nil?
2315
+ command.query['pageToken'] = page_token unless page_token.nil?
2316
+ command.query['path'] = path unless path.nil?
2317
+ command.query['fields'] = fields unless fields.nil?
2318
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2319
+ execute_or_queue_command(command, &block)
2320
+ end
2321
+
2322
+ # Returns the contents of a file (inside a Workspace).
2323
+ # @param [String] workspace
2324
+ # Required. The workspace's name.
2325
+ # @param [String] path
2326
+ # Required. The file's full path including filename, relative to the workspace
2327
+ # root.
2328
+ # @param [String] revision
2329
+ # Optional. The Git revision of the file to return. If left empty, the current
2330
+ # contents of `path` will be returned.
2331
+ # @param [String] fields
2332
+ # Selector specifying which fields to include in a partial response.
2333
+ # @param [String] quota_user
2334
+ # Available to use for quota purposes for server-side applications. Can be any
2335
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2336
+ # @param [Google::Apis::RequestOptions] options
2337
+ # Request-specific options
2338
+ #
2339
+ # @yield [result, err] Result & error if block supplied
2340
+ # @yieldparam result [Google::Apis::DataformV1::ReadFileResponse] parsed result object
2341
+ # @yieldparam err [StandardError] error object if request failed
2342
+ #
2343
+ # @return [Google::Apis::DataformV1::ReadFileResponse]
2344
+ #
2345
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2346
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2347
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2348
+ def read_project_location_repository_workspace_file(workspace, path: nil, revision: nil, fields: nil, quota_user: nil, options: nil, &block)
2349
+ command = make_simple_command(:get, 'v1/{+workspace}:readFile', options)
2350
+ command.response_representation = Google::Apis::DataformV1::ReadFileResponse::Representation
2351
+ command.response_class = Google::Apis::DataformV1::ReadFileResponse
2352
+ command.params['workspace'] = workspace unless workspace.nil?
2353
+ command.query['path'] = path unless path.nil?
2354
+ command.query['revision'] = revision unless revision.nil?
2355
+ command.query['fields'] = fields unless fields.nil?
2356
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2357
+ execute_or_queue_command(command, &block)
2358
+ end
2359
+
2360
+ # Deletes a directory (inside a Workspace) and all of its contents.
2361
+ # @param [String] workspace
2362
+ # Required. The workspace's name.
2363
+ # @param [Google::Apis::DataformV1::RemoveDirectoryRequest] remove_directory_request_object
2364
+ # @param [String] fields
2365
+ # Selector specifying which fields to include in a partial response.
2366
+ # @param [String] quota_user
2367
+ # Available to use for quota purposes for server-side applications. Can be any
2368
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2369
+ # @param [Google::Apis::RequestOptions] options
2370
+ # Request-specific options
2371
+ #
2372
+ # @yield [result, err] Result & error if block supplied
2373
+ # @yieldparam result [Google::Apis::DataformV1::RemoveDirectoryResponse] parsed result object
2374
+ # @yieldparam err [StandardError] error object if request failed
2375
+ #
2376
+ # @return [Google::Apis::DataformV1::RemoveDirectoryResponse]
2377
+ #
2378
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2379
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2380
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2381
+ def remove_workspace_directory(workspace, remove_directory_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2382
+ command = make_simple_command(:post, 'v1/{+workspace}:removeDirectory', options)
2383
+ command.request_representation = Google::Apis::DataformV1::RemoveDirectoryRequest::Representation
2384
+ command.request_object = remove_directory_request_object
2385
+ command.response_representation = Google::Apis::DataformV1::RemoveDirectoryResponse::Representation
2386
+ command.response_class = Google::Apis::DataformV1::RemoveDirectoryResponse
2387
+ command.params['workspace'] = workspace unless workspace.nil?
2388
+ command.query['fields'] = fields unless fields.nil?
2389
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2390
+ execute_or_queue_command(command, &block)
2391
+ end
2392
+
2393
+ # Deletes a file (inside a Workspace).
2394
+ # @param [String] workspace
2395
+ # Required. The workspace's name.
2396
+ # @param [Google::Apis::DataformV1::RemoveFileRequest] remove_file_request_object
2397
+ # @param [String] fields
2398
+ # Selector specifying which fields to include in a partial response.
2399
+ # @param [String] quota_user
2400
+ # Available to use for quota purposes for server-side applications. Can be any
2401
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2402
+ # @param [Google::Apis::RequestOptions] options
2403
+ # Request-specific options
2404
+ #
2405
+ # @yield [result, err] Result & error if block supplied
2406
+ # @yieldparam result [Google::Apis::DataformV1::RemoveFileResponse] parsed result object
2407
+ # @yieldparam err [StandardError] error object if request failed
2408
+ #
2409
+ # @return [Google::Apis::DataformV1::RemoveFileResponse]
2410
+ #
2411
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2412
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2413
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2414
+ def remove_workspace_file(workspace, remove_file_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2415
+ command = make_simple_command(:post, 'v1/{+workspace}:removeFile', options)
2416
+ command.request_representation = Google::Apis::DataformV1::RemoveFileRequest::Representation
2417
+ command.request_object = remove_file_request_object
2418
+ command.response_representation = Google::Apis::DataformV1::RemoveFileResponse::Representation
2419
+ command.response_class = Google::Apis::DataformV1::RemoveFileResponse
2420
+ command.params['workspace'] = workspace unless workspace.nil?
2421
+ command.query['fields'] = fields unless fields.nil?
2422
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2423
+ execute_or_queue_command(command, &block)
2424
+ end
2425
+
2426
+ # Performs a Git reset for uncommitted files in a Workspace.
2427
+ # @param [String] name
2428
+ # Required. The workspace's name.
2429
+ # @param [Google::Apis::DataformV1::ResetWorkspaceChangesRequest] reset_workspace_changes_request_object
2430
+ # @param [String] fields
2431
+ # Selector specifying which fields to include in a partial response.
2432
+ # @param [String] quota_user
2433
+ # Available to use for quota purposes for server-side applications. Can be any
2434
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2435
+ # @param [Google::Apis::RequestOptions] options
2436
+ # Request-specific options
2437
+ #
2438
+ # @yield [result, err] Result & error if block supplied
2439
+ # @yieldparam result [Google::Apis::DataformV1::ResetWorkspaceChangesResponse] parsed result object
2440
+ # @yieldparam err [StandardError] error object if request failed
2441
+ #
2442
+ # @return [Google::Apis::DataformV1::ResetWorkspaceChangesResponse]
2443
+ #
2444
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2445
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2446
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2447
+ def reset_workspace_changes(name, reset_workspace_changes_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2448
+ command = make_simple_command(:post, 'v1/{+name}:reset', options)
2449
+ command.request_representation = Google::Apis::DataformV1::ResetWorkspaceChangesRequest::Representation
2450
+ command.request_object = reset_workspace_changes_request_object
2451
+ command.response_representation = Google::Apis::DataformV1::ResetWorkspaceChangesResponse::Representation
2452
+ command.response_class = Google::Apis::DataformV1::ResetWorkspaceChangesResponse
2453
+ command.params['name'] = name unless name.nil?
2454
+ command.query['fields'] = fields unless fields.nil?
2455
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2456
+ execute_or_queue_command(command, &block)
2457
+ end
2458
+
2459
+ # Finds the contents of a given Workspace directory by filter.
2460
+ # @param [String] workspace
2461
+ # Required. The workspace's name.
2462
+ # @param [String] filter
2463
+ # Optional. Optional filter for the returned list in filtering format. Filtering
2464
+ # is only currently supported on the `path` field. See https://google.aip.dev/
2465
+ # 160 for details.
2466
+ # @param [Fixnum] page_size
2467
+ # Optional. Maximum number of search results to return. The server may return
2468
+ # fewer items than requested. If unspecified, the server will pick an
2469
+ # appropriate default.
2470
+ # @param [String] page_token
2471
+ # Optional. Page token received from a previous `SearchFilesRequest` call.
2472
+ # Provide this to retrieve the subsequent page. When paginating, all other
2473
+ # parameters provided to `SearchFilesRequest`, with the exception of `page_size`,
2474
+ # must match the call that provided the page token.
2475
+ # @param [String] fields
2476
+ # Selector specifying which fields to include in a partial response.
2477
+ # @param [String] quota_user
2478
+ # Available to use for quota purposes for server-side applications. Can be any
2479
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2480
+ # @param [Google::Apis::RequestOptions] options
2481
+ # Request-specific options
2482
+ #
2483
+ # @yield [result, err] Result & error if block supplied
2484
+ # @yieldparam result [Google::Apis::DataformV1::SearchFilesResponse] parsed result object
2485
+ # @yieldparam err [StandardError] error object if request failed
2486
+ #
2487
+ # @return [Google::Apis::DataformV1::SearchFilesResponse]
2488
+ #
2489
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2490
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2491
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2492
+ def search_project_location_repository_workspace_files(workspace, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2493
+ command = make_simple_command(:get, 'v1/{+workspace}:searchFiles', options)
2494
+ command.response_representation = Google::Apis::DataformV1::SearchFilesResponse::Representation
2495
+ command.response_class = Google::Apis::DataformV1::SearchFilesResponse
2496
+ command.params['workspace'] = workspace unless workspace.nil?
2497
+ command.query['filter'] = filter unless filter.nil?
2498
+ command.query['pageSize'] = page_size unless page_size.nil?
2499
+ command.query['pageToken'] = page_token unless page_token.nil?
2500
+ command.query['fields'] = fields unless fields.nil?
2501
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2502
+ execute_or_queue_command(command, &block)
2503
+ end
2504
+
2505
+ # Sets the access control policy on the specified resource. Replaces any
2506
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
2507
+ # PERMISSION_DENIED` errors.
2508
+ # @param [String] resource
2509
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
2510
+ # names](https://cloud.google.com/apis/design/resource_names) for the
2511
+ # appropriate value for this field.
2512
+ # @param [Google::Apis::DataformV1::SetIamPolicyRequest] set_iam_policy_request_object
2513
+ # @param [String] fields
2514
+ # Selector specifying which fields to include in a partial response.
2515
+ # @param [String] quota_user
2516
+ # Available to use for quota purposes for server-side applications. Can be any
2517
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2518
+ # @param [Google::Apis::RequestOptions] options
2519
+ # Request-specific options
2520
+ #
2521
+ # @yield [result, err] Result & error if block supplied
2522
+ # @yieldparam result [Google::Apis::DataformV1::Policy] parsed result object
2523
+ # @yieldparam err [StandardError] error object if request failed
2524
+ #
2525
+ # @return [Google::Apis::DataformV1::Policy]
2526
+ #
2527
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2528
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2529
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2530
+ def set_workspace_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2531
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
2532
+ command.request_representation = Google::Apis::DataformV1::SetIamPolicyRequest::Representation
2533
+ command.request_object = set_iam_policy_request_object
2534
+ command.response_representation = Google::Apis::DataformV1::Policy::Representation
2535
+ command.response_class = Google::Apis::DataformV1::Policy
2536
+ command.params['resource'] = resource unless resource.nil?
2537
+ command.query['fields'] = fields unless fields.nil?
2538
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2539
+ execute_or_queue_command(command, &block)
2540
+ end
2541
+
2542
+ # Returns permissions that a caller has on the specified resource. If the
2543
+ # resource does not exist, this will return an empty set of permissions, not a `
2544
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
2545
+ # permission-aware UIs and command-line tools, not for authorization checking.
2546
+ # This operation may "fail open" without warning.
2547
+ # @param [String] resource
2548
+ # REQUIRED: The resource for which the policy detail is being requested. See [
2549
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
2550
+ # appropriate value for this field.
2551
+ # @param [Google::Apis::DataformV1::TestIamPermissionsRequest] test_iam_permissions_request_object
2552
+ # @param [String] fields
2553
+ # Selector specifying which fields to include in a partial response.
2554
+ # @param [String] quota_user
2555
+ # Available to use for quota purposes for server-side applications. Can be any
2556
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2557
+ # @param [Google::Apis::RequestOptions] options
2558
+ # Request-specific options
2559
+ #
2560
+ # @yield [result, err] Result & error if block supplied
2561
+ # @yieldparam result [Google::Apis::DataformV1::TestIamPermissionsResponse] parsed result object
2562
+ # @yieldparam err [StandardError] error object if request failed
2563
+ #
2564
+ # @return [Google::Apis::DataformV1::TestIamPermissionsResponse]
2565
+ #
2566
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2567
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2568
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2569
+ def test_workspace_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2570
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
2571
+ command.request_representation = Google::Apis::DataformV1::TestIamPermissionsRequest::Representation
2572
+ command.request_object = test_iam_permissions_request_object
2573
+ command.response_representation = Google::Apis::DataformV1::TestIamPermissionsResponse::Representation
2574
+ command.response_class = Google::Apis::DataformV1::TestIamPermissionsResponse
2575
+ command.params['resource'] = resource unless resource.nil?
2576
+ command.query['fields'] = fields unless fields.nil?
2577
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2578
+ execute_or_queue_command(command, &block)
2579
+ end
2580
+
2581
+ # Writes to a file (inside a Workspace).
2582
+ # @param [String] workspace
2583
+ # Required. The workspace's name.
2584
+ # @param [Google::Apis::DataformV1::WriteFileRequest] write_file_request_object
2585
+ # @param [String] fields
2586
+ # Selector specifying which fields to include in a partial response.
2587
+ # @param [String] quota_user
2588
+ # Available to use for quota purposes for server-side applications. Can be any
2589
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2590
+ # @param [Google::Apis::RequestOptions] options
2591
+ # Request-specific options
2592
+ #
2593
+ # @yield [result, err] Result & error if block supplied
2594
+ # @yieldparam result [Google::Apis::DataformV1::WriteFileResponse] parsed result object
2595
+ # @yieldparam err [StandardError] error object if request failed
2596
+ #
2597
+ # @return [Google::Apis::DataformV1::WriteFileResponse]
2598
+ #
2599
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2600
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2601
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2602
+ def write_workspace_file(workspace, write_file_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2603
+ command = make_simple_command(:post, 'v1/{+workspace}:writeFile', options)
2604
+ command.request_representation = Google::Apis::DataformV1::WriteFileRequest::Representation
2605
+ command.request_object = write_file_request_object
2606
+ command.response_representation = Google::Apis::DataformV1::WriteFileResponse::Representation
2607
+ command.response_class = Google::Apis::DataformV1::WriteFileResponse
2608
+ command.params['workspace'] = workspace unless workspace.nil?
2609
+ command.query['fields'] = fields unless fields.nil?
2610
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2611
+ execute_or_queue_command(command, &block)
2612
+ end
2613
+
2614
+ # Gets the access control policy for a resource. Returns an empty policy if the
2615
+ # resource exists and does not have a policy set.
2616
+ # @param [String] resource
2617
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
2618
+ # names](https://cloud.google.com/apis/design/resource_names) for the
2619
+ # appropriate value for this field.
2620
+ # @param [Fixnum] options_requested_policy_version
2621
+ # Optional. The maximum policy version that will be used to format the policy.
2622
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
2623
+ # rejected. Requests for policies with any conditional role bindings must
2624
+ # specify version 3. Policies with no conditional role bindings may specify any
2625
+ # valid value or leave the field unset. The policy in the response might use the
2626
+ # policy version that you specified, or it might use a lower policy version. For
2627
+ # example, if you specify version 3, but the policy has no conditional role
2628
+ # bindings, the response uses version 1. To learn which resources support
2629
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
2630
+ # google.com/iam/help/conditions/resource-policies).
2631
+ # @param [String] fields
2632
+ # Selector specifying which fields to include in a partial response.
2633
+ # @param [String] quota_user
2634
+ # Available to use for quota purposes for server-side applications. Can be any
2635
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2636
+ # @param [Google::Apis::RequestOptions] options
2637
+ # Request-specific options
2638
+ #
2639
+ # @yield [result, err] Result & error if block supplied
2640
+ # @yieldparam result [Google::Apis::DataformV1::Policy] parsed result object
2641
+ # @yieldparam err [StandardError] error object if request failed
2642
+ #
2643
+ # @return [Google::Apis::DataformV1::Policy]
2644
+ #
2645
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2646
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2647
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2648
+ def get_project_location_team_folder_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
2649
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
2650
+ command.response_representation = Google::Apis::DataformV1::Policy::Representation
2651
+ command.response_class = Google::Apis::DataformV1::Policy
2652
+ command.params['resource'] = resource unless resource.nil?
2653
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
2654
+ command.query['fields'] = fields unless fields.nil?
2655
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2656
+ execute_or_queue_command(command, &block)
2657
+ end
2658
+
2659
+ # Sets the access control policy on the specified resource. Replaces any
2660
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
2661
+ # PERMISSION_DENIED` errors.
2662
+ # @param [String] resource
2663
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
2664
+ # names](https://cloud.google.com/apis/design/resource_names) for the
2665
+ # appropriate value for this field.
2666
+ # @param [Google::Apis::DataformV1::SetIamPolicyRequest] set_iam_policy_request_object
2667
+ # @param [String] fields
2668
+ # Selector specifying which fields to include in a partial response.
2669
+ # @param [String] quota_user
2670
+ # Available to use for quota purposes for server-side applications. Can be any
2671
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2672
+ # @param [Google::Apis::RequestOptions] options
2673
+ # Request-specific options
2674
+ #
2675
+ # @yield [result, err] Result & error if block supplied
2676
+ # @yieldparam result [Google::Apis::DataformV1::Policy] parsed result object
2677
+ # @yieldparam err [StandardError] error object if request failed
2678
+ #
2679
+ # @return [Google::Apis::DataformV1::Policy]
2680
+ #
2681
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2682
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2683
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2684
+ def set_team_folder_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2685
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
2686
+ command.request_representation = Google::Apis::DataformV1::SetIamPolicyRequest::Representation
2687
+ command.request_object = set_iam_policy_request_object
2688
+ command.response_representation = Google::Apis::DataformV1::Policy::Representation
2689
+ command.response_class = Google::Apis::DataformV1::Policy
2690
+ command.params['resource'] = resource unless resource.nil?
2691
+ command.query['fields'] = fields unless fields.nil?
2692
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2693
+ execute_or_queue_command(command, &block)
2694
+ end
2695
+
2696
+ # Returns permissions that a caller has on the specified resource. If the
2697
+ # resource does not exist, this will return an empty set of permissions, not a `
2698
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
2699
+ # permission-aware UIs and command-line tools, not for authorization checking.
2700
+ # This operation may "fail open" without warning.
2701
+ # @param [String] resource
2702
+ # REQUIRED: The resource for which the policy detail is being requested. See [
2703
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
2704
+ # appropriate value for this field.
2705
+ # @param [Google::Apis::DataformV1::TestIamPermissionsRequest] test_iam_permissions_request_object
2706
+ # @param [String] fields
2707
+ # Selector specifying which fields to include in a partial response.
2708
+ # @param [String] quota_user
2709
+ # Available to use for quota purposes for server-side applications. Can be any
2710
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2711
+ # @param [Google::Apis::RequestOptions] options
2712
+ # Request-specific options
2713
+ #
2714
+ # @yield [result, err] Result & error if block supplied
2715
+ # @yieldparam result [Google::Apis::DataformV1::TestIamPermissionsResponse] parsed result object
2716
+ # @yieldparam err [StandardError] error object if request failed
2717
+ #
2718
+ # @return [Google::Apis::DataformV1::TestIamPermissionsResponse]
2719
+ #
2720
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2721
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2722
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2723
+ def test_team_folder_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2724
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
2725
+ command.request_representation = Google::Apis::DataformV1::TestIamPermissionsRequest::Representation
2726
+ command.request_object = test_iam_permissions_request_object
2727
+ command.response_representation = Google::Apis::DataformV1::TestIamPermissionsResponse::Representation
2728
+ command.response_class = Google::Apis::DataformV1::TestIamPermissionsResponse
2729
+ command.params['resource'] = resource unless resource.nil?
2730
+ command.query['fields'] = fields unless fields.nil?
2731
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2732
+ execute_or_queue_command(command, &block)
2733
+ end
2734
+
2735
+ protected
2736
+
2737
+ def apply_command_defaults(command)
2738
+ command.query['key'] = key unless key.nil?
2739
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2740
+ end
2741
+ end
2742
+ end
2743
+ end
2744
+ end