google-cloud-resource_manager-v3 0.4.0 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (61) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/lib/google/cloud/resource_manager/v3/folders/client.rb +47 -35
  4. data/lib/google/cloud/resource_manager/v3/folders/operations.rb +2 -2
  5. data/lib/google/cloud/resource_manager/v3/folders/rest/client.rb +47 -35
  6. data/lib/google/cloud/resource_manager/v3/folders/rest/operations.rb +2 -2
  7. data/lib/google/cloud/resource_manager/v3/organizations/client.rb +12 -10
  8. data/lib/google/cloud/resource_manager/v3/organizations/rest/client.rb +12 -10
  9. data/lib/google/cloud/resource_manager/v3/projects/client.rb +44 -39
  10. data/lib/google/cloud/resource_manager/v3/projects/operations.rb +2 -2
  11. data/lib/google/cloud/resource_manager/v3/projects/rest/client.rb +44 -39
  12. data/lib/google/cloud/resource_manager/v3/projects/rest/operations.rb +2 -2
  13. data/lib/google/cloud/resource_manager/v3/rest.rb +1 -0
  14. data/lib/google/cloud/resource_manager/v3/tag_bindings/client.rb +115 -17
  15. data/lib/google/cloud/resource_manager/v3/tag_bindings/operations.rb +2 -2
  16. data/lib/google/cloud/resource_manager/v3/tag_bindings/rest/client.rb +96 -17
  17. data/lib/google/cloud/resource_manager/v3/tag_bindings/rest/operations.rb +2 -2
  18. data/lib/google/cloud/resource_manager/v3/tag_bindings/rest/service_stub.rb +57 -0
  19. data/lib/google/cloud/resource_manager/v3/tag_bindings/rest.rb +1 -1
  20. data/lib/google/cloud/resource_manager/v3/tag_bindings.rb +1 -1
  21. data/lib/google/cloud/resource_manager/v3/tag_holds/client.rb +640 -0
  22. data/lib/google/cloud/resource_manager/v3/tag_holds/credentials.rb +52 -0
  23. data/lib/google/cloud/resource_manager/v3/tag_holds/operations.rb +768 -0
  24. data/lib/google/cloud/resource_manager/v3/tag_holds/paths.rb +64 -0
  25. data/lib/google/cloud/resource_manager/v3/tag_holds/rest/client.rb +533 -0
  26. data/lib/google/cloud/resource_manager/v3/tag_holds/rest/operations.rb +793 -0
  27. data/lib/google/cloud/resource_manager/v3/tag_holds/rest/service_stub.rb +226 -0
  28. data/lib/google/cloud/resource_manager/v3/tag_holds/rest.rb +57 -0
  29. data/lib/google/cloud/resource_manager/v3/tag_holds.rb +60 -0
  30. data/lib/google/cloud/resource_manager/v3/tag_keys/client.rb +111 -22
  31. data/lib/google/cloud/resource_manager/v3/tag_keys/operations.rb +2 -2
  32. data/lib/google/cloud/resource_manager/v3/tag_keys/rest/client.rb +96 -22
  33. data/lib/google/cloud/resource_manager/v3/tag_keys/rest/operations.rb +2 -2
  34. data/lib/google/cloud/resource_manager/v3/tag_keys/rest/service_stub.rb +57 -0
  35. data/lib/google/cloud/resource_manager/v3/tag_values/client.rb +123 -29
  36. data/lib/google/cloud/resource_manager/v3/tag_values/operations.rb +2 -2
  37. data/lib/google/cloud/resource_manager/v3/tag_values/rest/client.rb +108 -29
  38. data/lib/google/cloud/resource_manager/v3/tag_values/rest/operations.rb +2 -2
  39. data/lib/google/cloud/resource_manager/v3/tag_values/rest/service_stub.rb +57 -0
  40. data/lib/google/cloud/resource_manager/v3/version.rb +1 -1
  41. data/lib/google/cloud/resource_manager/v3.rb +1 -0
  42. data/lib/google/cloud/resourcemanager/v3/folders_services_pb.rb +23 -17
  43. data/lib/google/cloud/resourcemanager/v3/projects_services_pb.rb +16 -13
  44. data/lib/google/cloud/resourcemanager/v3/tag_bindings_pb.rb +22 -0
  45. data/lib/google/cloud/resourcemanager/v3/tag_bindings_services_pb.rb +7 -5
  46. data/lib/google/cloud/resourcemanager/v3/tag_holds_pb.rb +63 -0
  47. data/lib/google/cloud/resourcemanager/v3/tag_holds_services_pb.rb +54 -0
  48. data/lib/google/cloud/resourcemanager/v3/tag_keys_pb.rb +11 -0
  49. data/lib/google/cloud/resourcemanager/v3/tag_keys_services_pb.rb +6 -2
  50. data/lib/google/cloud/resourcemanager/v3/tag_values_pb.rb +4 -0
  51. data/lib/google/cloud/resourcemanager/v3/tag_values_services_pb.rb +7 -4
  52. data/proto_docs/google/api/client.rb +57 -3
  53. data/proto_docs/google/cloud/resourcemanager/v3/folders.rb +25 -19
  54. data/proto_docs/google/cloud/resourcemanager/v3/organizations.rb +13 -11
  55. data/proto_docs/google/cloud/resourcemanager/v3/projects.rb +32 -30
  56. data/proto_docs/google/cloud/resourcemanager/v3/tag_bindings.rb +101 -15
  57. data/proto_docs/google/cloud/resourcemanager/v3/tag_holds.rb +161 -0
  58. data/proto_docs/google/cloud/resourcemanager/v3/tag_keys.rb +81 -23
  59. data/proto_docs/google/cloud/resourcemanager/v3/tag_values.rb +52 -29
  60. data/proto_docs/google/iam/v1/policy.rb +8 -4
  61. metadata +14 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 32d1fb7149f69726573b065cb5d2b5cb4cff94813c08d1594ce4758569a871fa
