google-cloud-resource_manager-v3 0.4.0 → 0.5.1

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 +53 -54
  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 +53 -54
  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 +114 -24
  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 +99 -24
  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 +67 -4
  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 +41 -45
  56. data/proto_docs/google/cloud/resourcemanager/v3/tag_bindings.rb +104 -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 +93 -27
  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
data/lib/google/cloud/resource_manager/v3/projects/client.rb CHANGED
@@ -299,21 +299,23 @@ module Google
299
299
  # the default parameter values, pass an empty Hash as a request object (see above).
300
300
  #
301
301
  # @param parent [::String]
302
- # Required. The name of the parent resource to list projects under.
302
+ # Required. The name of the parent resource whose projects are being listed.
303
+ # Only children of this parent resource are listed; descendants are not
304
+ # listed.
303
305
  #
304
- # For example, setting this field to 'folders/1234' would list all projects
305
- # directly under that folder.
306
+ # If the parent is a folder, use the value `folders/{folder_id}`. If the
307
+ # parent is an organization, use the value `organizations/{org_id}`.
306
308
  # @param page_token [::String]
307
- # Optional. A pagination token returned from a previous call to [ListProjects]
308
- # [google.cloud.resourcemanager.v3.Projects.ListProjects]
309
- # that indicates from where listing should continue.
309
+ # Optional. A pagination token returned from a previous call to
310
+ # [ListProjects] [google.cloud.resourcemanager.v3.Projects.ListProjects] that
311
+ # indicates from where listing should continue.
310
312
  # @param page_size [::Integer]
311
313
  # Optional. The maximum number of projects to return in the response.
312
314
  # The server can return fewer projects than requested.
313
315
  # If unspecified, server picks an appropriate default.
314
316
  # @param show_deleted [::Boolean]
315
- # Optional. Indicate that projects in the `DELETE_REQUESTED` state should also be
316
- # returned. Normally only `ACTIVE` projects are returned.
317
+ # Optional. Indicate that projects in the `DELETE_REQUESTED` state should
318
+ # also be returned. Normally only `ACTIVE` projects are returned.
317
319
  #
318
320
  # @yield [response, operation] Access the result along with the RPC operation
319
321
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ResourceManager::V3::Project>]
@@ -406,47 +408,41 @@ module Google
406
408
  # @param query [::String]
407
409
  # Optional. A query string for searching for projects that the caller has
408
410
  # `resourcemanager.projects.get` permission to. If multiple fields are
409
- # included in the query, the it will return results that match any of the
411
+ # included in the query, then it will return results that match any of the
410
412
  # fields. Some eligible fields are:
411
413
  #
412
- # ```
413
- # | Field | Description |
414
- # |-------------------------|----------------------------------------------|
415
- # | displayName, name | Filters by displayName. |
416
- # | parent | Project's parent. (for example: folders/123,
417
- # organizations/*) Prefer parent field over parent.type and parent.id. |
418
- # | parent.type | Parent's type: `folder` or `organization`. |
419
- # | parent.id | Parent's id number (for example: 123) |
420
- # | id, projectId | Filters by projectId. |
421
- # | state, lifecycleState | Filters by state. |
422
- # | labels | Filters by label name or value. |
423
- # | labels.<key> (where *key* is the name of a label) | Filters by label
424
- # name. |
425
- # ```
414
+ # - **`displayName`, `name`**: Filters by displayName.
415
+ # - **`parent`**: Project's parent (for example: `folders/123`,
416
+ # `organizations/*`). Prefer `parent` field over `parent.type` and
417
+ # `parent.id`.
418
+ # - **`parent.type`**: Parent's type: `folder` or `organization`.
419
+ # - **`parent.id`**: Parent's id number (for example: `123`).
420
+ # - **`id`, `projectId`**: Filters by projectId.
421
+ # - **`state`, `lifecycleState`**: Filters by state.
422
+ # - **`labels`**: Filters by label name or value.
423
+ # - **`labels.<key>` (where `<key>` is the name of a label)**: Filters by label
424
+ # name.
426
425
  #
427
426
  # Search expressions are case insensitive.
428
427
  #
429
428
  # Some examples queries:
430
429
  #
