google-apis-dataform_v1 0.6.0 → 0.7.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,10 +113,15 @@ 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
@@ -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
@@ -2622,6 +2967,135 @@ module Google
2622
2967
  execute_or_queue_command(command, &block)
2623
2968
  end
2624
2969
 
2970
+ # Creates a new TeamFolder in a given project and location.
2971
+ # @param [String] parent
2972
+ # Required. The location in which to create the TeamFolder. Must be in the
2973
+ # format `projects/*/locations/*`.
2974
+ # @param [Google::Apis::DataformV1::TeamFolder] team_folder_object
2975
+ # @param [String] fields
2976
+ # Selector specifying which fields to include in a partial response.
2977
+ # @param [String] quota_user
2978
+ # Available to use for quota purposes for server-side applications. Can be any
2979
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2980
+ # @param [Google::Apis::RequestOptions] options
2981
+ # Request-specific options
2982
+ #
2983
+ # @yield [result, err] Result & error if block supplied
2984
+ # @yieldparam result [Google::Apis::DataformV1::TeamFolder] parsed result object
2985
+ # @yieldparam err [StandardError] error object if request failed
2986
+ #
2987
+ # @return [Google::Apis::DataformV1::TeamFolder]
2988
+ #
2989
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2990
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2991
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2992
+ def create_project_location_team_folder(parent, team_folder_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2993
+ command = make_simple_command(:post, 'v1/{+parent}/teamFolders', options)
2994
+ command.request_representation = Google::Apis::DataformV1::TeamFolder::Representation
2995
+ command.request_object = team_folder_object
2996
+ command.response_representation = Google::Apis::DataformV1::TeamFolder::Representation
2997
+ command.response_class = Google::Apis::DataformV1::TeamFolder
2998
+ command.params['parent'] = parent unless parent.nil?
2999
+ command.query['fields'] = fields unless fields.nil?
3000
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3001
+ execute_or_queue_command(command, &block)
3002
+ end
3003
+
3004
+ # Deletes a single TeamFolder.
3005
+ # @param [String] name
3006
+ # Required. The TeamFolder's name.
3007
+ # @param [String] fields
3008
+ # Selector specifying which fields to include in a partial response.
3009
+ # @param [String] quota_user
3010
+ # Available to use for quota purposes for server-side applications. Can be any
3011
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3012
+ # @param [Google::Apis::RequestOptions] options
3013
+ # Request-specific options
3014
+ #
3015
+ # @yield [result, err] Result & error if block supplied
3016
+ # @yieldparam result [Google::Apis::DataformV1::Empty] parsed result object
3017
+ # @yieldparam err [StandardError] error object if request failed
3018
+ #
3019
+ # @return [Google::Apis::DataformV1::Empty]
3020
+ #
3021
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3022
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3023
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3024
+ def delete_project_location_team_folder(name, fields: nil, quota_user: nil, options: nil, &block)
3025
+ command = make_simple_command(:delete, 'v1/{+name}', options)
3026
+ command.response_representation = Google::Apis::DataformV1::Empty::Representation
3027
+ command.response_class = Google::Apis::DataformV1::Empty
3028
+ command.params['name'] = name unless name.nil?
3029
+ command.query['fields'] = fields unless fields.nil?
3030
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3031
+ execute_or_queue_command(command, &block)
3032
+ end
3033
+
3034
+ # Deletes a TeamFolder with its contents (Folders, Repositories, Workspaces,
3035
+ # ReleaseConfigs, and WorkflowConfigs).
3036
+ # @param [String] name
3037
+ # Required. The TeamFolder's name. Format: projects/`project`/locations/`
3038
+ # location`/teamFolders/`team_folder`
3039
+ # @param [Google::Apis::DataformV1::DeleteTeamFolderTreeRequest] delete_team_folder_tree_request_object
3040
+ # @param [String] fields
3041
+ # Selector specifying which fields to include in a partial response.
3042
+ # @param [String] quota_user
3043
+ # Available to use for quota purposes for server-side applications. Can be any
3044
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3045
+ # @param [Google::Apis::RequestOptions] options
3046
+ # Request-specific options
3047
+ #
3048
+ # @yield [result, err] Result & error if block supplied
3049
+ # @yieldparam result [Google::Apis::DataformV1::Operation] parsed result object
3050
+ # @yieldparam err [StandardError] error object if request failed
3051
+ #
3052
+ # @return [Google::Apis::DataformV1::Operation]
3053
+ #
3054
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3055
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3056
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3057
+ def delete_project_location_team_folder_tree(name, delete_team_folder_tree_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3058
+ command = make_simple_command(:post, 'v1/{+name}:deleteTree', options)
3059
+ command.request_representation = Google::Apis::DataformV1::DeleteTeamFolderTreeRequest::Representation
3060
+ command.request_object = delete_team_folder_tree_request_object
3061
+ command.response_representation = Google::Apis::DataformV1::Operation::Representation
3062
+ command.response_class = Google::Apis::DataformV1::Operation
3063
+ command.params['name'] = name unless name.nil?
3064
+ command.query['fields'] = fields unless fields.nil?
3065
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3066
+ execute_or_queue_command(command, &block)
3067
+ end
3068
+
3069
+ # Fetches a single TeamFolder.
3070
+ # @param [String] name
3071
+ # Required. The TeamFolder's name.
3072
+ # @param [String] fields
3073
+ # Selector specifying which fields to include in a partial response.
3074
+ # @param [String] quota_user
3075
+ # Available to use for quota purposes for server-side applications. Can be any
3076
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3077
+ # @param [Google::Apis::RequestOptions] options
3078
+ # Request-specific options
3079
+ #
3080
+ # @yield [result, err] Result & error if block supplied
3081
+ # @yieldparam result [Google::Apis::DataformV1::TeamFolder] parsed result object
3082
+ # @yieldparam err [StandardError] error object if request failed
3083
+ #
3084
+ # @return [Google::Apis::DataformV1::TeamFolder]
3085
+ #
3086
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3087
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3088
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3089
+ def get_project_location_team_folder(name, fields: nil, quota_user: nil, options: nil, &block)
3090
+ command = make_simple_command(:get, 'v1/{+name}', options)
3091
+ command.response_representation = Google::Apis::DataformV1::TeamFolder::Representation
3092
+ command.response_class = Google::Apis::DataformV1::TeamFolder
3093
+ command.params['name'] = name unless name.nil?
3094
+ command.query['fields'] = fields unless fields.nil?
3095
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3096
+ execute_or_queue_command(command, &block)
3097
+ end
3098
+
2625
3099
  # Gets the access control policy for a resource. Returns an empty policy if the
2626
3100
  # resource exists and does not have a policy set.
2627
3101
  # @param [String] resource
@@ -2667,6 +3141,148 @@ module Google
2667
3141
  execute_or_queue_command(command, &block)
2668
3142
  end
2669
3143
 
3144
+ # Updates a single TeamFolder.
3145
+ # @param [String] name
3146
+ # Identifier. The TeamFolder's name.
3147
+ # @param [Google::Apis::DataformV1::TeamFolder] team_folder_object
3148
+ # @param [String] update_mask
3149
+ # Optional. Specifies the fields to be updated in the Folder. If left unset, all
3150
+ # fields will be updated.
3151
+ # @param [String] fields
3152
+ # Selector specifying which fields to include in a partial response.
3153
+ # @param [String] quota_user
3154
+ # Available to use for quota purposes for server-side applications. Can be any
3155
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3156
+ # @param [Google::Apis::RequestOptions] options
3157
+ # Request-specific options
3158
+ #
3159
+ # @yield [result, err] Result & error if block supplied
3160
+ # @yieldparam result [Google::Apis::DataformV1::TeamFolder] parsed result object
3161
+ # @yieldparam err [StandardError] error object if request failed
3162
+ #
3163
+ # @return [Google::Apis::DataformV1::TeamFolder]
3164
+ #
3165
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3166
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3167
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3168
+ def patch_project_location_team_folder(name, team_folder_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3169
+ command = make_simple_command(:patch, 'v1/{+name}', options)
3170
+ command.request_representation = Google::Apis::DataformV1::TeamFolder::Representation
3171
+ command.request_object = team_folder_object
3172
+ command.response_representation = Google::Apis::DataformV1::TeamFolder::Representation
3173
+ command.response_class = Google::Apis::DataformV1::TeamFolder
3174
+ command.params['name'] = name unless name.nil?
3175
+ command.query['updateMask'] = update_mask unless update_mask.nil?
3176
+ command.query['fields'] = fields unless fields.nil?
3177
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3178
+ execute_or_queue_command(command, &block)
3179
+ end
3180
+
3181
+ # Returns the contents of a given TeamFolder.
3182
+ # @param [String] team_folder
3183
+ # Required. Resource name of the TeamFolder to list contents for. Format: `
3184
+ # projects/*/locations/*/teamFolders/*`.
3185
+ # @param [String] filter
3186
+ # Optional. Optional filtering for the returned list. Filtering is currently
3187
+ # only supported on the `display_name` field. Example: * `filter="display_name="
3188
+ # MyFolder""`
3189
+ # @param [String] order_by
3190
+ # Optional. Field to additionally sort results by. Will order Folders before
3191
+ # Repositories, and then by `order_by` in ascending order. Supported keywords: `
3192
+ # display_name` (default), `create_time`, last_modified_time. Examples: * `
3193
+ # orderBy="display_name"` * `orderBy="display_name desc"`
3194
+ # @param [Fixnum] page_size
3195
+ # Optional. Maximum number of paths to return. The server may return fewer items
3196
+ # than requested. If unspecified, the server will pick an appropriate default.
3197
+ # @param [String] page_token
3198
+ # Optional. Page token received from a previous `QueryTeamFolderContents` call.
3199
+ # Provide this to retrieve the subsequent page. When paginating, all other
3200
+ # parameters provided to `QueryTeamFolderContents`, with the exception of `
3201
+ # page_size`, must match the call that provided the page token.
3202
+ # @param [String] fields
3203
+ # Selector specifying which fields to include in a partial response.
3204
+ # @param [String] quota_user
3205
+ # Available to use for quota purposes for server-side applications. Can be any
3206
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3207
+ # @param [Google::Apis::RequestOptions] options
3208
+ # Request-specific options
3209
+ #
3210
+ # @yield [result, err] Result & error if block supplied
3211
+ # @yieldparam result [Google::Apis::DataformV1::QueryTeamFolderContentsResponse] parsed result object
3212
+ # @yieldparam err [StandardError] error object if request failed
3213
+ #
3214
+ # @return [Google::Apis::DataformV1::QueryTeamFolderContentsResponse]
3215
+ #
3216
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3217
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3218
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3219
+ 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)
3220
+ command = make_simple_command(:get, 'v1/{+teamFolder}:queryContents', options)
3221
+ command.response_representation = Google::Apis::DataformV1::QueryTeamFolderContentsResponse::Representation
3222
+ command.response_class = Google::Apis::DataformV1::QueryTeamFolderContentsResponse
3223
+ command.params['teamFolder'] = team_folder unless team_folder.nil?
3224
+ command.query['filter'] = filter unless filter.nil?
3225
+ command.query['orderBy'] = order_by unless order_by.nil?
3226
+ command.query['pageSize'] = page_size unless page_size.nil?
3227
+ command.query['pageToken'] = page_token unless page_token.nil?
3228
+ command.query['fields'] = fields unless fields.nil?
3229
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3230
+ execute_or_queue_command(command, &block)
3231
+ end
3232
+
3233
+ # Returns all TeamFolders in a given location that the caller has access to and
3234
+ # match the provided filter.
3235
+ # @param [String] location
3236
+ # Required. Location in which to query TeamFolders. Format: `projects/*/
3237
+ # locations/*`.
3238
+ # @param [String] filter
3239
+ # Optional. Optional filtering for the returned list. Filtering is currently
3240
+ # only supported on the `display_name` field. Example: * `filter="display_name="
3241
+ # MyFolder""`
3242
+ # @param [String] order_by
3243
+ # Optional. Field to additionally sort results by. Supported keywords: `
3244
+ # display_name` (default), `create_time`, `last_modified_time`. Examples: * `
3245
+ # orderBy="display_name"` * `orderBy="display_name desc"`
3246
+ # @param [Fixnum] page_size
3247
+ # Optional. Maximum number of TeamFolders to return. The server may return fewer
3248
+ # items than requested. If unspecified, the server will pick an appropriate
3249
+ # default.
3250
+ # @param [String] page_token
3251
+ # Optional. Page token received from a previous `SearchTeamFolders` call.
3252
+ # Provide this to retrieve the subsequent page. When paginating, all other
3253
+ # parameters provided to `SearchTeamFolders`, with the exception of `page_size`,
3254
+ # must match the call that provided the page token.
3255
+ # @param [String] fields
3256
+ # Selector specifying which fields to include in a partial response.
3257
+ # @param [String] quota_user
3258
+ # Available to use for quota purposes for server-side applications. Can be any
3259
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3260
+ # @param [Google::Apis::RequestOptions] options
3261
+ # Request-specific options
3262
+ #
3263
+ # @yield [result, err] Result & error if block supplied
3264
+ # @yieldparam result [Google::Apis::DataformV1::SearchTeamFoldersResponse] parsed result object
3265
+ # @yieldparam err [StandardError] error object if request failed
3266
+ #
3267
+ # @return [Google::Apis::DataformV1::SearchTeamFoldersResponse]
3268
+ #
3269
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3270
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3271
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3272
+ 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)
3273
+ command = make_simple_command(:get, 'v1/{+location}/teamFolders:search', options)
3274
+ command.response_representation = Google::Apis::DataformV1::SearchTeamFoldersResponse::Representation
3275
+ command.response_class = Google::Apis::DataformV1::SearchTeamFoldersResponse
3276
+ command.params['location'] = location unless location.nil?
3277
+ command.query['filter'] = filter unless filter.nil?
3278
+ command.query['orderBy'] = order_by unless order_by.nil?
3279
+ command.query['pageSize'] = page_size unless page_size.nil?
3280
+ command.query['pageToken'] = page_token unless page_token.nil?
3281
+ command.query['fields'] = fields unless fields.nil?
3282
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3283
+ execute_or_queue_command(command, &block)
3284
+ end
3285
+
2670
3286
  # Sets the access control policy on the specified resource. Replaces any
2671
3287
  # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
2672
3288
  # PERMISSION_DENIED` errors.