4
- data.tar.gz: 1b0e2ed2a459d2c4047a35f2d2cf7dc870e9a861d3a6e90590310ebd9dc1e0d8
3
+ metadata.gz: 8f6360b77e95bd3d627c8337da408b1c21e646b9aef34b42d170ba9682f35e9e
4
+ data.tar.gz: e613a0ee22c4d36f8095e319f540a8c19385f90e08a890f77bb0a7bf9e5f8a3d
5
5
  SHA512:
6
- metadata.gz: bcfa4939eef4a80768d48c8ebee090c5bb034655327f80f6fff3e29269fb75118318ce9138197f82a36e17a3c09adeeddf1021fe819adb913a460e550934bdc1
7
- data.tar.gz: 45583f5b44936d9ba558c9df9fb1dade858ad8f3ae0d8c980aa2dbf9492487fe9e4ad47284af11fbe8e4c71e7ae3f6dd903aee4d172b9491d2e13465d4202a37
6
+ metadata.gz: ac3e7768af0cac57f3c0e01f11ae9f49eb14c755387ef1ade9f243bb1f2d9f28d2dc18286433f5c7947335c16e14b7315b6d2a5ad2a72b045f16a176c07a2d92
7
+ data.tar.gz: 84609931e4efe8e9fb66e4977059987c85bdf4ffee0e32db1d7e0cec09ed548e3a62a58ef12aac0ec17e3eedb55d6661b4b8ddeb7a77a4a5693e6f5eed5b275e
data/README.md CHANGED
@@ -47,7 +47,7 @@ for general usage information.
47
47
 
48
48
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
49
  The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
50
+ or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
51
  that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
53
 
@@ -303,14 +303,19 @@ module Google
303
303
  # the default parameter values, pass an empty Hash as a request object (see above).
304
304
  #
305
305
  # @param parent [::String]
306
- # Required. The resource name of the organization or folder whose folders are
307
- # being listed.
308
- # Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
306
+ # Required. The name of the parent resource whose folders are being listed.
307
+ # Only children of this parent resource are listed; descendants are not
308
+ # listed.
309
+ #
310
+ # If the parent is a folder, use the value `folders/{folder_id}`. If the
311
+ # parent is an organization, use the value `organizations/{org_id}`.
312
+ #
309
313
  # Access to this method is controlled by checking the