431
- # ```
432
- # | Query | Description |
433
- # |------------------|-----------------------------------------------------|
434
- # | name:how* | The project's name starts with "how". |
435
- # | name:Howl | The project's name is `Howl` or `howl`. |
436
- # | name:HOWL | Equivalent to above. |
437
- # | NAME:howl | Equivalent to above. |
438
- # | labels.color:* | The project has the label `color`. |
439
- # | labels.color:red | The project's label `color` has the value `red`. |
440
- # | labels.color:red&nbsp;labels.size:big | The project's label `color` has
441
- # the value `red` and its label `size` has the value `big`. |
442
- # ```
430
+ #
431
+ # - **`name:how*`**: The project's name starts with "how".
432
+ # - **`name:Howl`**: The project's name is `Howl` or `howl`.
433
+ # - **`name:HOWL`**: Equivalent to above.
434
+ # - **`NAME:howl`**: Equivalent to above.
435
+ # - **`labels.color:*`**: The project has the label `color`.
436
+ # - **`labels.color:red`**: The project's label `color` has the value `red`.
437
+ # - **`labels.color:red labels.size:big`**: The project's label `color` has
438
+ # the value `red` or its label `size` has the value `big`.
443
439
  #
444
440
  # If no query is specified, the call will return projects for which the user
445
441
  # has the `resourcemanager.projects.get` permission.
446
442
  # @param page_token [::String]
447
- # Optional. A pagination token returned from a previous call to [ListProjects]
448
- # [google.cloud.resourcemanager.v3.Projects.ListProjects]
449
- # that indicates from where listing should continue.
443
+ # Optional. A pagination token returned from a previous call to
444
+ # [ListProjects] [google.cloud.resourcemanager.v3.Projects.ListProjects] that
445
+ # indicates from where listing should continue.
450
446
  # @param page_size [::Integer]
451
447
  # Optional. The maximum number of projects to return in the response.
452
448
  # The server can return fewer projects than requested.
@@ -543,7 +539,7 @@ module Google
543
539
  #
544
540
  # If the `parent` field is set, the `resourcemanager.projects.create`
545
541
  # permission is checked on the parent resource. If no parent is set and
546
- # the authorization credentials belong to an Organziation, the parent
542
+ # the authorization credentials belong to an Organization, the parent
547
543
  # will be set to that Organization.
548
544
  #
549
545
  # @yield [response, operation] Access the result along with the RPC operation
@@ -719,9 +715,12 @@ module Google
719
715
  # Upon success, the `Operation.response` field will be populated with the
720
716
  # moved project.
721
717
  #
722
- # The caller must have `resourcemanager.projects.update` permission on the
723
- # project and have `resourcemanager.projects.move` permission on the
724
- # project's current and proposed new parent.
718
+ # The caller must have `resourcemanager.projects.move` permission on the
719
+ # project, on the project's current and proposed new parent.
720
+ #
721
+ # If project has no current parent, or it currently does not have an
722
+ # associated organization resource, you will also need the
723
+ # `resourcemanager.projects.setIamPolicy` permission in the project.
725
724
  #
726
725
  # @overload move_project(request, options = nil)
727
726
  # Pass arguments to `move_project` via a request object, either of type
@@ -824,7 +823,8 @@ module Google
824
823
  #
825
824
  # This method changes the Project's lifecycle state from
826
825
  # {::Google::Cloud::ResourceManager::V3::Project::State::ACTIVE ACTIVE}
827
- # to {::Google::Cloud::ResourceManager::V3::Project::State::DELETE_REQUESTED DELETE_REQUESTED}.
826
+ # to
827
+ # {::Google::Cloud::ResourceManager::V3::Project::State::DELETE_REQUESTED DELETE_REQUESTED}.
828
828
  # The deletion starts at an unspecified time,
829
829
  # at which point the Project is no longer accessible.
830
830
  #
@@ -1043,7 +1043,8 @@ module Google
1043
1043
  end
1044
1044
 
1045
1045
  ##
1046
- # Returns the IAM access control policy for the specified project.
1046
+ # Returns the IAM access control policy for the specified project, in the
1047
+ # format `projects/{ProjectIdOrNumber}` e.g. projects/123.
1047
1048
  # Permission is denied if the policy or the resource do not exist.
1048
1049
  #
1049
1050
  # @overload get_iam_policy(request, options = nil)
@@ -1133,7 +1134,8 @@ module Google
1133
1134
  end
1134
1135
 
1135
1136
  ##
1136
- # Sets the IAM access control policy for the specified project.
1137
+ # Sets the IAM access control policy for the specified project, in the
1138
+ # format `projects/{ProjectIdOrNumber}` e.g. projects/123.
1137
1139
  #
1138
1140
  # CAUTION: This method will replace the existing policy, and cannot be used
1139
1141
  # to append additional IAM settings.
@@ -1165,18 +1167,14 @@ module Google
1165
1167
  # `setIamPolicy()`;
