RubyGems - google-apis-iam_v1 - Versions diffs - 0.56.0 → 0.57.0 - Mend

google-apis-iam_v1 0.56.0 → 0.57.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.

Files changed (6) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +4 -0
data/lib/google/apis/iam_v1/classes.rb +11 -11
data/lib/google/apis/iam_v1/gem_version.rb +2 -2
data/lib/google/apis/iam_v1/service.rb +241 -238
metadata +3 -3

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ce2857fcc6183ac0cc0f3df5d3689482ba3a5c138a80850054bb0092cfabb27
-  data.tar.gz: 7cca170f022b112d87c0304e2a5098bcda6a87e266325e4883ce2531abef9ad8
+  metadata.gz: bf3ee28d164f715af7b24104a7894e9a8d458d07daac23b4c45463d1b2ee0908
+  data.tar.gz: c839e4b6035c0c5636dc17c721cab5c09db1064f16b1f2715d7e2235113ed751
 SHA512:
-  metadata.gz: d30d34a88eff6f68f596ec5b332aab0cac58166fa335d39b8cc1f942418c148f5e8d48193e45dba8c41d64b844d51e5b2031eb2f415ab2f0c7c491cf7bfdfc1b
-  data.tar.gz: 49e0a1fd6e9c52c03f08202f817bca0a2137a519b961b32cb3d7b034fd5da9fbb74768bc522f17a041cfcd4835fa20ac1b4a839e70721d0b9f8b951cb79ab43c
+  metadata.gz: 409d207b02d976a597350369b97591aefdf43ab23b36e79bf562f56921ace01d09ccc30f7fc10e5672c1197138f22cc8a8a8b28cf25f49246d17e2a10f4b0be8
+  data.tar.gz: 6b0ab91c05700f5a6a991b637ae5c33f0df731b81bdccb1de920196bcc1ca4eef29fa9b55b4b7d90ca248b1d24fb6558f08d9a21e5e2a5197f2ca629958be47a

data/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,9 @@
 # Release history for google-apis-iam_v1
+### v0.57.0 (2024-04-28)
+* Regenerated from discovery document revision 20240418
 ### v0.56.0 (2024-04-21)
 * Regenerated from discovery document revision 20240415

data/lib/google/apis/iam_v1/classes.rb CHANGED Viewed

@@ -168,8 +168,8 @@ module Google
       class AuditableService
         include Google::Apis::Core::Hashable
-        # Public name of the service. For example, the service name for Cloud IAM is '
-        # iam.googleapis.com'.
+        # Public name of the service. For example, the service name for IAM is 'iam.
+        # googleapis.com'.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -714,10 +714,10 @@ module Google
         # Optional. The filter used to request specific records from IdP. In case of
         # attributes type as AZURE_AD_GROUPS_MAIL, it represents the filter used to
-        # request specific groups for users from IdP. By default all the groups
-        # associated with the user are fetched. The groups that are used should be mail
-        # enabled and security enabled. See https://learn.microsoft.com/en-us/graph/
-        # search-query-parameter for more details.
+        # request specific groups for users from IdP. By default, all of the groups
+        # associated with the user are fetched. The groups should be mail enabled and
+        # security enabled. See https://learn.microsoft.com/en-us/graph/search-query-
+        # parameter for more details.
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -943,7 +943,7 @@ module Google
         end
       end
-      # The request to lint a Cloud IAM policy object.
+      # The request to lint an IAM policy object.
       class LintPolicyRequest
         include Google::Apis::Core::Hashable
@@ -967,10 +967,10 @@ module Google
         attr_accessor :condition
         # The full resource name of the policy this lint request is about. The name
-        # follows the Google Cloud format for full resource names. For example, a Cloud
-        # project with ID `my-project` will be named `//cloudresourcemanager.googleapis.
-        # com/projects/my-project`. The resource name is not used to read a policy from
-        # IAM. Only the data in the request object is linted.
+        # follows the Google Cloud format for full resource names. For example, a Google
+        # Cloud project with ID `my-project` will be named `//cloudresourcemanager.
+        # googleapis.com/projects/my-project`. The resource name is not used to read a
+        # policy from IAM. Only the data in the request object is linted.
         # Corresponds to the JSON property `fullResourceName`
         # @return [String]
         attr_accessor :full_resource_name