310
314
  # `resourcemanager.folders.list` permission on the `parent`.
311
315
  # @param page_size [::Integer]
312
- # Optional. The maximum number of folders to return in the response.
313
- # If unspecified, server picks an appropriate default.
316
+ # Optional. The maximum number of folders to return in the response. The
317
+ # server can return fewer folders than requested. If unspecified, server
318
+ # picks an appropriate default.
314
319
  # @param page_token [::String]
315
320
  # Optional. A pagination token returned from a previous call to `ListFolders`
316
321
  # that indicates where this listing should continue from.
@@ -404,11 +409,12 @@ module Google
404
409
  # the default parameter values, pass an empty Hash as a request object (see above).
405
410
  #
406
411
  # @param page_size [::Integer]
407
- # Optional. The maximum number of folders to return in the response.
408
- # If unspecified, server picks an appropriate default.
412
+ # Optional. The maximum number of folders to return in the response. The
413
+ # server can return fewer folders than requested. If unspecified, server
414
+ # picks an appropriate default.
409
415
  # @param page_token [::String]
410
- # Optional. A pagination token returned from a previous call to `SearchFolders`
411
- # that indicates from where search should continue.
416
+ # Optional. A pagination token returned from a previous call to
417
+ # `SearchFolders` that indicates from where search should continue.
412
418
  # @param query [::String]
413
419
  # Optional. Search criteria used to select the folders to return.
414
420
  # If no search criteria is specified then all accessible folders will be
@@ -548,8 +554,8 @@ module Google
548
554
  # the default parameter values, pass an empty Hash as a request object (see above).
549
555
  #
550
556
  # @param folder [::Google::Cloud::ResourceManager::V3::Folder, ::Hash]
551
- # Required. The folder being created, only the display name and parent will be
552
- # consulted. All other fields will be ignored.
557
+ # Required. The folder being created, only the display name and parent will
558
+ # be consulted. All other fields will be ignored.
553
559
  #
554
560
  # @yield [response, operation] Access the result along with the RPC operation
555
561
  # @yieldparam response [::Gapic::Operation]
@@ -619,7 +625,9 @@ module Google
619
625
  # Updates a folder, changing its `display_name`.
620
626
  # Changes to the folder `display_name` will be rejected if they violate
621
627
  # either the `display_name` formatting rules or the naming constraints
622
- # described in the {::Google::Cloud::ResourceManager::V3::Folders::Client#create_folder CreateFolder} documentation.
628
+ # described in the
629
+ # {::Google::Cloud::ResourceManager::V3::Folders::Client#create_folder CreateFolder}
630
+ # documentation.
623
631
  #
624
632
  # The folder's `display_name` must start and end with a letter or digit,
625
633
  # may contain letters, digits, spaces, hyphens and underscores and can be
@@ -648,8 +656,8 @@ module Google
648
656
  # the default parameter values, pass an empty Hash as a request object (see above).
649
657
  #
650
658
  # @param folder [::Google::Cloud::ResourceManager::V3::Folder, ::Hash]
651
- # Required. The new definition of the Folder. It must include the `name` field, which
652
- # cannot be changed.
659
+ # Required. The new definition of the Folder. It must include the `name`
660
+ # field, which cannot be changed.
653
661
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
654
662
  # Required. Fields to be updated.
655
663
  # Only the `display_name` can be updated.
@@ -741,9 +749,9 @@ module Google
741
749
  # `FolderOperation` message as an aid to stateless clients.
742
750
  # Folder moves will be rejected if they violate either the naming, height,
743
751
  # or fanout constraints described in the
744
- # {::Google::Cloud::ResourceManager::V3::Folders::Client#create_folder CreateFolder} documentation.
745
- # The caller must have `resourcemanager.folders.move` permission on the
746
- # folder's current and proposed new parent.
752
+ # {::Google::Cloud::ResourceManager::V3::Folders::Client#create_folder CreateFolder}
753
+ # documentation. The caller must have `resourcemanager.folders.move`
754
+ # permission on the folder's current and proposed new parent.
747
755
  #
748
756
  # @overload move_folder(request, options = nil)