1166
1168
  # they must be sent only using the Cloud Platform Console.
1167
1169
  #
1168
- # + Membership changes that leave the project without any owners that have
1169
- # accepted the Terms of Service (ToS) will be rejected.
1170
- #
1171
1170
  # + If the project is not part of an organization, there must be at least
1172
1171
  # one owner who has accepted the Terms of Service (ToS) agreement in the
1173
1172
  # policy. Calling `setIamPolicy()` to remove the last ToS-accepted owner
1174
1173
  # from the policy will fail. This restriction also applies to legacy
1175
1174
  # projects that no longer have owners who have accepted the ToS. Edits to
1176
1175
  # IAM policies will be rejected until the lack of a ToS-accepting owner is
1177
- # rectified.
1178
- #
1179
- # + Calling this method requires enabling the App Engine Admin API.
1176
+ # rectified. If the project is part of an organization, you can remove all
1177
+ # owners, potentially making the organization inaccessible.
1180
1178
  #
1181
1179
  # @overload set_iam_policy(request, options = nil)
1182
1180
  # Pass arguments to `set_iam_policy` via a request object, either of type
@@ -1273,7 +1271,8 @@ module Google
1273
1271
  end
1274
1272
 
1275
1273
  ##
1276
- # Returns permissions that a caller has on the specified project.
1274
+ # Returns permissions that a caller has on the specified project, in the
1275
+ # format `projects/{ProjectIdOrNumber}` e.g. projects/123..
1277
1276
  #
1278
1277
  # @overload test_iam_permissions(request, options = nil)
1279
1278
  # Pass arguments to `test_iam_permissions` via a request object, either of type
@@ -1401,9 +1400,9 @@ module Google
1401
1400
  # * (`String`) The path to a service account key file in JSON format
1402
1401
  # * (`Hash`) A service account key as a Hash
1403
1402
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1404
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1403
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1405
1404
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1406
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1405
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1407
1406
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1408
1407
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1409
1408
  # * (`nil`) indicating no credentials
data/lib/google/cloud/resource_manager/v3/projects/operations.rb CHANGED
@@ -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
data/lib/google/cloud/resource_manager/v3/projects/rest/client.rb CHANGED
@@ -267,21 +267,23 @@ module Google
267
267
  # the default parameter values, pass an empty Hash as a request object (see above).
268
268
  #
269
269
  # @param parent [::String]
270
- # Required. The name of the parent resource to list projects under.
270
+ # Required. The name of the parent resource whose projects are being listed.
271
+ # Only children of this parent resource are listed; descendants are not
272
+ # listed.
271
273
  #
272
- # For example, setting this field to 'folders/1234' would list all projects
273
- # directly under that folder.
274
+ # If the parent is a folder, use the value `folders/{folder_id}`. If the
275
+ # parent is an organization, use the value `organizations/{org_id}`.
274
276
  # @param page_token [::String]
275
- # Optional. A pagination token returned from a previous call to [ListProjects]
276
- # [google.cloud.resourcemanager.v3.Projects.ListProjects]
277
- # that indicates from where listing should continue.
277
+ # Optional. A pagination token returned from a previous call to
278
+ # [ListProjects] [google.cloud.resourcemanager.v3.Projects.ListProjects] that
279
+ # indicates from where listing should continue.
278
280
  # @param page_size [::Integer]
279
281
  # Optional. The maximum number of projects to return in the response.
280
282
  # The server can return fewer projects than requested.
281
283
  # If unspecified, server picks an appropriate default.
282
284
  # @param show_deleted [::Boolean]
283
- # Optional. Indicate that projects in the `DELETE_REQUESTED` state should also be
284
- # returned. Normally only `ACTIVE` projects are returned.
285
+ # Optional. Indicate that projects in the `DELETE_REQUESTED` state should
286
+ # also be returned. Normally only `ACTIVE` projects are returned.
285
287
  # @yield [result, operation] Access the result along with the TransportOperation object
286
288
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ResourceManager::V3::Project>]
287
289
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -355,47 +357,41 @@ module Google
355
357
  # @param query [::String]
356
358
  # Optional. A query string for searching for projects that the caller has
357
359
  # `resourcemanager.projects.get` permission to. If multiple fields are
358
- # included in the query, the it will return results that match any of the
360
+ # included in the query, then it will return results that match any of the
359
361
  # fields. Some eligible fields are:
360
362
  #