data/lib/google/apis/iam_v1/gem_version.rb CHANGED Viewed

@@ -16,13 +16,13 @@ module Google
   module Apis
     module IamV1
       # Version of the google-apis-iam_v1 gem
-      GEM_VERSION = "0.56.0"
+      GEM_VERSION = "0.57.0"
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.14.0"
       # Revision of the discovery document this client was generated from
-      REVISION = "20240415"
+      REVISION = "20240418"
     end
   end
 end

data/lib/google/apis/iam_v1/service.rb CHANGED Viewed

@@ -1064,20 +1064,20 @@ module Google
         # Creates a new custom Role.
         # @param [String] parent
         #   The `parent` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
-        #   roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
-        #   organizations.roles). Each resource type's `parent` value format is described
-        #   below: * [`projects.roles.create()`](https://cloud.google.com/iam/reference/
-        #   rest/v1/projects.roles/create): `projects/`PROJECT_ID``. This method creates
-        #   project-level [custom roles](https://cloud.google.com/iam/docs/understanding-
-        #   custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/`
-        #   PROJECT_ID`/roles` * [`organizations.roles.create()`](https://cloud.google.com/
-        #   iam/reference/rest/v1/organizations.roles/create): `organizations/`
-        #   ORGANIZATION_ID``. This method creates organization-level [custom roles](https:
-        #   //cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `
-        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles` Note:
-        #   Wildcard (*) values are invalid; you must specify a complete project ID or
-        #   organization ID.
+        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
+        #   reference/rest/v1/organizations.roles). Each resource type's `parent` value
+        #   format is described below: * [`projects.roles.create()`](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/projects.roles/create): `projects/`PROJECT_ID``.
+        #   This method creates project-level [custom roles](https://cloud.google.com/iam/
+        #   docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.
+        #   com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.create()`](https://
+        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/create): `
+        #   organizations/`ORGANIZATION_ID``. This method creates organization-level [
+        #   custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
+        #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
+        #   ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
+        #   specify a complete project ID or organization ID.
         # @param [Google::Apis::IamV1::CreateRoleRequest] create_role_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1118,22 +1118,22 @@ module Google
         # binding is permanently removed.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
-        #   roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
-        #   organizations.roles). Each resource type's `name` value format is described
-        #   below: * [`projects.roles.delete()`](https://cloud.google.com/iam/reference/
-        #   rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
-        #   This method deletes only [custom roles](https://cloud.google.com/iam/docs/
-        #   understanding-custom-roles) that have been created at the project level.
-        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
-        #   roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.delete()`](https://cloud.
-        #   google.com/iam/reference/rest/v1/organizations.roles/delete): `organizations/`
-        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes only [custom
-        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
-        #   been created at the organization level. Example request URL: `https://iam.
-        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
-        #   Wildcard (*) values are invalid; you must specify a complete project ID or
-        #   organization ID.
+        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
+        #   reference/rest/v1/organizations.roles). Each resource type's `name` value
+        #   format is described below: * [`projects.roles.delete()`](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID``. This method deletes only [custom roles](https://cloud.
+        #   google.com/iam/docs/understanding-custom-roles) that have been created at the
+        #   project level. Example request URL: `https://iam.googleapis.com/v1/projects/`
+        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.delete()`](https://
+        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/delete): `
+        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes
+        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
+        #   roles) that have been created at the organization level. Example request URL: `
+        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
+        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
+        #   complete project ID or organization ID.
         # @param [String] etag
         #   Used to perform a consistent read-modify-write.
         # @param [String] fields
@@ -1167,26 +1167,27 @@ module Google
         # Gets the definition of a Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`roles`](https://cloud.google.com/iam/reference/rest/v1/roles), [`
-        #   projects`](https://cloud.google.com/iam/reference/rest/v1/projects.roles), or [
-        #   `organizations`](https://cloud.google.com/iam/reference/rest/v1/organizations.
-        #   roles). Each resource type's `name` value format is described below: * [`roles.
-        #   get()`](https://cloud.google.com/iam/reference/rest/v1/roles/get): `roles/`
-        #   ROLE_NAME``. This method returns results from all [predefined roles](https://
-        #   cloud.google.com/iam/docs/understanding-roles#predefined_roles) in Cloud IAM.
-        #   Example request URL: `https://iam.googleapis.com/v1/roles/`ROLE_NAME`` * [`
-        #   projects.roles.get()`](https://cloud.google.com/iam/reference/rest/v1/projects.
-        #   roles/get): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method
-        #   returns only [custom roles](https://cloud.google.com/iam/docs/understanding-
-        #   custom-roles) that have been created at the project level. Example request URL:
-        #   `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` *
-        #   [`organizations.roles.get()`](https://cloud.google.com/iam/reference/rest/v1/
-        #   organizations.roles/get): `organizations/`ORGANIZATION_ID`/roles/`
+        #   namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
+        #   projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
+        #   or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `name` value format is described
+        #   below: * [`roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   roles/get): `roles/`ROLE_NAME``. This method returns results from all [
+        #   predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
+        #   predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/
+        #   roles/`ROLE_NAME`` * [`projects.roles.get()`](https://cloud.google.com/iam/
+        #   docs/reference/rest/v1/projects.roles/get): `projects/`PROJECT_ID`/roles/`
         #   CUSTOM_ROLE_ID``. This method returns only [custom roles](https://cloud.google.
-        #   com/iam/docs/understanding-custom-roles) that have been created at the
-        #   organization level. Example request URL: `https://iam.googleapis.com/v1/
-        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note: Wildcard (*)
-        #   values are invalid; you must specify a complete project ID or organization ID.
+        #   com/iam/docs/understanding-custom-roles) that have been created at the project
+        #   level. Example request URL: `https://iam.googleapis.com/v1/projects/`
+        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.get()`](https://
+        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `
+        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method returns
+        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
+        #   roles) that have been created at the organization level. Example request URL: `
+        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
+        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
+        #   complete project ID or organization ID.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1218,25 +1219,25 @@ module Google
         # defined for an organization or project.
         # @param [String] parent
         #   The `parent` parameter's value depends on the target resource for the request,
-        #   namely [`roles`](https://cloud.google.com/iam/reference/rest/v1/roles), [`
-        #   projects`](https://cloud.google.com/iam/reference/rest/v1/projects.roles), or [
-        #   `organizations`](https://cloud.google.com/iam/reference/rest/v1/organizations.
-        #   roles). Each resource type's `parent` value format is described below: * [`
-        #   roles.list()`](https://cloud.google.com/iam/reference/rest/v1/roles/list): An
-        #   empty string. This method doesn't require a resource; it simply returns all [
-        #   predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
-        #   predefined_roles) in Cloud IAM. Example request URL: `https://iam.googleapis.
-        #   com/v1/roles` * [`projects.roles.list()`](https://cloud.google.com/iam/
-        #   reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``. This method
-        #   lists all project-level [custom roles](https://cloud.google.com/iam/docs/
-        #   understanding-custom-roles). Example request URL: `https://iam.googleapis.com/
-        #   v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`](https://cloud.
-        #   google.com/iam/reference/rest/v1/organizations.roles/list): `organizations/`
-        #   ORGANIZATION_ID``. This method lists all organization-level [custom roles](
-        #   https://cloud.google.com/iam/docs/understanding-custom-roles). Example request
-        #   URL: `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles`
-        #   Note: Wildcard (*) values are invalid; you must specify a complete project ID
-        #   or organization ID.
+        #   namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
+        #   projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
+        #   or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `parent` value format is described
+        #   below: * [`roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   roles/list): An empty string. This method doesn't require a resource; it
+        #   simply returns all [predefined roles](https://cloud.google.com/iam/docs/
+        #   understanding-roles#predefined_roles) in IAM. Example request URL: `https://
+        #   iam.googleapis.com/v1/roles` * [`projects.roles.list()`](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``.
+        #   This method lists all project-level [custom roles](https://cloud.google.com/
+        #   iam/docs/understanding-custom-roles). Example request URL: `https://iam.
+        #   googleapis.com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`]
+        #   (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list):
+        #   `organizations/`ORGANIZATION_ID``. This method lists all organization-level [
+        #   custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
+        #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
+        #   ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
+        #   specify a complete project ID or organization ID.
         # @param [Fixnum] page_size
         #   Optional limit on the number of roles to include in the response. The default
         #   is 300, and the maximum is 1,000.
@@ -1283,22 +1284,22 @@ module Google
         # Updates the definition of a custom Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
-        #   roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
-        #   organizations.roles). Each resource type's `name` value format is described
-        #   below: * [`projects.roles.patch()`](https://cloud.google.com/iam/reference/
-        #   rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
-        #   This method updates only [custom roles](https://cloud.google.com/iam/docs/
-        #   understanding-custom-roles) that have been created at the project level.
-        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
-        #   roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.patch()`](https://cloud.google.
-        #   com/iam/reference/rest/v1/organizations.roles/patch): `organizations/`
-        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method updates only [custom
-        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
-        #   been created at the organization level. Example request URL: `https://iam.
-        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
-        #   Wildcard (*) values are invalid; you must specify a complete project ID or
-        #   organization ID.
+        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
+        #   reference/rest/v1/organizations.roles). Each resource type's `name` value
+        #   format is described below: * [`projects.roles.patch()`](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID``. This method updates only [custom roles](https://cloud.
+        #   google.com/iam/docs/understanding-custom-roles) that have been created at the
+        #   project level. Example request URL: `https://iam.googleapis.com/v1/projects/`
+        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.patch()`](https://
+        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/patch): `
+        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method updates
+        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
+        #   roles) that have been created at the organization level. Example request URL: `
+        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
+        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
+        #   complete project ID or organization ID.
         # @param [Google::Apis::IamV1::Role] role_object
         # @param [String] update_mask
         #   A mask describing which fields in the Role have changed.
@@ -1335,22 +1336,22 @@ module Google
         # Undeletes a custom Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
-        #   roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
-        #   organizations.roles). Each resource type's `name` value format is described
-        #   below: * [`projects.roles.undelete()`](https://cloud.google.com/iam/reference/
-        #   rest/v1/projects.roles/undelete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`
-        #   `. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/
-        #   understanding-custom-roles) that have been created at the project level.
-        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
-        #   roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.undelete()`](https://cloud.
-        #   google.com/iam/reference/rest/v1/organizations.roles/undelete): `organizations/
-        #   `ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes only [custom
-        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
-        #   been created at the organization level. Example request URL: `https://iam.
-        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
-        #   Wildcard (*) values are invalid; you must specify a complete project ID or
-        #   organization ID.
+        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
+        #   reference/rest/v1/organizations.roles). Each resource type's `name` value
+        #   format is described below: * [`projects.roles.undelete()`](https://cloud.
+        #   google.com/iam/docs/reference/rest/v1/projects.roles/undelete): `projects/`
+        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes only [custom roles](
+        #   https://cloud.google.com/iam/docs/understanding-custom-roles) that have been
+        #   created at the project level. Example request URL: `https://iam.googleapis.com/
+        #   v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.
+        #   undelete()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.
+        #   roles/undelete): `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``.
+        #   This method undeletes only [custom roles](https://cloud.google.com/iam/docs/
+        #   understanding-custom-roles) that have been created at the organization level.
+        #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
+        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid;
+        #   you must specify a complete project ID or organization ID.
         # @param [Google::Apis::IamV1::UndeleteRoleRequest] undelete_role_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2609,20 +2610,20 @@ module Google
         # Creates a new custom Role.
         # @param [String] parent
         #   The `parent` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
-        #   roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
-        #   organizations.roles). Each resource type's `parent` value format is described
-        #   below: * [`projects.roles.create()`](https://cloud.google.com/iam/reference/
-        #   rest/v1/projects.roles/create): `projects/`PROJECT_ID``. This method creates
-        #   project-level [custom roles](https://cloud.google.com/iam/docs/understanding-
-        #   custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/`
-        #   PROJECT_ID`/roles` * [`organizations.roles.create()`](https://cloud.google.com/
-        #   iam/reference/rest/v1/organizations.roles/create): `organizations/`
-        #   ORGANIZATION_ID``. This method creates organization-level [custom roles](https:
-        #   //cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `
-        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles` Note:
-        #   Wildcard (*) values are invalid; you must specify a complete project ID or
-        #   organization ID.
+        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
+        #   reference/rest/v1/organizations.roles). Each resource type's `parent` value
+        #   format is described below: * [`projects.roles.create()`](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/projects.roles/create): `projects/`PROJECT_ID``.
+        #   This method creates project-level [custom roles](https://cloud.google.com/iam/
+        #   docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.
+        #   com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.create()`](https://
+        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/create): `
+        #   organizations/`ORGANIZATION_ID``. This method creates organization-level [
+        #   custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
+        #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
+        #   ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
+        #   specify a complete project ID or organization ID.
         # @param [Google::Apis::IamV1::CreateRoleRequest] create_role_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2663,22 +2664,22 @@ module Google
         # binding is permanently removed.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
-        #   roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
-        #   organizations.roles). Each resource type's `name` value format is described
-        #   below: * [`projects.roles.delete()`](https://cloud.google.com/iam/reference/
-        #   rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
-        #   This method deletes only [custom roles](https://cloud.google.com/iam/docs/
-        #   understanding-custom-roles) that have been created at the project level.
-        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
-        #   roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.delete()`](https://cloud.
-        #   google.com/iam/reference/rest/v1/organizations.roles/delete): `organizations/`
-        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes only [custom
-        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
-        #   been created at the organization level. Example request URL: `https://iam.
-        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
-        #   Wildcard (*) values are invalid; you must specify a complete project ID or
-        #   organization ID.
+        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
+        #   reference/rest/v1/organizations.roles). Each resource type's `name` value
+        #   format is described below: * [`projects.roles.delete()`](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID``. This method deletes only [custom roles](https://cloud.
+        #   google.com/iam/docs/understanding-custom-roles) that have been created at the
+        #   project level. Example request URL: `https://iam.googleapis.com/v1/projects/`
+        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.delete()`](https://
+        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/delete): `
+        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes
+        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
+        #   roles) that have been created at the organization level. Example request URL: `
+        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
+        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
+        #   complete project ID or organization ID.
         # @param [String] etag
         #   Used to perform a consistent read-modify-write.
         # @param [String] fields
@@ -2712,26 +2713,27 @@ module Google
         # Gets the definition of a Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`roles`](https://cloud.google.com/iam/reference/rest/v1/roles), [`
-        #   projects`](https://cloud.google.com/iam/reference/rest/v1/projects.roles), or [
-        #   `organizations`](https://cloud.google.com/iam/reference/rest/v1/organizations.
-        #   roles). Each resource type's `name` value format is described below: * [`roles.
-        #   get()`](https://cloud.google.com/iam/reference/rest/v1/roles/get): `roles/`
-        #   ROLE_NAME``. This method returns results from all [predefined roles](https://
-        #   cloud.google.com/iam/docs/understanding-roles#predefined_roles) in Cloud IAM.
-        #   Example request URL: `https://iam.googleapis.com/v1/roles/`ROLE_NAME`` * [`
-        #   projects.roles.get()`](https://cloud.google.com/iam/reference/rest/v1/projects.
-        #   roles/get): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method
-        #   returns only [custom roles](https://cloud.google.com/iam/docs/understanding-
-        #   custom-roles) that have been created at the project level. Example request URL:
-        #   `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` *
-        #   [`organizations.roles.get()`](https://cloud.google.com/iam/reference/rest/v1/
-        #   organizations.roles/get): `organizations/`ORGANIZATION_ID`/roles/`
+        #   namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
+        #   projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
+        #   or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `name` value format is described
+        #   below: * [`roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   roles/get): `roles/`ROLE_NAME``. This method returns results from all [
+        #   predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
+        #   predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/
+        #   roles/`ROLE_NAME`` * [`projects.roles.get()`](https://cloud.google.com/iam/
+        #   docs/reference/rest/v1/projects.roles/get): `projects/`PROJECT_ID`/roles/`
         #   CUSTOM_ROLE_ID``. This method returns only [custom roles](https://cloud.google.
-        #   com/iam/docs/understanding-custom-roles) that have been created at the
-        #   organization level. Example request URL: `https://iam.googleapis.com/v1/
-        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note: Wildcard (*)
-        #   values are invalid; you must specify a complete project ID or organization ID.
+        #   com/iam/docs/understanding-custom-roles) that have been created at the project
+        #   level. Example request URL: `https://iam.googleapis.com/v1/projects/`
+        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.get()`](https://
+        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `
+        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method returns
+        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
+        #   roles) that have been created at the organization level. Example request URL: `
+        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
+        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
+        #   complete project ID or organization ID.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2763,25 +2765,25 @@ module Google
         # defined for an organization or project.
         # @param [String] parent
         #   The `parent` parameter's value depends on the target resource for the request,
-        #   namely [`roles`](https://cloud.google.com/iam/reference/rest/v1/roles), [`
-        #   projects`](https://cloud.google.com/iam/reference/rest/v1/projects.roles), or [
-        #   `organizations`](https://cloud.google.com/iam/reference/rest/v1/organizations.
-        #   roles). Each resource type's `parent` value format is described below: * [`
-        #   roles.list()`](https://cloud.google.com/iam/reference/rest/v1/roles/list): An
-        #   empty string. This method doesn't require a resource; it simply returns all [
-        #   predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
-        #   predefined_roles) in Cloud IAM. Example request URL: `https://iam.googleapis.
-        #   com/v1/roles` * [`projects.roles.list()`](https://cloud.google.com/iam/
-        #   reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``. This method
-        #   lists all project-level [custom roles](https://cloud.google.com/iam/docs/
-        #   understanding-custom-roles). Example request URL: `https://iam.googleapis.com/
-        #   v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`](https://cloud.
-        #   google.com/iam/reference/rest/v1/organizations.roles/list): `organizations/`
-        #   ORGANIZATION_ID``. This method lists all organization-level [custom roles](
-        #   https://cloud.google.com/iam/docs/understanding-custom-roles). Example request
-        #   URL: `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles`
-        #   Note: Wildcard (*) values are invalid; you must specify a complete project ID
-        #   or organization ID.
+        #   namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
+        #   projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
+        #   or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `parent` value format is described
+        #   below: * [`roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   roles/list): An empty string. This method doesn't require a resource; it
+        #   simply returns all [predefined roles](https://cloud.google.com/iam/docs/
+        #   understanding-roles#predefined_roles) in IAM. Example request URL: `https://
+        #   iam.googleapis.com/v1/roles` * [`projects.roles.list()`](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``.
+        #   This method lists all project-level [custom roles](https://cloud.google.com/
+        #   iam/docs/understanding-custom-roles). Example request URL: `https://iam.
+        #   googleapis.com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`]
+        #   (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list):
+        #   `organizations/`ORGANIZATION_ID``. This method lists all organization-level [
+        #   custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
+        #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
+        #   ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
+        #   specify a complete project ID or organization ID.
         # @param [Fixnum] page_size
         #   Optional limit on the number of roles to include in the response. The default
         #   is 300, and the maximum is 1,000.
@@ -2828,22 +2830,22 @@ module Google
         # Updates the definition of a custom Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
-        #   roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
-        #   organizations.roles). Each resource type's `name` value format is described
-        #   below: * [`projects.roles.patch()`](https://cloud.google.com/iam/reference/
-        #   rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
-        #   This method updates only [custom roles](https://cloud.google.com/iam/docs/
-        #   understanding-custom-roles) that have been created at the project level.
-        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
-        #   roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.patch()`](https://cloud.google.
-        #   com/iam/reference/rest/v1/organizations.roles/patch): `organizations/`
-        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method updates only [custom
-        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
-        #   been created at the organization level. Example request URL: `https://iam.
-        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
-        #   Wildcard (*) values are invalid; you must specify a complete project ID or
-        #   organization ID.
+        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
+        #   reference/rest/v1/organizations.roles). Each resource type's `name` value
+        #   format is described below: * [`projects.roles.patch()`](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID``. This method updates only [custom roles](https://cloud.
+        #   google.com/iam/docs/understanding-custom-roles) that have been created at the
+        #   project level. Example request URL: `https://iam.googleapis.com/v1/projects/`
+        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.patch()`](https://
+        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/patch): `
+        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method updates
+        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
+        #   roles) that have been created at the organization level. Example request URL: `
+        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
+        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
+        #   complete project ID or organization ID.
         # @param [Google::Apis::IamV1::Role] role_object
         # @param [String] update_mask
         #   A mask describing which fields in the Role have changed.
@@ -2880,22 +2882,22 @@ module Google
         # Undeletes a custom Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
-        #   roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
-        #   organizations.roles). Each resource type's `name` value format is described
-        #   below: * [`projects.roles.undelete()`](https://cloud.google.com/iam/reference/
-        #   rest/v1/projects.roles/undelete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`
-        #   `. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/
-        #   understanding-custom-roles) that have been created at the project level.
-        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
-        #   roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.undelete()`](https://cloud.
-        #   google.com/iam/reference/rest/v1/organizations.roles/undelete): `organizations/
-        #   `ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes only [custom
-        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
-        #   been created at the organization level. Example request URL: `https://iam.
-        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
-        #   Wildcard (*) values are invalid; you must specify a complete project ID or
-        #   organization ID.
+        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
+        #   reference/rest/v1/organizations.roles). Each resource type's `name` value
+        #   format is described below: * [`projects.roles.undelete()`](https://cloud.
+        #   google.com/iam/docs/reference/rest/v1/projects.roles/undelete): `projects/`
+        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes only [custom roles](
+        #   https://cloud.google.com/iam/docs/understanding-custom-roles) that have been
+        #   created at the project level. Example request URL: `https://iam.googleapis.com/
+        #   v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.
+        #   undelete()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.
+        #   roles/undelete): `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``.
+        #   This method undeletes only [custom roles](https://cloud.google.com/iam/docs/
+        #   understanding-custom-roles) that have been created at the organization level.
+        #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
+        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid;
+        #   you must specify a complete project ID or organization ID.
         # @param [Google::Apis::IamV1::UndeleteRoleRequest] undelete_role_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -3885,26 +3887,27 @@ module Google
         # Gets the definition of a Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`roles`](https://cloud.google.com/iam/reference/rest/v1/roles), [`
-        #   projects`](https://cloud.google.com/iam/reference/rest/v1/projects.roles), or [
-        #   `organizations`](https://cloud.google.com/iam/reference/rest/v1/organizations.
-        #   roles). Each resource type's `name` value format is described below: * [`roles.
-        #   get()`](https://cloud.google.com/iam/reference/rest/v1/roles/get): `roles/`
-        #   ROLE_NAME``. This method returns results from all [predefined roles](https://
-        #   cloud.google.com/iam/docs/understanding-roles#predefined_roles) in Cloud IAM.
-        #   Example request URL: `https://iam.googleapis.com/v1/roles/`ROLE_NAME`` * [`
-        #   projects.roles.get()`](https://cloud.google.com/iam/reference/rest/v1/projects.
-        #   roles/get): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method
-        #   returns only [custom roles](https://cloud.google.com/iam/docs/understanding-
-        #   custom-roles) that have been created at the project level. Example request URL:
-        #   `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` *
-        #   [`organizations.roles.get()`](https://cloud.google.com/iam/reference/rest/v1/
-        #   organizations.roles/get): `organizations/`ORGANIZATION_ID`/roles/`
+        #   namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
+        #   projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
+        #   or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `name` value format is described
+        #   below: * [`roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   roles/get): `roles/`ROLE_NAME``. This method returns results from all [
+        #   predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
+        #   predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/
+        #   roles/`ROLE_NAME`` * [`projects.roles.get()`](https://cloud.google.com/iam/
+        #   docs/reference/rest/v1/projects.roles/get): `projects/`PROJECT_ID`/roles/`
         #   CUSTOM_ROLE_ID``. This method returns only [custom roles](https://cloud.google.
-        #   com/iam/docs/understanding-custom-roles) that have been created at the
-        #   organization level. Example request URL: `https://iam.googleapis.com/v1/
-        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note: Wildcard (*)
-        #   values are invalid; you must specify a complete project ID or organization ID.
+        #   com/iam/docs/understanding-custom-roles) that have been created at the project
+        #   level. Example request URL: `https://iam.googleapis.com/v1/projects/`
+        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.get()`](https://
+        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `
+        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method returns
+        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
+        #   roles) that have been created at the organization level. Example request URL: `
+        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
+        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
+        #   complete project ID or organization ID.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -3941,25 +3944,25 @@ module Google
         #   Optional pagination token returned in an earlier ListRolesResponse.
         # @param [String] parent
         #   The `parent` parameter's value depends on the target resource for the request,
-        #   namely [`roles`](https://cloud.google.com/iam/reference/rest/v1/roles), [`
-        #   projects`](https://cloud.google.com/iam/reference/rest/v1/projects.roles), or [
-        #   `organizations`](https://cloud.google.com/iam/reference/rest/v1/organizations.
-        #   roles). Each resource type's `parent` value format is described below: * [`
-        #   roles.list()`](https://cloud.google.com/iam/reference/rest/v1/roles/list): An
-        #   empty string. This method doesn't require a resource; it simply returns all [
-        #   predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
-        #   predefined_roles) in Cloud IAM. Example request URL: `https://iam.googleapis.
-        #   com/v1/roles` * [`projects.roles.list()`](https://cloud.google.com/iam/
-        #   reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``. This method
-        #   lists all project-level [custom roles](https://cloud.google.com/iam/docs/
-        #   understanding-custom-roles). Example request URL: `https://iam.googleapis.com/
-        #   v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`](https://cloud.
-        #   google.com/iam/reference/rest/v1/organizations.roles/list): `organizations/`
-        #   ORGANIZATION_ID``. This method lists all organization-level [custom roles](
-        #   https://cloud.google.com/iam/docs/understanding-custom-roles). Example request
-        #   URL: `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles`
-        #   Note: Wildcard (*) values are invalid; you must specify a complete project ID
-        #   or organization ID.
+        #   namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
+        #   projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
+        #   or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `parent` value format is described
+        #   below: * [`roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   roles/list): An empty string. This method doesn't require a resource; it
+        #   simply returns all [predefined roles](https://cloud.google.com/iam/docs/
+        #   understanding-roles#predefined_roles) in IAM. Example request URL: `https://
+        #   iam.googleapis.com/v1/roles` * [`projects.roles.list()`](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``.
+        #   This method lists all project-level [custom roles](https://cloud.google.com/
+        #   iam/docs/understanding-custom-roles). Example request URL: `https://iam.
+        #   googleapis.com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`]
+        #   (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list):
+        #   `organizations/`ORGANIZATION_ID``. This method lists all organization-level [
+        #   custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
+        #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
+        #   ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
+        #   specify a complete project ID or organization ID.
         # @param [Boolean] show_deleted
         #   Include Roles that have been deleted.
         # @param [String] view

metadata CHANGED Viewed

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-iam_v1
 version: !ruby/object:Gem::Version
-  version: 0.56.0
+  version: 0.57.0
 platform: ruby
 authors:
 - Google LLC
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-04-21 00:00:00.000000000 Z
+date: 2024-04-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -59,7 +59,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-iam_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-iam_v1/v0.56.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-iam_v1/v0.57.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-iam_v1
 post_install_message:
 rdoc_options: []