google-apis-dataform_v1 0.6.0 → 0.8.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.
@@ -113,15 +113,20 @@ module Google
113
113
  end
114
114
 
115
115
  # Lists information about the supported locations for this service. This method
116
- # can be called in two ways: * **List all public locations:** Use the path `GET /
117
- # v1/locations`. * **List project-visible locations:** Use the path `GET /v1/
118
- # projects/`project_id`/locations`. This may include public locations as well as
119
- # private or other locations specifically visible to the project.
116
+ # lists locations based on the resource scope provided in the
117
+ # ListLocationsRequest.name field: * **Global locations**: If `name` is empty,
118
+ # the method lists the public locations available to all projects. * **Project-
119
+ # specific locations**: If `name` follows the format `projects/`project``, the
120
+ # method lists locations visible to that specific project. This includes public,
121
+ # private, or other project-specific locations enabled for the project. For gRPC
122
+ # and client library implementations, the resource name is passed as the `name`
123
+ # field. For direct service calls, the resource name is incorporated into the
124
+ # request path based on the specific service implementation and version.
120
125
  # @param [String] name
121
126
  # The resource that owns the locations collection, if applicable.
122
127
  # @param [Array<String>, String] extra_location_types
123
- # Optional. Do not use this field. It is unsupported and is ignored unless
124
- # explicitly documented otherwise. This is primarily for internal usage.
128
+ # Optional. Do not use this field unless explicitly documented otherwise. This
129
+ # is primarily for internal usage.
125
130
  # @param [String] filter
126
131
  # A filter to narrow down results to a preferred subset. The filtering language
127
132
  # accepts strings like `"displayName=tokyo"`, and is documented in more detail
@@ -163,6 +168,60 @@ module Google
163
168
  execute_or_queue_command(command, &block)
164
169
  end
165
170
 