361
- # ```
362
- # | Field | Description |
363
- # |-------------------------|----------------------------------------------|
364
- # | displayName, name | Filters by displayName. |
365
- # | parent | Project's parent. (for example: folders/123,
366
- # organizations/*) Prefer parent field over parent.type and parent.id. |
367
- # | parent.type | Parent's type: `folder` or `organization`. |
368
- # | parent.id | Parent's id number (for example: 123) |
369
- # | id, projectId | Filters by projectId. |
370
- # | state, lifecycleState | Filters by state. |
371
- # | labels | Filters by label name or value. |
372
- # | labels.<key> (where *key* is the name of a label) | Filters by label
373
- # name. |
374
- # ```
363
+ # - **`displayName`, `name`**: Filters by displayName.
364
+ # - **`parent`**: Project's parent (for example: `folders/123`,
365
+ # `organizations/*`). Prefer `parent` field over `parent.type` and
366
+ # `parent.id`.
367
+ # - **`parent.type`**: Parent's type: `folder` or `organization`.
368
+ # - **`parent.id`**: Parent's id number (for example: `123`).
369
+ # - **`id`, `projectId`**: Filters by projectId.
370
+ # - **`state`, `lifecycleState`**: Filters by state.
371
+ # - **`labels`**: Filters by label name or value.
372
+ # - **`labels.<key>` (where `<key>` is the name of a label)**: Filters by label
373
+ # name.
375
374
  #
376
375
  # Search expressions are case insensitive.
377
376
  #
378
377
  # Some examples queries:
379
378
  #
380
- # ```
381
- # | Query | Description |
382
- # |------------------|-----------------------------------------------------|
383
- # | name:how* | The project's name starts with "how". |
384
- # | name:Howl | The project's name is `Howl` or `howl`. |
385
- # | name:HOWL | Equivalent to above. |
386
- # | NAME:howl | Equivalent to above. |
387
- # | labels.color:* | The project has the label `color`. |
388
- # | labels.color:red | The project's label `color` has the value `red`. |
389
- # | labels.color:red&nbsp;labels.size:big | The project's label `color` has
390
- # the value `red` and its label `size` has the value `big`. |
391
- # ```
379
+ #
380
+ # - **`name:how*`**: The project's name starts with "how".
381
+ # - **`name:Howl`**: The project's name is `Howl` or `howl`.
382
+ # - **`name:HOWL`**: Equivalent to above.
383
+ # - **`NAME:howl`**: Equivalent to above.
384
+ # - **`labels.color:*`**: The project has the label `color`.
385
+ # - **`labels.color:red`**: The project's label `color` has the value `red`.
386
+ # - **`labels.color:red labels.size:big`**: The project's label `color` has
387
+ # the value `red` or its label `size` has the value `big`.
392
388
  #
393
389
  # If no query is specified, the call will return projects for which the user
394
390
  # has the `resourcemanager.projects.get` permission.
395
391
  # @param page_token [::String]
396
- # Optional. A pagination token returned from a previous call to [ListProjects]
397
- # [google.cloud.resourcemanager.v3.Projects.ListProjects]
398
- # that indicates from where listing should continue.
392
+ # Optional. A pagination token returned from a previous call to
393
+ # [ListProjects] [google.cloud.resourcemanager.v3.Projects.ListProjects] that
394
+ # indicates from where listing should continue.
399
395
  # @param page_size [::Integer]
400
396
  # Optional. The maximum number of projects to return in the response.
401
397
  # The server can return fewer projects than requested.
@@ -473,7 +469,7 @@ module Google
473
469
  #
474
470
  # If the `parent` field is set, the `resourcemanager.projects.create`
475
471
  # permission is checked on the parent resource. If no parent is set and
476
- # the authorization credentials belong to an Organziation, the parent
472
+ # the authorization credentials belong to an Organization, the parent
477
473
  # will be set to that Organization.
478
474
  # @yield [result, operation] Access the result along with the TransportOperation object
479
475
  # @yieldparam result [::Gapic::Operation]
@@ -597,9 +593,12 @@ module Google
597
593
  # Upon success, the `Operation.response` field will be populated with the
598
594
  # moved project.
599
595
  #
600
- # The caller must have `resourcemanager.projects.update` permission on the
601
- # project and have `resourcemanager.projects.move` permission on the
602
- # project's current and proposed new parent.
596
+ # The caller must have `resourcemanager.projects.move` permission on the
597
+ # project, on the project's current and proposed new parent.
598
+ #
599
+ # If project has no current parent, or it currently does not have an
600
+ # associated organization resource, you will also need the
601
+ # `resourcemanager.projects.setIamPolicy` permission in the project.
603
602
  #