749
757
  # Pass arguments to `move_folder` via a request object, either of type
@@ -764,9 +772,9 @@ module Google
764
772
  # Required. The resource name of the Folder to move.
765
773
  # Must be of the form folders/\\{folder_id}
766
774
  # @param destination_parent [::String]
767
- # Required. The resource name of the folder or organization which should be the
768
- # folder's new parent.
769
- # Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
775
+ # Required. The resource name of the folder or organization which should be
776
+ # the folder's new parent. Must be of the form `folders/{folder_id}` or
777
+ # `organizations/{org_id}`.
770
778
  #
771
779
  # @yield [response, operation] Access the result along with the RPC operation
772
780
  # @yieldparam response [::Gapic::Operation]
@@ -842,11 +850,13 @@ module Google
842
850
 
843
851
  ##
844
852
  # Requests deletion of a folder. The folder is moved into the
845
- # {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED} state
846
- # immediately, and is deleted approximately 30 days later. This method may
847
- # only be called on an empty folder, where a folder is empty if it doesn't
848
- # contain any folders or projects in the {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state.
849
- # If called on a folder in {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED}
853
+ # {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED}
854
+ # state immediately, and is deleted approximately 30 days later. This method
855
+ # may only be called on an empty folder, where a folder is empty if it
856
+ # doesn't contain any folders or projects in the
857
+ # {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state. If
858
+ # called on a folder in
859
+ # {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED}
850
860
  # state the operation will result in a no-op success.
851
861
  # The caller must have `resourcemanager.folders.delete` permission on the
852
862
  # identified folder.
@@ -944,14 +954,16 @@ module Google
944
954
 
945
955
  ##
946
956
  # Cancels the deletion request for a folder. This method may be called on a
947
- # folder in any state. If the folder is in the {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE}
948
- # state the result will be a no-op success. In order to succeed, the folder's
949
- # parent must be in the {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state. In addition,
950
- # reintroducing the folder into the tree must not violate folder naming,
951
- # height, and fanout constraints described in the
952
- # {::Google::Cloud::ResourceManager::V3::Folders::Client#create_folder CreateFolder} documentation.
953
- # The caller must have `resourcemanager.folders.undelete` permission on the
954
- # identified folder.
957
+ # folder in any state. If the folder is in the
958
+ # {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state the
959
+ # result will be a no-op success. In order to succeed, the folder's parent
960
+ # must be in the
961
+ # {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state. In
962
+ # addition, reintroducing the folder into the tree must not violate folder
963
+ # naming, height, and fanout constraints described in the
964
+ # {::Google::Cloud::ResourceManager::V3::Folders::Client#create_folder CreateFolder}
965
+ # documentation. The caller must have `resourcemanager.folders.undelete`
966
+ # permission on the identified folder.
955
967
  #
956
968
  # @overload undelete_folder(request, options = nil)
957
969
  # Pass arguments to `undelete_folder` via a request object, either of type
@@ -1371,9 +1383,9 @@ module Google
1371
1383
  # * (`String`) The path to a service account key file in JSON format
1372
1384
  # * (`Hash`) A service account key as a Hash
1373
1385
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1374
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1386
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1375
1387
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1376
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1388
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1377
1389
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1378
1390
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1379
1391
  # * (`nil`) indicating no credentials
@@ -620,9 +620,9 @@ module Google
620
620
  # * (`String`) The path to a service account key file in JSON format
621
621
  # * (`Hash`) A service account key as a Hash
622
622
  # * (`Google::Auth::Credentials`) A googleauth credentials object
623
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
623
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
624
624
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
625
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
625
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
626
626
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
627
627
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
628
628
  # * (`nil`) indicating no credentials
@@ -271,14 +271,19 @@ module Google
271
271
  # the default parameter values, pass an empty Hash as a request object (see above).
272
272
  #
273
273
  # @param parent [::String]
274
- # Required. The resource name of the organization or folder whose folders are
275
- # being listed.
276
- # Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
274
+ # Required. The name of the parent resource whose folders are being listed.
275
+ # Only children of this parent resource are listed; descendants are not
276
+ # listed.
277
+ #
278
+ # If the parent is a folder, use the value `folders/{folder_id}`. If the
279
+ # parent is an organization, use the value `organizations/{org_id}`.
280
+ #
277
281
  # Access to this method is controlled by checking the