171
+ # Returns the contents of a caller's root folder in a given location. The root
172
+ # folder contains all resources that are created by the user and not contained
173
+ # in any other folder.
174
+ # @param [String] location
175
+ # Required. Location of the user root folder to list contents for. Format:
176
+ # projects/*/locations/*
177
+ # @param [String] filter
178
+ # Optional. Optional filtering for the returned list. Filtering is currently
179
+ # only supported on the `display_name` field. Example: * `filter="display_name="
180
+ # MyFolder""`
181
+ # @param [String] order_by
182
+ # Optional. Field to additionally sort results by. Will order Folders before
183
+ # Repositories, and then by `order_by` in ascending order. Supported keywords:
184
+ # display_name (default), created_at, last_modified_at. Examples: * `orderBy="
185
+ # display_name"` * `orderBy="display_name desc"`
186
+ # @param [Fixnum] page_size
187
+ # Optional. Maximum number of paths to return. The server may return fewer items
188
+ # than requested. If unspecified, the server will pick an appropriate default.
189
+ # @param [String] page_token
190
+ # Optional. Page token received from a previous `QueryUserRootContents` call.
191
+ # Provide this to retrieve the subsequent page. When paginating, all other
192
+ # parameters provided to `QueryUserRootFolderContents`, with the exception of `
193
+ # page_size`, must match the call that provided the page token.
194
+ # @param [String] fields
195
+ # Selector specifying which fields to include in a partial response.
196
+ # @param [String] quota_user
197
+ # Available to use for quota purposes for server-side applications. Can be any
198
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
199
+ # @param [Google::Apis::RequestOptions] options
200
+ # Request-specific options
201
+ #
202
+ # @yield [result, err] Result & error if block supplied
203
+ # @yieldparam result [Google::Apis::DataformV1::QueryUserRootContentsResponse] parsed result object
204
+ # @yieldparam err [StandardError] error object if request failed
205
+ #
206
+ # @return [Google::Apis::DataformV1::QueryUserRootContentsResponse]
207
+ #
208
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
209
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
210
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
211
+ def query_project_location_user_root_contents(location, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
212
+ command = make_simple_command(:get, 'v1/{+location}:queryUserRootContents', options)
213
+ command.response_representation = Google::Apis::DataformV1::QueryUserRootContentsResponse::Representation
214
+ command.response_class = Google::Apis::DataformV1::QueryUserRootContentsResponse
215
+ command.params['location'] = location unless location.nil?
216
+ command.query['filter'] = filter unless filter.nil?
217
+ command.query['orderBy'] = order_by unless order_by.nil?
218
+ command.query['pageSize'] = page_size unless page_size.nil?
219
+ command.query['pageToken'] = page_token unless page_token.nil?
220
+ command.query['fields'] = fields unless fields.nil?
221
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
222
+ execute_or_queue_command(command, &block)
223
+ end
224
+
166
225
  # Update default config for a given project and location. **Note:** *This method
167
226
  # does not fully implement [AIP/134](https://google.aip.dev/134). The wildcard
168
227
  # entry (\*) is treated as a bad request, and when the `field_mask` is omitted,
@@ -202,6 +261,135 @@ module Google
202
261
  execute_or_queue_command(command, &block)
203
262
  end
204
263
 
264
+ # Creates a new Folder in a given project and location.
265
+ # @param [String] parent
266
+ # Required. The location in which to create the Folder. Must be in the format `
267
+ # projects/*/locations/*`.
268
+ # @param [Google::Apis::DataformV1::Folder] folder_object
269
+ # @param [String] fields
270
+ # Selector specifying which fields to include in a partial response.
271
+ # @param [String] quota_user
272
+ # Available to use for quota purposes for server-side applications. Can be any
273
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
274
+ # @param [Google::Apis::RequestOptions] options
275
+ # Request-specific options
276
+ #
277
+ # @yield [result, err] Result & error if block supplied
278
+ # @yieldparam result [Google::Apis::DataformV1::Folder] parsed result object
279
+ # @yieldparam err [StandardError] error object if request failed
280
+ #
281
+ # @return [Google::Apis::DataformV1::Folder]
282
+ #
283
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
284
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
285
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
286
+ def create_project_location_folder(parent, folder_object = nil, fields: nil, quota_user: nil, options: nil, &block)
287
+ command = make_simple_command(:post, 'v1/{+parent}/folders', options)
288
+ command.request_representation = Google::Apis::DataformV1::Folder::Representation
289
+ command.request_object = folder_object
290
+ command.response_representation = Google::Apis::DataformV1::Folder::Representation
291
+ command.response_class = Google::Apis::DataformV1::Folder
292
+ command.params['parent'] = parent unless parent.nil?
293
+ command.query['fields'] = fields unless fields.nil?
294
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
295
+ execute_or_queue_command(command, &block)
296
+ end
297
+
298
+ # Deletes a single Folder.
299
+ # @param [String] name
300
+ # Required. The Folder's name.
301
+ # @param [String] fields
302
+ # Selector specifying which fields to include in a partial response.
303
+ # @param [String] quota_user
304
+ # Available to use for quota purposes for server-side applications. Can be any
305
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
306
+ # @param [Google::Apis::RequestOptions] options
307
+ # Request-specific options
308
+ #
309
+ # @yield [result, err] Result & error if block supplied
310
+ # @yieldparam result [Google::Apis::DataformV1::Empty] parsed result object
311
+ # @yieldparam err [StandardError] error object if request failed
312
+ #
313
+ # @return [Google::Apis::DataformV1::Empty]
314
+ #
315
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
316
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
317
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
318
+ def delete_project_location_folder(name, fields: nil, quota_user: nil, options: nil, &block)
319
+ command = make_simple_command(:delete, 'v1/{+name}', options)
320
+ command.response_representation = Google::Apis::DataformV1::Empty::Representation
321
+ command.response_class = Google::Apis::DataformV1::Empty
322
+ command.params['name'] = name unless name.nil?
323
+ command.query['fields'] = fields unless fields.nil?
324
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
325
+ execute_or_queue_command(command, &block)
326
+ end
327
+
328
+ # Deletes a Folder with its contents (Folders, Repositories, Workspaces,
329
+ # ReleaseConfigs, and WorkflowConfigs).
330
+ # @param [String] name
331
+ # Required. The Folder's name. Format: projects/`project`/locations/`location`/
332
+ # folders/`folder`
333
+ # @param [Google::Apis::DataformV1::DeleteFolderTreeRequest] delete_folder_tree_request_object
334
+ # @param [String] fields
335
+ # Selector specifying which fields to include in a partial response.
336
+ # @param [String] quota_user
337
+ # Available to use for quota purposes for server-side applications. Can be any
338
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
339
+ # @param [Google::Apis::RequestOptions] options
340
+ # Request-specific options
341
+ #
342
+ # @yield [result, err] Result & error if block supplied
343
+ # @yieldparam result [Google::Apis::DataformV1::Operation] parsed result object
344
+ # @yieldparam err [StandardError] error object if request failed
345
+ #
346
+ # @return [Google::Apis::DataformV1::Operation]
347
+ #
348
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
349
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
350
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
351
+ def delete_project_location_folder_tree(name, delete_folder_tree_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
352
+ command = make_simple_command(:post, 'v1/{+name}:deleteTree', options)
353
+ command.request_representation = Google::Apis::DataformV1::DeleteFolderTreeRequest::Representation
354
+ command.request_object = delete_folder_tree_request_object
355
+ command.response_representation = Google::Apis::DataformV1::Operation::Representation
356
+ command.response_class = Google::Apis::DataformV1::Operation
357
+ command.params['name'] = name unless name.nil?
358
+ command.query['fields'] = fields unless fields.nil?
359
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
360
+ execute_or_queue_command(command, &block)
361
+ end
362
+
363
+ # Fetches a single Folder.
364
+ # @param [String] name
365
+ # Required. The Folder's name.
366
+ # @param [String] fields
367
+ # Selector specifying which fields to include in a partial response.
368
+ # @param [String] quota_user
369
+ # Available to use for quota purposes for server-side applications. Can be any
370
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
371
+ # @param [Google::Apis::RequestOptions] options
372
+ # Request-specific options
373
+ #
374
+ # @yield [result, err] Result & error if block supplied
375
+ # @yieldparam result [Google::Apis::DataformV1::Folder] parsed result object
376
+ # @yieldparam err [StandardError] error object if request failed
377
+ #
378
+ # @return [Google::Apis::DataformV1::Folder]
379
+ #
380
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
381
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
382
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
383
+ def get_project_location_folder(name, fields: nil, quota_user: nil, options: nil, &block)
384
+ command = make_simple_command(:get, 'v1/{+name}', options)
385
+ command.response_representation = Google::Apis::DataformV1::Folder::Representation
386
+ command.response_class = Google::Apis::DataformV1::Folder
387
+ command.params['name'] = name unless name.nil?
388
+ command.query['fields'] = fields unless fields.nil?
389
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
390
+ execute_or_queue_command(command, &block)
391
+ end
392
+
205
393
  # Gets the access control policy for a resource. Returns an empty policy if the
206
394
  # resource exists and does not have a policy set.
207
395
  # @param [String] resource
@@ -247,6 +435,130 @@ module Google
247
435
  execute_or_queue_command(command, &block)
248
436
  end
249
437
 
438
+ # Moves a Folder to a new Folder, TeamFolder, or the root location.
439
+ # @param [String] name
440
+ # Required. The full resource name of the Folder to move.
441
+ # @param [Google::Apis::DataformV1::MoveFolderRequest] move_folder_request_object
442
+ # @param [String] fields
443
+ # Selector specifying which fields to include in a partial response.
444
+ # @param [String] quota_user
445
+ # Available to use for quota purposes for server-side applications. Can be any
446
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
447
+ # @param [Google::Apis::RequestOptions] options
448
+ # Request-specific options
449
+ #
450
+ # @yield [result, err] Result & error if block supplied
451
+ # @yieldparam result [Google::Apis::DataformV1::Operation] parsed result object
452
+ # @yieldparam err [StandardError] error object if request failed
453
+ #
454
+ # @return [Google::Apis::DataformV1::Operation]
455
+ #
456
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
457
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
458
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
459
+ def move_folder(name, move_folder_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
460
+ command = make_simple_command(:post, 'v1/{+name}:move', options)
461
+ command.request_representation = Google::Apis::DataformV1::MoveFolderRequest::Representation
462
+ command.request_object = move_folder_request_object
463
+ command.response_representation = Google::Apis::DataformV1::Operation::Representation
464
+ command.response_class = Google::Apis::DataformV1::Operation
465
+ command.params['name'] = name unless name.nil?
466
+ command.query['fields'] = fields unless fields.nil?
467
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
468
+ execute_or_queue_command(command, &block)
469
+ end
470
+
471
+ # Updates a single Folder.
472
+ # @param [String] name
473
+ # Identifier. The Folder's name.
474
+ # @param [Google::Apis::DataformV1::Folder] folder_object
475
+ # @param [String] update_mask
476
+ # Optional. Specifies the fields to be updated in the Folder. If left unset, all
477
+ # fields that can be updated, will be updated. A few fields cannot be updated
478
+ # and will be ignored if specified in the update_mask (e.g. parent_name,
479
+ # team_folder_name).
480
+ # @param [String] fields
481
+ # Selector specifying which fields to include in a partial response.
482
+ # @param [String] quota_user
483
+ # Available to use for quota purposes for server-side applications. Can be any
484
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
485
+ # @param [Google::Apis::RequestOptions] options
486
+ # Request-specific options
487
+ #
488
+ # @yield [result, err] Result & error if block supplied
489
+ # @yieldparam result [Google::Apis::DataformV1::Folder] parsed result object
490
+ # @yieldparam err [StandardError] error object if request failed
491
+ #
492
+ # @return [Google::Apis::DataformV1::Folder]
493
+ #
494
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
495
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
496
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
497
+ def patch_project_location_folder(name, folder_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
498
+ command = make_simple_command(:patch, 'v1/{+name}', options)
499
+ command.request_representation = Google::Apis::DataformV1::Folder::Representation
500
+ command.request_object = folder_object
501
+ command.response_representation = Google::Apis::DataformV1::Folder::Representation
502
+ command.response_class = Google::Apis::DataformV1::Folder
503
+ command.params['name'] = name unless name.nil?
504
+ command.query['updateMask'] = update_mask unless update_mask.nil?
505
+ command.query['fields'] = fields unless fields.nil?
506
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
507
+ execute_or_queue_command(command, &block)
508
+ end
509
+
510
+ # Returns the contents of a given Folder.
511
+ # @param [String] folder
512
+ # Required. Resource name of the Folder to list contents for. Format: projects/*/
513
+ # locations/*/folders/*
514
+ # @param [String] filter
515
+ # Optional. Optional filtering for the returned list. Filtering is currently
516
+ # only supported on the `display_name` field. Example: * `filter="display_name="
517
+ # MyFolder""`
518
+ # @param [String] order_by
519
+ # Optional. Field to additionally sort results by. Will order Folders before
520
+ # Repositories, and then by `order_by` in ascending order. Supported keywords:
521
+ # display_name (default), create_time, last_modified_time. Examples: * `orderBy="
522
+ # display_name"` * `orderBy="display_name desc"`
523
+ # @param [Fixnum] page_size
524
+ # Optional. Maximum number of paths to return. The server may return fewer items
525
+ # than requested. If unspecified, the server will pick an appropriate default.
526
+ # @param [String] page_token
527
+ # Optional. Page token received from a previous `QueryFolderContents` call.
528
+ # Provide this to retrieve the subsequent page. When paginating, all other
529
+ # parameters provided to `QueryFolderContents`, with the exception of `page_size`
530
+ # , must match the call that provided the page token.
531
+ # @param [String] fields
532
+ # Selector specifying which fields to include in a partial response.
533
+ # @param [String] quota_user
534
+ # Available to use for quota purposes for server-side applications. Can be any
535
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
536
+ # @param [Google::Apis::RequestOptions] options
537
+ # Request-specific options
538
+ #
539
+ # @yield [result, err] Result & error if block supplied
540
+ # @yieldparam result [Google::Apis::DataformV1::QueryFolderContentsResponse] parsed result object
541
+ # @yieldparam err [StandardError] error object if request failed
542
+ #
543
+ # @return [Google::Apis::DataformV1::QueryFolderContentsResponse]
544
+ #
545
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
546
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
547
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
548
+ def query_project_location_folder_folder_contents(folder, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
549
+ command = make_simple_command(:get, 'v1/{+folder}:queryFolderContents', options)
550
+ command.response_representation = Google::Apis::DataformV1::QueryFolderContentsResponse::Representation
551
+ command.response_class = Google::Apis::DataformV1::QueryFolderContentsResponse
552
+ command.params['folder'] = folder unless folder.nil?
553
+ command.query['filter'] = filter unless filter.nil?
554
+ command.query['orderBy'] = order_by unless order_by.nil?
555
+ command.query['pageSize'] = page_size unless page_size.nil?
556
+ command.query['pageToken'] = page_token unless page_token.nil?
557
+ command.query['fields'] = fields unless fields.nil?
558
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
559
+ execute_or_queue_command(command, &block)
560
+ end
561
+
250
562
  # Sets the access control policy on the specified resource. Replaces any
251
563
  # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
252
564
  # PERMISSION_DENIED` errors.
@@ -815,6 +1127,39 @@ module Google
815
1127
  execute_or_queue_command(command, &block)
816
1128
  end
817
1129
 
1130
+ # Moves a Repository to a new location.
1131
+ # @param [String] name
1132
+ # Required. The full resource name of the repository to move.
1133
+ # @param [Google::Apis::DataformV1::MoveRepositoryRequest] move_repository_request_object
1134
+ # @param [String] fields
1135
+ # Selector specifying which fields to include in a partial response.
1136
+ # @param [String] quota_user
1137
+ # Available to use for quota purposes for server-side applications. Can be any
1138
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1139
+ # @param [Google::Apis::RequestOptions] options
1140
+ # Request-specific options
1141
+ #
1142
+ # @yield [result, err] Result & error if block supplied
1143
+ # @yieldparam result [Google::Apis::DataformV1::Operation] parsed result object
1144
+ # @yieldparam err [StandardError] error object if request failed
1145
+ #
1146
+ # @return [Google::Apis::DataformV1::Operation]
1147
+ #
1148
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1149
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1150
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1151
+ def move_repository(name, move_repository_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1152
+ command = make_simple_command(:post, 'v1/{+name}:move', options)
1153
+ command.request_representation = Google::Apis::DataformV1::MoveRepositoryRequest::Representation
1154
+ command.request_object = move_repository_request_object
1155
+ command.response_representation = Google::Apis::DataformV1::Operation::Representation
1156
+ command.response_class = Google::Apis::DataformV1::Operation
1157
+ command.params['name'] = name unless name.nil?
1158
+ command.query['fields'] = fields unless fields.nil?
1159
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1160
+ execute_or_queue_command(command, &block)
1161
+ end
1162
+
818
1163
  # Updates a single Repository. **Note:** *This method does not fully implement [
819
1164
  # AIP/134](https://google.aip.dev/134). The wildcard entry (\*) is treated as a
820
1165
  # bad request, and when the `field_mask` is omitted, the request is treated as a
@@ -1055,7 +1400,8 @@ module Google
1055
1400
 
1056
1401
  # Fetches a single CompilationResult.
1057
1402
  # @param [String] name
1058
- # Required. The compilation result's name.
1403
+ # Required. The compilation result's name. LINT.ThenChange(//depot/google3/
1404
+ # google/cloud/dataform/v2main/data_pipelines.proto:GetCompilationResultRequest)
1059
1405
  # @param [String] fields
1060
1406
  # Selector specifying which fields to include in a partial response.
1061
1407
  # @param [String] quota_user
@@ -1088,7 +1434,8 @@ module Google
1088
1434
  # Required. The repository in which to list compilation results. Must be in the
1089
1435
  # format `projects/*/locations/*/repositories/*`.
1090
1436
  # @param [String] filter
1091
- # Optional. Filter for the returned list.
1437
+ # Optional. Filter for the returned list. LINT.ThenChange(//depot/google3/google/
1438
+ # cloud/dataform/v2main/data_pipelines.proto:ListCompilationResultsRequest)
1092
1439
  # @param [String] order_by
1093
1440
  # Optional. This field only supports ordering by `name` and `create_time`. If
1094
1441
  # unspecified, the server will choose the ordering. If specified, the default
@@ -1185,7 +1532,9 @@ module Google
1185
1532
  # @param [Google::Apis::DataformV1::ReleaseConfig] release_config_object
1186
1533
  # @param [String] release_config_id
1187
1534
  # Required. The ID to use for the release config, which will become the final
1188
- # component of the release config's resource name.
1535
+ # component of the release config's resource name. LINT.ThenChange(//depot/
1536
+ # google3/google/cloud/dataform/v2main/data_pipelines.proto:
1537
+ # CreateReleaseConfigRequest)
1189
1538
  # @param [String] fields
1190
1539
  # Selector specifying which fields to include in a partial response.
1191
1540
  # @param [String] quota_user
@@ -1218,7 +1567,8 @@ module Google
1218
1567
 
1219
1568
  # Deletes a single ReleaseConfig.
1220
1569
  # @param [String] name
1221
- # Required. The release config's name.
1570
+ # Required. The release config's name. LINT.ThenChange(//depot/google3/google/
1571
+ # cloud/dataform/v2main/data_pipelines.proto:DeleteReleaseConfigRequest)
1222
1572
  # @param [String] fields
1223
1573
  # Selector specifying which fields to include in a partial response.
1224
1574
  # @param [String] quota_user
@@ -1248,7 +1598,8 @@ module Google
1248
1598
 
1249
1599
  # Fetches a single ReleaseConfig.
1250
1600
  # @param [String] name
1251
- # Required. The release config's name.
1601
+ # Required. The release config's name. LINT.ThenChange(//depot/google3/google/
1602
+ # cloud/dataform/v2main/data_pipelines.proto:GetReleaseConfigRequest)
1252
1603
  # @param [String] fields
1253
1604
  # Selector specifying which fields to include in a partial response.
1254
1605
  # @param [String] quota_user
@@ -1288,7 +1639,9 @@ module Google
1288
1639
  # Optional. Page token received from a previous `ListReleaseConfigs` call.
1289
1640
  # Provide this to retrieve the subsequent page. When paginating, all other
1290
1641
  # parameters provided to `ListReleaseConfigs`, with the exception of `page_size`,
1291
- # must match the call that provided the page token.
1642
+ # must match the call that provided the page token. LINT.ThenChange(//depot/
1643
+ # google3/google/cloud/dataform/v2main/data_pipelines.proto:
1644
+ # ListReleaseConfigsRequest)
1292
1645
  # @param [String] fields
1293
1646
  # Selector specifying which fields to include in a partial response.
1294
1647
  # @param [String] quota_user
@@ -2622,6 +2975,135 @@ module Google
2622
2975
  execute_or_queue_command(command, &block)
2623
2976
  end
2624
2977
 
2978
+ # Creates a new TeamFolder in a given project and location.
2979
+ # @param [String] parent
2980
+ # Required. The location in which to create the TeamFolder. Must be in the
2981
+ # format `projects/*/locations/*`.
2982
+ # @param [Google::Apis::DataformV1::TeamFolder] team_folder_object
2983
+ # @param [String] fields
2984
+ # Selector specifying which fields to include in a partial response.
2985
+ # @param [String] quota_user
2986
+ # Available to use for quota purposes for server-side applications. Can be any
2987
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2988
+ # @param [Google::Apis::RequestOptions] options
2989
+ # Request-specific options
2990
+ #
2991
+ # @yield [result, err] Result & error if block supplied
2992
+ # @yieldparam result [Google::Apis::DataformV1::TeamFolder] parsed result object
2993
+ # @yieldparam err [StandardError] error object if request failed
2994
+ #
2995
+ # @return [Google::Apis::DataformV1::TeamFolder]
2996
+ #
2997
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2998
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2999
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3000
+ def create_project_location_team_folder(parent, team_folder_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3001
+ command = make_simple_command(:post, 'v1/{+parent}/teamFolders', options)
3002
+ command.request_representation = Google::Apis::DataformV1::TeamFolder::Representation
3003
+ command.request_object = team_folder_object
3004
+ command.response_representation = Google::Apis::DataformV1::TeamFolder::Representation
3005
+ command.response_class = Google::Apis::DataformV1::TeamFolder
3006
+ command.params['parent'] = parent unless parent.nil?
3007
+ command.query['fields'] = fields unless fields.nil?
3008
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3009
+ execute_or_queue_command(command, &block)
3010
+ end
3011
+
3012
+ # Deletes a single TeamFolder.
3013
+ # @param [String] name
3014
+ # Required. The TeamFolder's name.
3015
+ # @param [String] fields
3016
+ # Selector specifying which fields to include in a partial response.
3017
+ # @param [String] quota_user
3018
+ # Available to use for quota purposes for server-side applications. Can be any
3019
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3020
+ # @param [Google::Apis::RequestOptions] options
3021
+ # Request-specific options
3022
+ #
3023
+ # @yield [result, err] Result & error if block supplied
3024
+ # @yieldparam result [Google::Apis::DataformV1::Empty] parsed result object
3025
+ # @yieldparam err [StandardError] error object if request failed
3026
+ #
3027
+ # @return [Google::Apis::DataformV1::Empty]
3028
+ #
3029
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3030
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3031
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3032
+ def delete_project_location_team_folder(name, fields: nil, quota_user: nil, options: nil, &block)
3033
+ command = make_simple_command(:delete, 'v1/{+name}', options)
3034
+ command.response_representation = Google::Apis::DataformV1::Empty::Representation
3035
+ command.response_class = Google::Apis::DataformV1::Empty
3036
+ command.params['name'] = name unless name.nil?
3037
+ command.query['fields'] = fields unless fields.nil?
3038
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3039
+ execute_or_queue_command(command, &block)
3040
+ end
3041
+
3042
+ # Deletes a TeamFolder with its contents (Folders, Repositories, Workspaces,
3043
+ # ReleaseConfigs, and WorkflowConfigs).
3044
+ # @param [String] name
3045
+ # Required. The TeamFolder's name. Format: projects/`project`/locations/`
3046
+ # location`/teamFolders/`team_folder`
3047
+ # @param [Google::Apis::DataformV1::DeleteTeamFolderTreeRequest] delete_team_folder_tree_request_object
3048
+ # @param [String] fields
3049
+ # Selector specifying which fields to include in a partial response.
3050
+ # @param [String] quota_user
3051
+ # Available to use for quota purposes for server-side applications. Can be any
3052
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3053
+ # @param [Google::Apis::RequestOptions] options
3054
+ # Request-specific options
3055
+ #
3056
+ # @yield [result, err] Result & error if block supplied
3057
+ # @yieldparam result [Google::Apis::DataformV1::Operation] parsed result object
3058
+ # @yieldparam err [StandardError] error object if request failed
3059
+ #
3060
+ # @return [Google::Apis::DataformV1::Operation]
3061
+ #
3062
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3063
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3064
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3065
+ def delete_project_location_team_folder_tree(name, delete_team_folder_tree_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3066
+ command = make_simple_command(:post, 'v1/{+name}:deleteTree', options)
3067
+ command.request_representation = Google::Apis::DataformV1::DeleteTeamFolderTreeRequest::Representation
3068
+ command.request_object = delete_team_folder_tree_request_object
3069
+ command.response_representation = Google::Apis::DataformV1::Operation::Representation
3070
+ command.response_class = Google::Apis::DataformV1::Operation
3071
+ command.params['name'] = name unless name.nil?
3072
+ command.query['fields'] = fields unless fields.nil?
3073
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3074
+ execute_or_queue_command(command, &block)
3075
+ end
3076
+
3077
+ # Fetches a single TeamFolder.
3078
+ # @param [String] name
3079
+ # Required. The TeamFolder's name.
3080
+ # @param [String] fields
3081
+ # Selector specifying which fields to include in a partial response.
3082
+ # @param [String] quota_user
3083
+ # Available to use for quota purposes for server-side applications. Can be any
3084
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3085
+ # @param [Google::Apis::RequestOptions] options
3086
+ # Request-specific options
3087
+ #
3088
+ # @yield [result, err] Result & error if block supplied
3089
+ # @yieldparam result [Google::Apis::DataformV1::TeamFolder] parsed result object
3090
+ # @yieldparam err [StandardError] error object if request failed
3091
+ #
3092
+ # @return [Google::Apis::DataformV1::TeamFolder]
3093
+ #
3094
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3095
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3096
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3097
+ def get_project_location_team_folder(name, fields: nil, quota_user: nil, options: nil, &block)
3098
+ command = make_simple_command(:get, 'v1/{+name}', options)
3099
+ command.response_representation = Google::Apis::DataformV1::TeamFolder::Representation
3100
+ command.response_class = Google::Apis::DataformV1::TeamFolder
3101
+ command.params['name'] = name unless name.nil?
3102
+ command.query['fields'] = fields unless fields.nil?
3103
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3104
+ execute_or_queue_command(command, &block)
3105
+ end
3106
+
2625
3107
  # Gets the access control policy for a resource. Returns an empty policy if the
2626
3108
  # resource exists and does not have a policy set.
2627
3109
  # @param [String] resource
@@ -2667,6 +3149,148 @@ module Google
2667
3149
  execute_or_queue_command(command, &block)
2668
3150
  end
2669
3151
 
3152
+ # Updates a single TeamFolder.
3153
+ # @param [String] name
3154
+ # Identifier. The TeamFolder's name.
3155
+ # @param [Google::Apis::DataformV1::TeamFolder] team_folder_object
3156
+ # @param [String] update_mask
3157
+ # Optional. Specifies the fields to be updated in the Folder. If left unset, all
3158
+ # fields will be updated.
3159
+ # @param [String] fields
3160
+ # Selector specifying which fields to include in a partial response.
3161
+ # @param [String] quota_user
3162
+ # Available to use for quota purposes for server-side applications. Can be any
3163
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3164
+ # @param [Google::Apis::RequestOptions] options
3165
+ # Request-specific options
3166
+ #
3167
+ # @yield [result, err] Result & error if block supplied
3168
+ # @yieldparam result [Google::Apis::DataformV1::TeamFolder] parsed result object
3169
+ # @yieldparam err [StandardError] error object if request failed
3170
+ #
3171
+ # @return [Google::Apis::DataformV1::TeamFolder]
3172
+ #
3173
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3174
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3175
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3176
+ def patch_project_location_team_folder(name, team_folder_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3177
+ command = make_simple_command(:patch, 'v1/{+name}', options)
3178
+ command.request_representation = Google::Apis::DataformV1::TeamFolder::Representation
3179
+ command.request_object = team_folder_object
3180
+ command.response_representation = Google::Apis::DataformV1::TeamFolder::Representation
3181
+ command.response_class = Google::Apis::DataformV1::TeamFolder
3182
+ command.params['name'] = name unless name.nil?
3183
+ command.query['updateMask'] = update_mask unless update_mask.nil?
3184
+ command.query['fields'] = fields unless fields.nil?
3185
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3186
+ execute_or_queue_command(command, &block)
3187
+ end
3188
+
3189
+ # Returns the contents of a given TeamFolder.
3190
+ # @param [String] team_folder
3191
+ # Required. Resource name of the TeamFolder to list contents for. Format: `
3192
+ # projects/*/locations/*/teamFolders/*`.
3193
+ # @param [String] filter
3194
+ # Optional. Optional filtering for the returned list. Filtering is currently
3195
+ # only supported on the `display_name` field. Example: * `filter="display_name="
3196
+ # MyFolder""`
3197
+ # @param [String] order_by
3198
+ # Optional. Field to additionally sort results by. Will order Folders before
3199
+ # Repositories, and then by `order_by` in ascending order. Supported keywords: `
3200
+ # display_name` (default), `create_time`, last_modified_time. Examples: * `
3201
+ # orderBy="display_name"` * `orderBy="display_name desc"`
3202
+ # @param [Fixnum] page_size
3203
+ # Optional. Maximum number of paths to return. The server may return fewer items
3204
+ # than requested. If unspecified, the server will pick an appropriate default.
3205
+ # @param [String] page_token
3206
+ # Optional. Page token received from a previous `QueryTeamFolderContents` call.
3207
+ # Provide this to retrieve the subsequent page. When paginating, all other
3208
+ # parameters provided to `QueryTeamFolderContents`, with the exception of `
3209
+ # page_size`, must match the call that provided the page token.
3210
+ # @param [String] fields
3211
+ # Selector specifying which fields to include in a partial response.
3212
+ # @param [String] quota_user
3213
+ # Available to use for quota purposes for server-side applications. Can be any
3214
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3215
+ # @param [Google::Apis::RequestOptions] options
3216
+ # Request-specific options
3217
+ #
3218
+ # @yield [result, err] Result & error if block supplied
3219
+ # @yieldparam result [Google::Apis::DataformV1::QueryTeamFolderContentsResponse] parsed result object
3220
+ # @yieldparam err [StandardError] error object if request failed
3221
+ #
3222
+ # @return [Google::Apis::DataformV1::QueryTeamFolderContentsResponse]
3223
+ #
3224
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3225
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3226
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3227
+ def query_project_location_team_folder_contents(team_folder, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3228
+ command = make_simple_command(:get, 'v1/{+teamFolder}:queryContents', options)
3229
+ command.response_representation = Google::Apis::DataformV1::QueryTeamFolderContentsResponse::Representation
3230
+ command.response_class = Google::Apis::DataformV1::QueryTeamFolderContentsResponse
3231
+ command.params['teamFolder'] = team_folder unless team_folder.nil?
3232
+ command.query['filter'] = filter unless filter.nil?
3233
+ command.query['orderBy'] = order_by unless order_by.nil?
3234
+ command.query['pageSize'] = page_size unless page_size.nil?
3235
+ command.query['pageToken'] = page_token unless page_token.nil?
3236
+ command.query['fields'] = fields unless fields.nil?
3237
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3238
+ execute_or_queue_command(command, &block)
3239
+ end
3240
+
3241
+ # Returns all TeamFolders in a given location that the caller has access to and
3242
+ # match the provided filter.
3243
+ # @param [String] location
3244
+ # Required. Location in which to query TeamFolders. Format: `projects/*/
3245
+ # locations/*`.
3246
+ # @param [String] filter
3247
+ # Optional. Optional filtering for the returned list. Filtering is currently
3248
+ # only supported on the `display_name` field. Example: * `filter="display_name="
3249
+ # MyFolder""`
3250
+ # @param [String] order_by
3251
+ # Optional. Field to additionally sort results by. Supported keywords: `
3252
+ # display_name` (default), `create_time`, `last_modified_time`. Examples: * `
3253
+ # orderBy="display_name"` * `orderBy="display_name desc"`
3254
+ # @param [Fixnum] page_size
3255
+ # Optional. Maximum number of TeamFolders to return. The server may return fewer
3256
+ # items than requested. If unspecified, the server will pick an appropriate
3257
+ # default.
3258
+ # @param [String] page_token
3259
+ # Optional. Page token received from a previous `SearchTeamFolders` call.
3260
+ # Provide this to retrieve the subsequent page. When paginating, all other
3261
+ # parameters provided to `SearchTeamFolders`, with the exception of `page_size`,
3262
+ # must match the call that provided the page token.
3263
+ # @param [String] fields
3264
+ # Selector specifying which fields to include in a partial response.
3265
+ # @param [String] quota_user
3266
+ # Available to use for quota purposes for server-side applications. Can be any
3267
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3268
+ # @param [Google::Apis::RequestOptions] options
3269
+ # Request-specific options
3270
+ #
3271
+ # @yield [result, err] Result & error if block supplied
3272
+ # @yieldparam result [Google::Apis::DataformV1::SearchTeamFoldersResponse] parsed result object
3273
+ # @yieldparam err [StandardError] error object if request failed
3274
+ #
3275
+ # @return [Google::Apis::DataformV1::SearchTeamFoldersResponse]
3276
+ #
3277
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3278
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3279
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3280
+ def search_project_location_team_folders(location, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3281
+ command = make_simple_command(:get, 'v1/{+location}/teamFolders:search', options)
3282
+ command.response_representation = Google::Apis::DataformV1::SearchTeamFoldersResponse::Representation
3283
+ command.response_class = Google::Apis::DataformV1::SearchTeamFoldersResponse
3284
+ command.params['location'] = location unless location.nil?
3285
+ command.query['filter'] = filter unless filter.nil?
3286
+ command.query['orderBy'] = order_by unless order_by.nil?
3287
+ command.query['pageSize'] = page_size unless page_size.nil?
3288
+ command.query['pageToken'] = page_token unless page_token.nil?
3289
+ command.query['fields'] = fields unless fields.nil?
3290
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3291
+ execute_or_queue_command(command, &block)
3292
+ end
3293
+
2670
3294
  # Sets the access control policy on the specified resource. Replaces any
2671
3295
  # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
2672
3296
  # PERMISSION_DENIED` errors.