604
603
  # @overload move_project(request, options = nil)
605
604
  # Pass arguments to `move_project` via a request object, either of type
@@ -672,7 +671,8 @@ module Google
672
671
  #
673
672
  # This method changes the Project's lifecycle state from
674
673
  # {::Google::Cloud::ResourceManager::V3::Project::State::ACTIVE ACTIVE}
675
- # to {::Google::Cloud::ResourceManager::V3::Project::State::DELETE_REQUESTED DELETE_REQUESTED}.
674
+ # to
675
+ # {::Google::Cloud::ResourceManager::V3::Project::State::DELETE_REQUESTED DELETE_REQUESTED}.
676
676
  # The deletion starts at an unspecified time,
677
677
  # at which point the Project is no longer accessible.
678
678
  #
@@ -831,7 +831,8 @@ module Google
831
831
  end
832
832
 
833
833
  ##
834
- # Returns the IAM access control policy for the specified project.
834
+ # Returns the IAM access control policy for the specified project, in the
835
+ # format `projects/{ProjectIdOrNumber}` e.g. projects/123.
835
836
  # Permission is denied if the policy or the resource do not exist.
836
837
  #
837
838
  # @overload get_iam_policy(request, options = nil)
@@ -898,7 +899,8 @@ module Google
898
899
  end
899
900
 
900
901
  ##
901
- # Sets the IAM access control policy for the specified project.
902
+ # Sets the IAM access control policy for the specified project, in the
903
+ # format `projects/{ProjectIdOrNumber}` e.g. projects/123.
902
904
  #
903
905
  # CAUTION: This method will replace the existing policy, and cannot be used
904
906
  # to append additional IAM settings.
@@ -930,18 +932,14 @@ module Google
930
932
  # `setIamPolicy()`;
931
933
  # they must be sent only using the Cloud Platform Console.
932
934
  #
933
- # + Membership changes that leave the project without any owners that have
934
- # accepted the Terms of Service (ToS) will be rejected.
935
- #
936
935
  # + If the project is not part of an organization, there must be at least
937
936
  # one owner who has accepted the Terms of Service (ToS) agreement in the
938
937
  # policy. Calling `setIamPolicy()` to remove the last ToS-accepted owner
939
938
  # from the policy will fail. This restriction also applies to legacy
940
939
  # projects that no longer have owners who have accepted the ToS. Edits to
941
940
  # IAM policies will be rejected until the lack of a ToS-accepting owner is
942
- # rectified.
943
- #
944
- # + Calling this method requires enabling the App Engine Admin API.
941
+ # rectified. If the project is part of an organization, you can remove all
942
+ # owners, potentially making the organization inaccessible.
945
943
  #
946
944
  # @overload set_iam_policy(request, options = nil)
947
945
  # Pass arguments to `set_iam_policy` via a request object, either of type
@@ -1015,7 +1013,8 @@ module Google
1015
1013
  end
1016
1014
 
1017
1015
  ##
1018
- # Returns permissions that a caller has on the specified project.
1016
+ # Returns permissions that a caller has on the specified project, in the
1017
+ # format `projects/{ProjectIdOrNumber}` e.g. projects/123..
1019
1018
  #
1020
1019
  # @overload test_iam_permissions(request, options = nil)
1021
1020
  # Pass arguments to `test_iam_permissions` via a request object, either of type
@@ -1120,9 +1119,9 @@ module Google
1120
1119
  # * (`String`) The path to a service account key file in JSON format
1121
1120
  # * (`Hash`) A service account key as a Hash
1122
1121
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1123
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1122
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1124
1123
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1125
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1124
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1126
1125
  # * (`nil`) indicating no credentials
1127
1126
  # @return [::Object]
1128
1127
  # @!attribute [rw] scope
data/lib/google/cloud/resource_manager/v3/projects/rest/operations.rb CHANGED
@@ -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
data/lib/google/cloud/resource_manager/v3/rest.rb CHANGED
@@ -20,6 +20,7 @@ require "google/cloud/resource_manager/v3/folders/rest"
20
20
  require "google/cloud/resource_manager/v3/organizations/rest"
21
21
  require "google/cloud/resource_manager/v3/projects/rest"
22
22
  require "google/cloud/resource_manager/v3/tag_bindings/rest"
23
+ require "google/cloud/resource_manager/v3/tag_holds/rest"
23
24
  require "google/cloud/resource_manager/v3/tag_keys/rest"
24
25
  require "google/cloud/resource_manager/v3/tag_values/rest"
25
26
  require "google/cloud/resource_manager/v3/version"