278
282
  # `resourcemanager.folders.list` permission on the `parent`.
279
283
  # @param page_size [::Integer]
280
- # Optional. The maximum number of folders to return in the response.
281
- # If unspecified, server picks an appropriate default.
284
+ # Optional. The maximum number of folders to return in the response. The
285
+ # server can return fewer folders than requested. If unspecified, server
286
+ # picks an appropriate default.
282
287
  # @param page_token [::String]
283
288
  # Optional. A pagination token returned from a previous call to `ListFolders`
284
289
  # that indicates where this listing should continue from.
@@ -353,11 +358,12 @@ module Google
353
358
  # the default parameter values, pass an empty Hash as a request object (see above).
354
359
  #
355
360
  # @param page_size [::Integer]
356
- # Optional. The maximum number of folders to return in the response.
357
- # If unspecified, server picks an appropriate default.
361
+ # Optional. The maximum number of folders to return in the response. The
362
+ # server can return fewer folders than requested. If unspecified, server
363
+ # picks an appropriate default.
358
364
  # @param page_token [::String]
359
- # Optional. A pagination token returned from a previous call to `SearchFolders`
360
- # that indicates from where search should continue.
365
+ # Optional. A pagination token returned from a previous call to
366
+ # `SearchFolders` that indicates from where search should continue.
361
367
  # @param query [::String]
362
368
  # Optional. Search criteria used to select the folders to return.
363
369
  # If no search criteria is specified then all accessible folders will be
@@ -478,8 +484,8 @@ module Google
478
484
  # the default parameter values, pass an empty Hash as a request object (see above).
479
485
  #
480
486
  # @param folder [::Google::Cloud::ResourceManager::V3::Folder, ::Hash]
481
- # Required. The folder being created, only the display name and parent will be
482
- # consulted. All other fields will be ignored.
487
+ # Required. The folder being created, only the display name and parent will
488
+ # be consulted. All other fields will be ignored.
483
489
  # @yield [result, operation] Access the result along with the TransportOperation object
484
490
  # @yieldparam result [::Gapic::Operation]
485
491
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -527,7 +533,9 @@ module Google
527
533
  # Updates a folder, changing its `display_name`.
528
534
  # Changes to the folder `display_name` will be rejected if they violate
529
535
  # either the `display_name` formatting rules or the naming constraints
530
- # described in the {::Google::Cloud::ResourceManager::V3::Folders::Rest::Client#create_folder CreateFolder} documentation.
536
+ # described in the
537
+ # {::Google::Cloud::ResourceManager::V3::Folders::Rest::Client#create_folder CreateFolder}
538
+ # documentation.
531
539
  #
532
540
  # The folder's `display_name` must start and end with a letter or digit,
533
541
  # may contain letters, digits, spaces, hyphens and underscores and can be
@@ -556,8 +564,8 @@ module Google
556
564
  # the default parameter values, pass an empty Hash as a request object (see above).
557
565
  #
558
566
  # @param folder [::Google::Cloud::ResourceManager::V3::Folder, ::Hash]
559
- # Required. The new definition of the Folder. It must include the `name` field, which
560
- # cannot be changed.
567
+ # Required. The new definition of the Folder. It must include the `name`
568
+ # field, which cannot be changed.
561
569
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
562
570
  # Required. Fields to be updated.
563
571
  # Only the `display_name` can be updated.
@@ -619,9 +627,9 @@ module Google
619
627
  # `FolderOperation` message as an aid to stateless clients.
620
628
  # Folder moves will be rejected if they violate either the naming, height,
621
629
  # or fanout constraints described in the
622
- # {::Google::Cloud::ResourceManager::V3::Folders::Rest::Client#create_folder CreateFolder} documentation.
623
- # The caller must have `resourcemanager.folders.move` permission on the
624
- # folder's current and proposed new parent.
630
+ # {::Google::Cloud::ResourceManager::V3::Folders::Rest::Client#create_folder CreateFolder}
631
+ # documentation. The caller must have `resourcemanager.folders.move`
632
+ # permission on the folder's current and proposed new parent.
625
633
  #
626
634
  # @overload move_folder(request, options = nil)
627
635
  # Pass arguments to `move_folder` via a request object, either of type
@@ -642,9 +650,9 @@ module Google
642
650
  # Required. The resource name of the Folder to move.
643
651
  # Must be of the form folders/\\{folder_id}
644
652
  # @param destination_parent [::String]
645
- # Required. The resource name of the folder or organization which should be the
646
- # folder's new parent.
647
- # Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
653
+ # Required. The resource name of the folder or organization which should be
654
+ # the folder's new parent. Must be of the form `folders/{folder_id}` or
655
+ # `organizations/{org_id}`.
648
656
  # @yield [result, operation] Access the result along with the TransportOperation object
649
657
  # @yieldparam result [::Gapic::Operation]
650
658
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -690,11 +698,13 @@ module Google
690
698
 
691
699
  ##
692
700
  # Requests deletion of a folder. The folder is moved into the
693
- # {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED} state
694
- # immediately, and is deleted approximately 30 days later. This method may
695
- # only be called on an empty folder, where a folder is empty if it doesn't
696
- # contain any folders or projects in the {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state.
697
- # If called on a folder in {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED}
701
+ # {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED}
702
+ # state immediately, and is deleted approximately 30 days later. This method
703
+ # may only be called on an empty folder, where a folder is empty if it
704
+ # doesn't contain any folders or projects in the
705
+ # {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state. If
706
+ # called on a folder in
707
+ # {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED}
698
708
  # state the operation will result in a no-op success.
699
709
  # The caller must have `resourcemanager.folders.delete` permission on the
700
710
  # identified folder.
@@ -762,14 +772,16 @@ module Google
762
772
 
763
773
  ##
764
774
  # Cancels the deletion request for a folder. This method may be called on a
765
- # folder in any state. If the folder is in the {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE}
766
- # state the result will be a no-op success. In order to succeed, the folder's
767
- # parent must be in the {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state. In addition,
768
- # reintroducing the folder into the tree must not violate folder naming,
769
- # height, and fanout constraints described in the
770
- # {::Google::Cloud::ResourceManager::V3::Folders::Rest::Client#create_folder CreateFolder} documentation.
771
- # The caller must have `resourcemanager.folders.undelete` permission on the
772
- # identified folder.
775
+ # folder in any state. If the folder is in the
776
+ # {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state the
777
+ # result will be a no-op success. In order to succeed, the folder's parent
778
+ # must be in the
779
+ # {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state. In
780
+ # addition, reintroducing the folder into the tree must not violate folder
781
+ # naming, height, and fanout constraints described in the
782
+ # {::Google::Cloud::ResourceManager::V3::Folders::Rest::Client#create_folder CreateFolder}
783
+ # documentation. The caller must have `resourcemanager.folders.undelete`
784
+ # permission on the identified folder.
773
785
  #
774
786
  # @overload undelete_folder(request, options = nil)
775
787
  # Pass arguments to `undelete_folder` via a request object, either of type
@@ -1090,9 +1102,9 @@ module Google
1090
1102
  # * (`String`) The path to a service account key file in JSON format
1091
1103
  # * (`Hash`) A service account key as a Hash
1092
1104
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1093
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1105
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1094
1106
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1095
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1107
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1096
1108
  # * (`nil`) indicating no credentials
1097
1109
  # @return [::Object]
1098
1110
  # @!attribute [rw] scope
@@ -411,9 +411,9 @@ module Google
411
411
  # * (`String`) The path to a service account key file in JSON format
412
412
  # * (`Hash`) A service account key as a Hash
413
413
  # * (`Google::Auth::Credentials`) A googleauth credentials object
414
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
414
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
415
415
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
416
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
416
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
417
417
  # * (`nil`) indicating no credentials
418
418
  # @return [::Object]
419
419
  # @!attribute [rw] scope
@@ -177,9 +177,9 @@ module Google
177
177
  # the default parameter values, pass an empty Hash as a request object (see above).
178
178
  #
179
179
  # @param name [::String]
180
- # Required. The resource name of the Organization to fetch. This is the organization's
181
- # relative path in the API, formatted as "organizations/[organizationId]".
182
- # For example, "organizations/1234".
180
+ # Required. The resource name of the Organization to fetch. This is the
181
+ # organization's relative path in the API, formatted as
182
+ # "organizations/[organizationId]". For example, "organizations/1234".
183
183
  #
184
184
  # @yield [response, operation] Access the result along with the RPC operation
185
185
  # @yieldparam response [::Google::Cloud::ResourceManager::V3::Organization]
@@ -271,13 +271,15 @@ module Google
271
271
  #
272
272
  # @param page_size [::Integer]
273
273
  # Optional. The maximum number of organizations to return in the response.
274
- # If unspecified, server picks an appropriate default.
274
+ # The server can return fewer organizations than requested. If unspecified,
275
+ # server picks an appropriate default.
275
276
  # @param page_token [::String]
276
- # Optional. A pagination token returned from a previous call to `SearchOrganizations`
277
- # that indicates from where listing should continue.
277
+ # Optional. A pagination token returned from a previous call to
278
+ # `SearchOrganizations` that indicates from where listing should continue.
278
279
  # @param query [::String]
279
- # Optional. An optional query string used to filter the Organizations to return in
280
- # the response. Query rules are case-insensitive.
280
+ # Optional. An optional query string used to filter the Organizations to
281
+ # return in the response. Query rules are case-insensitive.
282
+ #
281
283
  #
282
284
  # ```
283
285
  # | Field | Description |
@@ -685,9 +687,9 @@ module Google
685
687
  # * (`String`) The path to a service account key file in JSON format
686
688
  # * (`Hash`) A service account key as a Hash
687
689
  # * (`Google::Auth::Credentials`) A googleauth credentials object
688
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
690
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
689
691
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
690
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
692
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
691
693
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
692
694
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
693
695
  # * (`nil`) indicating no credentials
@@ -168,9 +168,9 @@ module Google
168
168
  # the default parameter values, pass an empty Hash as a request object (see above).
169
169
  #
170
170
  # @param name [::String]
171
- # Required. The resource name of the Organization to fetch. This is the organization's
172
- # relative path in the API, formatted as "organizations/[organizationId]".
173
- # For example, "organizations/1234".
171
+ # Required. The resource name of the Organization to fetch. This is the
172
+ # organization's relative path in the API, formatted as
173
+ # "organizations/[organizationId]". For example, "organizations/1234".
174
174
  # @yield [result, operation] Access the result along with the TransportOperation object
175
175
  # @yieldparam result [::Google::Cloud::ResourceManager::V3::Organization]
176
176
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -239,13 +239,15 @@ module Google
239
239
  #
240
240
  # @param page_size [::Integer]
241
241
  # Optional. The maximum number of organizations to return in the response.
242
- # If unspecified, server picks an appropriate default.
242
+ # The server can return fewer organizations than requested. If unspecified,
243
+ # server picks an appropriate default.
243
244
  # @param page_token [::String]
244
- # Optional. A pagination token returned from a previous call to `SearchOrganizations`
245
- # that indicates from where listing should continue.
245
+ # Optional. A pagination token returned from a previous call to
246
+ # `SearchOrganizations` that indicates from where listing should continue.
246
247
  # @param query [::String]
247
- # Optional. An optional query string used to filter the Organizations to return in
248
- # the response. Query rules are case-insensitive.
248
+ # Optional. An optional query string used to filter the Organizations to
249
+ # return in the response. Query rules are case-insensitive.
250
+ #
249
251
  #
250
252
  # ```
251
253
  # | Field | Description |
@@ -565,9 +567,9 @@ module Google
565
567
  # * (`String`) The path to a service account key file in JSON format
566
568
  # * (`Hash`) A service account key as a Hash
567
569
  # * (`Google::Auth::Credentials`) A googleauth credentials object
568
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
570
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
569
571
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
570
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
572
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
571
573
  # * (`nil`) indicating no credentials
572
574
  # @return [::Object]
573
575
  # @!attribute [rw] scope