google-apis-iam_v1 0.55.0 → 0.57.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -383,8 +383,9 @@ module Google
383
383
  execute_or_queue_command(command, &block)
384
384
  end
385
385
 
386
- # Returns the caller's permissions on the WorkforcePool. If the pool does not
387
- # exist, this will return an empty set of permissions, not a `NOT_FOUND` error.
386
+ # Returns the caller's permissions on the WorkforcePool. If the pool doesn't
387
+ # exist, this call returns an empty set of permissions. It doesn't return a `
388
+ # NOT_FOUND` error.
388
389
  # @param [String] resource
389
390
  # REQUIRED: The resource for which the policy detail is being requested. See [
390
391
  # Resource names](https://cloud.google.com/apis/design/resource_names) for the
@@ -526,7 +527,7 @@ module Google
526
527
  end
527
528
 
528
529
  # Deletes a WorkforcePoolProvider. Deleting a provider does not revoke
529
- # credentials that have already been\ issued; they continue to grant access. You
530
+ # credentials that have already been issued; they continue to grant access. You
530
531
  # can undelete a provider for 30 days. After 30 days, deletion is permanent. You
531
532
  # cannot update deleted providers. However, you can view and list them.
532
533
  # @param [String] name
@@ -947,16 +948,20 @@ module Google
947
948
 
948
949
  # Deletes a WorkforcePoolSubject. Subject must not already be in a deleted state.
949
950
  # A WorkforcePoolSubject is automatically created the first time an external
950
- # credential is exchanged for a Google Cloud credential with a mapped `google.
951
- # subject` attribute. There is no path to manually create WorkforcePoolSubjects.
952
- # Once deleted, the WorkforcePoolSubject may not be used for 30 days. After 30
953
- # days, the WorkforcePoolSubject will be deleted forever and can be reused in
954
- # token exchanges with Google Cloud STS. This will automatically create a new
955
- # WorkforcePoolSubject that is independent of the previously deleted
956
- # WorkforcePoolSubject with the same google.subject value.
951
+ # credential is exchanged for a Google Cloud credential using a mapped `google.
952
+ # subject` attribute. There is no endpoint to manually create a
953
+ # WorkforcePoolSubject. For 30 days after a WorkforcePoolSubject is deleted,
954
+ # using the same `google.subject` attribute in token exchanges with Google Cloud
955
+ # STS fails. Call UndeleteWorkforcePoolSubject to undelete a
956
+ # WorkforcePoolSubject that has been deleted, within within 30 days of deleting
957
+ # it. After 30 days, the WorkforcePoolSubject is permanently deleted. At this
958
+ # point, a token exchange with Google Cloud STS that uses the same mapped `
959
+ # google.subject` attribute automatically creates a new WorkforcePoolSubject
960
+ # that is unrelated to the previously deleted WorkforcePoolSubject but has the
961
+ # same `google.subject` value.
957
962
  # @param [String] name
958
963
  # Required. The resource name of the WorkforcePoolSubject. Special characters,
959
- # like '/' and ':', must be escaped, because all URLs need to conform to the "
964
+ # like `/` and `:`, must be escaped, because all URLs need to conform to the "
960
965
  # When to Escape and Unescape" section of [RFC3986](https://www.ietf.org/rfc/
961
966
  # rfc2396.txt). Format: `locations/`location`/workforcePools/`workforce_pool_id`/
962
967
  # subjects/`subject_id``
@@ -991,7 +996,7 @@ module Google
991
996
  # ago.
992
997
  # @param [String] name
993
998
  # Required. The resource name of the WorkforcePoolSubject. Special characters,
994
- # like '/' and ':', must be escaped, because all URLs need to conform to the "
999
+ # like `/` and `:`, must be escaped, because all URLs need to conform to the "
995
1000
  # When to Escape and Unescape" section of [RFC3986](https://www.ietf.org/rfc/
996
1001
  # rfc2396.txt). Format: `locations/`location`/workforcePools/`workforce_pool_id`/
997
1002
  # subjects/`subject_id``
@@ -1059,20 +1064,20 @@ module Google
1059
1064
  # Creates a new custom Role.
1060
1065
  # @param [String] parent
1061
1066
  # The `parent` parameter's value depends on the target resource for the request,
1062
- # namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
1063
- # roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
1064
- # organizations.roles). Each resource type's `parent` value format is described
1065
- # below: * [`projects.roles.create()`](https://cloud.google.com/iam/reference/
1066
- # rest/v1/projects.roles/create): `projects/`PROJECT_ID``. This method creates
1067
- # project-level [custom roles](https://cloud.google.com/iam/docs/understanding-
1068
- # custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/`
1069
- # PROJECT_ID`/roles` * [`organizations.roles.create()`](https://cloud.google.com/
1070
- # iam/reference/rest/v1/organizations.roles/create): `organizations/`
1071
- # ORGANIZATION_ID``. This method creates organization-level [custom roles](https:
1072
- # //cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `
1073
- # https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles` Note:
1074
- # Wildcard (*) values are invalid; you must specify a complete project ID or
1075
- # organization ID.
1067
+ # namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
1068
+ # projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
1069
+ # reference/rest/v1/organizations.roles). Each resource type's `parent` value
1070
+ # format is described below: * [`projects.roles.create()`](https://cloud.google.
1071
+ # com/iam/docs/reference/rest/v1/projects.roles/create): `projects/`PROJECT_ID``.
1072
+ # This method creates project-level [custom roles](https://cloud.google.com/iam/
1073
+ # docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.
1074
+ # com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.create()`](https://
1075
+ # cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/create): `
1076
+ # organizations/`ORGANIZATION_ID``. This method creates organization-level [
1077
+ # custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
1078
+ # Example request URL: `https://iam.googleapis.com/v1/organizations/`
1079
+ # ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
1080
+ # specify a complete project ID or organization ID.
1076
1081
  # @param [Google::Apis::IamV1::CreateRoleRequest] create_role_request_object
1077
1082
  # @param [String] fields
1078
1083
  # Selector specifying which fields to include in a partial response.
@@ -1113,22 +1118,22 @@ module Google
1113
1118
  # binding is permanently removed.
1114
1119
  # @param [String] name
1115
1120
  # The `name` parameter's value depends on the target resource for the request,
1116
- # namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
1117
- # roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
1118
- # organizations.roles). Each resource type's `name` value format is described
1119
- # below: * [`projects.roles.delete()`](https://cloud.google.com/iam/reference/
1120
- # rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
1121
- # This method deletes only [custom roles](https://cloud.google.com/iam/docs/
1122
- # understanding-custom-roles) that have been created at the project level.
1123
- # Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
1124
- # roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.delete()`](https://cloud.
1125
- # google.com/iam/reference/rest/v1/organizations.roles/delete): `organizations/`
1126
- # ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes only [custom
1127
- # roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
1128
- # been created at the organization level. Example request URL: `https://iam.
1129
- # googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
1130
- # Wildcard (*) values are invalid; you must specify a complete project ID or
1131
- # organization ID.
1121
+ # namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
1122
+ # projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
1123
+ # reference/rest/v1/organizations.roles). Each resource type's `name` value
1124
+ # format is described below: * [`projects.roles.delete()`](https://cloud.google.
1125
+ # com/iam/docs/reference/rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/
1126
+ # roles/`CUSTOM_ROLE_ID``. This method deletes only [custom roles](https://cloud.
1127
+ # google.com/iam/docs/understanding-custom-roles) that have been created at the
1128
+ # project level. Example request URL: `https://iam.googleapis.com/v1/projects/`
1129
+ # PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.delete()`](https://
1130
+ # cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/delete): `
1131
+ # organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes
1132
+ # only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
1133
+ # roles) that have been created at the organization level. Example request URL: `
1134
+ # https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
1135
+ # CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
1136
+ # complete project ID or organization ID.
1132
1137
  # @param [String] etag
1133
1138
  # Used to perform a consistent read-modify-write.
1134
1139
  # @param [String] fields
@@ -1162,26 +1167,27 @@ module Google
1162
1167
  # Gets the definition of a Role.
1163
1168
  # @param [String] name
1164
1169
  # The `name` parameter's value depends on the target resource for the request,
1165
- # namely [`roles`](https://cloud.google.com/iam/reference/rest/v1/roles), [`
1166
- # projects`](https://cloud.google.com/iam/reference/rest/v1/projects.roles), or [
1167
- # `organizations`](https://cloud.google.com/iam/reference/rest/v1/organizations.
1168
- # roles). Each resource type's `name` value format is described below: * [`roles.
1169
- # get()`](https://cloud.google.com/iam/reference/rest/v1/roles/get): `roles/`
1170
- # ROLE_NAME``. This method returns results from all [predefined roles](https://
1171
- # cloud.google.com/iam/docs/understanding-roles#predefined_roles) in Cloud IAM.
1172
- # Example request URL: `https://iam.googleapis.com/v1/roles/`ROLE_NAME`` * [`
1173
- # projects.roles.get()`](https://cloud.google.com/iam/reference/rest/v1/projects.
1174
- # roles/get): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method
1175
- # returns only [custom roles](https://cloud.google.com/iam/docs/understanding-
1176
- # custom-roles) that have been created at the project level. Example request URL:
1177
- # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` *
1178
- # [`organizations.roles.get()`](https://cloud.google.com/iam/reference/rest/v1/
1179
- # organizations.roles/get): `organizations/`ORGANIZATION_ID`/roles/`
1170
+ # namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
1171
+ # projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
1172
+ # or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
1173
+ # organizations.roles). Each resource type's `name` value format is described
1174
+ # below: * [`roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/
1175
+ # roles/get): `roles/`ROLE_NAME``. This method returns results from all [
1176
+ # predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
1177
+ # predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/
1178
+ # roles/`ROLE_NAME`` * [`projects.roles.get()`](https://cloud.google.com/iam/
1179
+ # docs/reference/rest/v1/projects.roles/get): `projects/`PROJECT_ID`/roles/`
1180
1180
  # CUSTOM_ROLE_ID``. This method returns only [custom roles](https://cloud.google.
1181
- # com/iam/docs/understanding-custom-roles) that have been created at the
1182
- # organization level. Example request URL: `https://iam.googleapis.com/v1/
1183
- # organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note: Wildcard (*)
1184
- # values are invalid; you must specify a complete project ID or organization ID.
1181
+ # com/iam/docs/understanding-custom-roles) that have been created at the project
1182
+ # level. Example request URL: `https://iam.googleapis.com/v1/projects/`
1183
+ # PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.get()`](https://
1184
+ # cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `
1185
+ # organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method returns
1186
+ # only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
1187
+ # roles) that have been created at the organization level. Example request URL: `
1188
+ # https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
1189
+ # CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
1190
+ # complete project ID or organization ID.
1185
1191
  # @param [String] fields
1186
1192
  # Selector specifying which fields to include in a partial response.
1187
1193
  # @param [String] quota_user
@@ -1213,25 +1219,25 @@ module Google
1213
1219
  # defined for an organization or project.
1214
1220
  # @param [String] parent
1215
1221
  # The `parent` parameter's value depends on the target resource for the request,
1216
- # namely [`roles`](https://cloud.google.com/iam/reference/rest/v1/roles), [`
1217
- # projects`](https://cloud.google.com/iam/reference/rest/v1/projects.roles), or [
1218
- # `organizations`](https://cloud.google.com/iam/reference/rest/v1/organizations.
1219
- # roles). Each resource type's `parent` value format is described below: * [`
1220
- # roles.list()`](https://cloud.google.com/iam/reference/rest/v1/roles/list): An
1221
- # empty string. This method doesn't require a resource; it simply returns all [
1222
- # predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
1223
- # predefined_roles) in Cloud IAM. Example request URL: `https://iam.googleapis.
1224
- # com/v1/roles` * [`projects.roles.list()`](https://cloud.google.com/iam/
1225
- # reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``. This method
1226
- # lists all project-level [custom roles](https://cloud.google.com/iam/docs/
1227
- # understanding-custom-roles). Example request URL: `https://iam.googleapis.com/
1228
- # v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`](https://cloud.
1229
- # google.com/iam/reference/rest/v1/organizations.roles/list): `organizations/`
1230
- # ORGANIZATION_ID``. This method lists all organization-level [custom roles](
1231
- # https://cloud.google.com/iam/docs/understanding-custom-roles). Example request
1232
- # URL: `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles`
1233
- # Note: Wildcard (*) values are invalid; you must specify a complete project ID
1234
- # or organization ID.
1222
+ # namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
1223
+ # projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
1224
+ # or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
1225
+ # organizations.roles). Each resource type's `parent` value format is described
1226
+ # below: * [`roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/
1227
+ # roles/list): An empty string. This method doesn't require a resource; it
1228
+ # simply returns all [predefined roles](https://cloud.google.com/iam/docs/
1229
+ # understanding-roles#predefined_roles) in IAM. Example request URL: `https://
1230
+ # iam.googleapis.com/v1/roles` * [`projects.roles.list()`](https://cloud.google.
1231
+ # com/iam/docs/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``.
1232
+ # This method lists all project-level [custom roles](https://cloud.google.com/
1233
+ # iam/docs/understanding-custom-roles). Example request URL: `https://iam.
1234
+ # googleapis.com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`]
1235
+ # (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list):
1236
+ # `organizations/`ORGANIZATION_ID``. This method lists all organization-level [
1237
+ # custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
1238
+ # Example request URL: `https://iam.googleapis.com/v1/organizations/`
1239
+ # ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
1240
+ # specify a complete project ID or organization ID.
1235
1241
  # @param [Fixnum] page_size
1236
1242
  # Optional limit on the number of roles to include in the response. The default
1237
1243
  # is 300, and the maximum is 1,000.
@@ -1278,22 +1284,22 @@ module Google
1278
1284
  # Updates the definition of a custom Role.
1279
1285
  # @param [String] name
1280
1286
  # The `name` parameter's value depends on the target resource for the request,
1281
- # namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
1282
- # roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
1283
- # organizations.roles). Each resource type's `name` value format is described
1284
- # below: * [`projects.roles.patch()`](https://cloud.google.com/iam/reference/
1285
- # rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
1286
- # This method updates only [custom roles](https://cloud.google.com/iam/docs/
1287
- # understanding-custom-roles) that have been created at the project level.
1288
- # Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
1289
- # roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.patch()`](https://cloud.google.
1290
- # com/iam/reference/rest/v1/organizations.roles/patch): `organizations/`
1291
- # ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method updates only [custom
1292
- # roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
1293
- # been created at the organization level. Example request URL: `https://iam.
1294
- # googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
1295
- # Wildcard (*) values are invalid; you must specify a complete project ID or
1296
- # organization ID.
1287
+ # namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
1288
+ # projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
1289
+ # reference/rest/v1/organizations.roles). Each resource type's `name` value
1290
+ # format is described below: * [`projects.roles.patch()`](https://cloud.google.
1291
+ # com/iam/docs/reference/rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/
1292
+ # roles/`CUSTOM_ROLE_ID``. This method updates only [custom roles](https://cloud.
1293
+ # google.com/iam/docs/understanding-custom-roles) that have been created at the
1294
+ # project level. Example request URL: `https://iam.googleapis.com/v1/projects/`
1295
+ # PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.patch()`](https://
1296
+ # cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/patch): `
1297
+ # organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method updates
1298
+ # only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
1299
+ # roles) that have been created at the organization level. Example request URL: `
1300
+ # https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
1301
+ # CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
1302
+ # complete project ID or organization ID.
1297
1303
  # @param [Google::Apis::IamV1::Role] role_object
1298
1304
  # @param [String] update_mask
1299
1305
  # A mask describing which fields in the Role have changed.
@@ -1330,22 +1336,22 @@ module Google
1330
1336
  # Undeletes a custom Role.
1331
1337
  # @param [String] name
1332
1338
  # The `name` parameter's value depends on the target resource for the request,
1333
- # namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
1334
- # roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
1335
- # organizations.roles). Each resource type's `name` value format is described
1336
- # below: * [`projects.roles.undelete()`](https://cloud.google.com/iam/reference/
1337
- # rest/v1/projects.roles/undelete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`
1338
- # `. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/
1339
- # understanding-custom-roles) that have been created at the project level.
1340
- # Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
1341
- # roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.undelete()`](https://cloud.
1342
- # google.com/iam/reference/rest/v1/organizations.roles/undelete): `organizations/
1343
- # `ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes only [custom
1344
- # roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
1345
- # been created at the organization level. Example request URL: `https://iam.
1346
- # googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
1347
- # Wildcard (*) values are invalid; you must specify a complete project ID or
1348
- # organization ID.
1339
+ # namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
1340
+ # projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
1341
+ # reference/rest/v1/organizations.roles). Each resource type's `name` value
1342
+ # format is described below: * [`projects.roles.undelete()`](https://cloud.
1343
+ # google.com/iam/docs/reference/rest/v1/projects.roles/undelete): `projects/`
1344
+ # PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes only [custom roles](
1345
+ # https://cloud.google.com/iam/docs/understanding-custom-roles) that have been
1346
+ # created at the project level. Example request URL: `https://iam.googleapis.com/
1347
+ # v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.
1348
+ # undelete()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.
1349
+ # roles/undelete): `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``.
1350
+ # This method undeletes only [custom roles](https://cloud.google.com/iam/docs/
1351
+ # understanding-custom-roles) that have been created at the organization level.
1352
+ # Example request URL: `https://iam.googleapis.com/v1/organizations/`
1353
+ # ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid;
1354
+ # you must specify a complete project ID or organization ID.
1349
1355
  # @param [Google::Apis::IamV1::UndeleteRoleRequest] undelete_role_request_object
1350
1356
  # @param [String] fields
1351
1357
  # Selector specifying which fields to include in a partial response.
@@ -1408,6 +1414,403 @@ module Google
1408
1414
  execute_or_queue_command(command, &block)
1409
1415
  end
1410
1416
 
1417
+ # Creates a new OauthClient. You cannot reuse the name of a deleted oauth client
1418
+ # until 30 days after deletion.
1419
+ # @param [String] parent
1420
+ # Required. The parent resource to create the oauth client in. The only
1421
+ # supported location is `global`.
1422
+ # @param [Google::Apis::IamV1::OauthClient] oauth_client_object
1423
+ # @param [String] oauth_client_id
1424
+ # Required. The ID to use for the oauth client, which becomes the final
1425
+ # component of the resource name. This value should be a string of 6 to 63
1426
+ # lowercase letters, digits, or hyphens. It must start with a letter, and cannot
1427
+ # have a trailing hyphen. The prefix `gcp-` is reserved for use by Google, and
1428
+ # may not be specified.
1429
+ # @param [String] fields
1430
+ # Selector specifying which fields to include in a partial response.
1431
+ # @param [String] quota_user
1432
+ # Available to use for quota purposes for server-side applications. Can be any
1433
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1434
+ # @param [Google::Apis::RequestOptions] options
1435
+ # Request-specific options
1436
+ #
1437
+ # @yield [result, err] Result & error if block supplied
1438
+ # @yieldparam result [Google::Apis::IamV1::OauthClient] parsed result object
1439
+ # @yieldparam err [StandardError] error object if request failed
1440
+ #
1441
+ # @return [Google::Apis::IamV1::OauthClient]
1442
+ #
1443
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1444
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1445
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1446
+ def create_project_location_oauth_client(parent, oauth_client_object = nil, oauth_client_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1447
+ command = make_simple_command(:post, 'v1/{+parent}/oauthClients', options)
1448
+ command.request_representation = Google::Apis::IamV1::OauthClient::Representation
1449
+ command.request_object = oauth_client_object
1450
+ command.response_representation = Google::Apis::IamV1::OauthClient::Representation
1451
+ command.response_class = Google::Apis::IamV1::OauthClient
1452
+ command.params['parent'] = parent unless parent.nil?
1453
+ command.query['oauthClientId'] = oauth_client_id unless oauth_client_id.nil?
1454
+ command.query['fields'] = fields unless fields.nil?
1455
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1456
+ execute_or_queue_command(command, &block)
1457
+ end
1458
+
1459
+ # Deletes a OauthClient. You cannot use a deleted oauth client. However,
1460
+ # deletion does not revoke access tokens that have already been issued; they
1461
+ # continue to grant access. Deletion does revoke refresh tokens that have
1462
+ # already been issued; They cannot be used to renew an access token. If the
1463
+ # oauth client is undeleted, and the refresh tokens are not expired, they are
1464
+ # valid for token exchange again. You can undelete an oauth client for 30 days.
1465
+ # After 30 days, deletion is permanent. You cannot update deleted oauth clients.
1466
+ # However, you can view and list them.
1467
+ # @param [String] name
1468
+ # Required. The name of the oauth client to delete. Format: `projects/`project`/
1469
+ # locations/`location`/oauthClients/`oauth_client``.
1470
+ # @param [String] fields
1471
+ # Selector specifying which fields to include in a partial response.
1472
+ # @param [String] quota_user
1473
+ # Available to use for quota purposes for server-side applications. Can be any
1474
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1475
+ # @param [Google::Apis::RequestOptions] options
1476
+ # Request-specific options
1477
+ #
1478
+ # @yield [result, err] Result & error if block supplied
1479
+ # @yieldparam result [Google::Apis::IamV1::OauthClient] parsed result object
1480
+ # @yieldparam err [StandardError] error object if request failed
1481
+ #
1482
+ # @return [Google::Apis::IamV1::OauthClient]
1483
+ #
1484
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1485
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1486
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1487
+ def delete_project_location_oauth_client(name, fields: nil, quota_user: nil, options: nil, &block)
1488
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1489
+ command.response_representation = Google::Apis::IamV1::OauthClient::Representation
1490
+ command.response_class = Google::Apis::IamV1::OauthClient
1491
+ command.params['name'] = name unless name.nil?
1492
+ command.query['fields'] = fields unless fields.nil?
1493
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1494
+ execute_or_queue_command(command, &block)
1495
+ end
1496
+
1497
+ # Gets an individual OauthClient.
1498
+ # @param [String] name
1499
+ # Required. The name of the oauth client to retrieve. Format: `projects/`project`
1500
+ # /locations/`location`/oauthClients/`oauth_client``.
1501
+ # @param [String] fields
1502
+ # Selector specifying which fields to include in a partial response.
1503
+ # @param [String] quota_user
1504
+ # Available to use for quota purposes for server-side applications. Can be any
1505
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1506
+ # @param [Google::Apis::RequestOptions] options
1507
+ # Request-specific options
1508
+ #
1509
+ # @yield [result, err] Result & error if block supplied
1510
+ # @yieldparam result [Google::Apis::IamV1::OauthClient] parsed result object
1511
+ # @yieldparam err [StandardError] error object if request failed
1512
+ #
1513
+ # @return [Google::Apis::IamV1::OauthClient]
1514
+ #
1515
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1516
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1517
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1518
+ def get_project_location_oauth_client(name, fields: nil, quota_user: nil, options: nil, &block)
1519
+ command = make_simple_command(:get, 'v1/{+name}', options)
1520
+ command.response_representation = Google::Apis::IamV1::OauthClient::Representation
1521
+ command.response_class = Google::Apis::IamV1::OauthClient
1522
+ command.params['name'] = name unless name.nil?
1523
+ command.query['fields'] = fields unless fields.nil?
1524
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1525
+ execute_or_queue_command(command, &block)
1526
+ end
1527
+
1528
+ # Lists all non-deleted OauthClientss in a project. If `show_deleted` is set to `
1529
+ # true`, then deleted oauth clients are also listed.
1530
+ # @param [String] parent
1531
+ # Required. The parent to list oauth clients for.
1532
+ # @param [Fixnum] page_size
1533
+ # Optional. The maximum number of oauth clients to return. If unspecified, at
1534
+ # most 50 oauth clients will be returned. The maximum value is 100; values above
1535
+ # 100 are truncated to 100.
1536
+ # @param [String] page_token
1537
+ # Optional. A page token, received from a previous `ListOauthClients` call.
1538
+ # Provide this to retrieve the subsequent page.
1539
+ # @param [Boolean] show_deleted
1540
+ # Optional. Whether to return soft-deleted oauth clients.
1541
+ # @param [String] fields
1542
+ # Selector specifying which fields to include in a partial response.
1543
+ # @param [String] quota_user
1544
+ # Available to use for quota purposes for server-side applications. Can be any
1545
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1546
+ # @param [Google::Apis::RequestOptions] options
1547
+ # Request-specific options
1548
+ #
1549
+ # @yield [result, err] Result & error if block supplied
1550
+ # @yieldparam result [Google::Apis::IamV1::ListOauthClientsResponse] parsed result object
1551
+ # @yieldparam err [StandardError] error object if request failed
1552
+ #
1553
+ # @return [Google::Apis::IamV1::ListOauthClientsResponse]
1554
+ #
1555
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1556
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1557
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1558
+ def list_project_location_oauth_clients(parent, page_size: nil, page_token: nil, show_deleted: nil, fields: nil, quota_user: nil, options: nil, &block)
1559
+ command = make_simple_command(:get, 'v1/{+parent}/oauthClients', options)
1560
+ command.response_representation = Google::Apis::IamV1::ListOauthClientsResponse::Representation
1561
+ command.response_class = Google::Apis::IamV1::ListOauthClientsResponse
1562
+ command.params['parent'] = parent unless parent.nil?
1563
+ command.query['pageSize'] = page_size unless page_size.nil?
1564
+ command.query['pageToken'] = page_token unless page_token.nil?
1565
+ command.query['showDeleted'] = show_deleted unless show_deleted.nil?
1566
+ command.query['fields'] = fields unless fields.nil?
1567
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1568
+ execute_or_queue_command(command, &block)
1569
+ end
1570
+
1571
+ # Updates an existing OauthClient.
1572
+ # @param [String] name
1573
+ # Immutable. The resource name of the oauth client. Format:`projects/`project`/
1574
+ # locations/`location`/oauthClients/`oauth_client``.
1575
+ # @param [Google::Apis::IamV1::OauthClient] oauth_client_object
1576
+ # @param [String] update_mask
1577
+ # Required. The list of fields to update.
1578
+ # @param [String] fields
1579
+ # Selector specifying which fields to include in a partial response.
1580
+ # @param [String] quota_user
1581
+ # Available to use for quota purposes for server-side applications. Can be any
1582
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1583
+ # @param [Google::Apis::RequestOptions] options
1584
+ # Request-specific options
1585
+ #
1586
+ # @yield [result, err] Result & error if block supplied
1587
+ # @yieldparam result [Google::Apis::IamV1::OauthClient] parsed result object
1588
+ # @yieldparam err [StandardError] error object if request failed
1589
+ #
1590
+ # @return [Google::Apis::IamV1::OauthClient]
1591
+ #
1592
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1593
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1594
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1595
+ def patch_project_location_oauth_client(name, oauth_client_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1596
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1597
+ command.request_representation = Google::Apis::IamV1::OauthClient::Representation
1598
+ command.request_object = oauth_client_object
1599
+ command.response_representation = Google::Apis::IamV1::OauthClient::Representation
1600
+ command.response_class = Google::Apis::IamV1::OauthClient
1601
+ command.params['name'] = name unless name.nil?
1602
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1603
+ command.query['fields'] = fields unless fields.nil?
1604
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1605
+ execute_or_queue_command(command, &block)
1606
+ end
1607
+
1608
+ # Undeletes a OauthClient, as long as it was deleted fewer than 30 days ago.
1609
+ # @param [String] name
1610
+ # Required. The name of the oauth client to undelete. Format: `projects/`project`
1611
+ # /locations/`location`/oauthClients/`oauth_client``.
1612
+ # @param [Google::Apis::IamV1::UndeleteOauthClientRequest] undelete_oauth_client_request_object
1613
+ # @param [String] fields
1614
+ # Selector specifying which fields to include in a partial response.
1615
+ # @param [String] quota_user
1616
+ # Available to use for quota purposes for server-side applications. Can be any
1617
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1618
+ # @param [Google::Apis::RequestOptions] options
1619
+ # Request-specific options
1620
+ #
1621
+ # @yield [result, err] Result & error if block supplied
1622
+ # @yieldparam result [Google::Apis::IamV1::OauthClient] parsed result object
1623
+ # @yieldparam err [StandardError] error object if request failed
1624
+ #
1625
+ # @return [Google::Apis::IamV1::OauthClient]
1626
+ #
1627
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1628
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1629
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1630
+ def undelete_oauth_client(name, undelete_oauth_client_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1631
+ command = make_simple_command(:post, 'v1/{+name}:undelete', options)
1632
+ command.request_representation = Google::Apis::IamV1::UndeleteOauthClientRequest::Representation
1633
+ command.request_object = undelete_oauth_client_request_object
1634
+ command.response_representation = Google::Apis::IamV1::OauthClient::Representation
1635
+ command.response_class = Google::Apis::IamV1::OauthClient
1636
+ command.params['name'] = name unless name.nil?
1637
+ command.query['fields'] = fields unless fields.nil?
1638
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1639
+ execute_or_queue_command(command, &block)
1640
+ end
1641
+
1642
+ # Creates a new OauthClientCredential.
1643
+ # @param [String] parent
1644
+ # Required. The parent resource to create the oauth client Credential in.
1645
+ # @param [Google::Apis::IamV1::OauthClientCredential] oauth_client_credential_object
1646
+ # @param [String] oauth_client_credential_id
1647
+ # Required. The ID to use for the oauth client credential, which becomes the
1648
+ # final component of the resource name. This value should be 4-32 characters,
1649
+ # and may contain the characters [a-z0-9-]. The prefix `gcp-` is reserved for
1650
+ # use by Google, and may not be specified.
1651
+ # @param [String] fields
1652
+ # Selector specifying which fields to include in a partial response.
1653
+ # @param [String] quota_user
1654
+ # Available to use for quota purposes for server-side applications. Can be any
1655
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1656
+ # @param [Google::Apis::RequestOptions] options
1657
+ # Request-specific options
1658
+ #
1659
+ # @yield [result, err] Result & error if block supplied
1660
+ # @yieldparam result [Google::Apis::IamV1::OauthClientCredential] parsed result object
1661
+ # @yieldparam err [StandardError] error object if request failed
1662
+ #
1663
+ # @return [Google::Apis::IamV1::OauthClientCredential]
1664
+ #
1665
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1666
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1667
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1668
+ def create_project_location_oauth_client_credential(parent, oauth_client_credential_object = nil, oauth_client_credential_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1669
+ command = make_simple_command(:post, 'v1/{+parent}/credentials', options)
1670
+ command.request_representation = Google::Apis::IamV1::OauthClientCredential::Representation
1671
+ command.request_object = oauth_client_credential_object
1672
+ command.response_representation = Google::Apis::IamV1::OauthClientCredential::Representation
1673
+ command.response_class = Google::Apis::IamV1::OauthClientCredential
1674
+ command.params['parent'] = parent unless parent.nil?
1675
+ command.query['oauthClientCredentialId'] = oauth_client_credential_id unless oauth_client_credential_id.nil?
1676
+ command.query['fields'] = fields unless fields.nil?
1677
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1678
+ execute_or_queue_command(command, &block)
1679
+ end
1680
+
1681
+ # Deletes a OauthClientCredential. Before deleting an oauth client credential,
1682
+ # it should first be disabled.
1683
+ # @param [String] name
1684
+ # Required. The name of the oauth client credential to delete. Format: `projects/
1685
+ # `project`/locations/`location`/oauthClients/`oauth_client`/credentials/`
1686
+ # credential``.
1687
+ # @param [String] fields
1688
+ # Selector specifying which fields to include in a partial response.
1689
+ # @param [String] quota_user
1690
+ # Available to use for quota purposes for server-side applications. Can be any
1691
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1692
+ # @param [Google::Apis::RequestOptions] options
1693
+ # Request-specific options
1694
+ #
1695
+ # @yield [result, err] Result & error if block supplied
1696
+ # @yieldparam result [Google::Apis::IamV1::Empty] parsed result object
1697
+ # @yieldparam err [StandardError] error object if request failed
1698
+ #
1699
+ # @return [Google::Apis::IamV1::Empty]
1700
+ #
1701
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1702
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1703
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1704
+ def delete_project_location_oauth_client_credential(name, fields: nil, quota_user: nil, options: nil, &block)
1705
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1706
+ command.response_representation = Google::Apis::IamV1::Empty::Representation
1707
+ command.response_class = Google::Apis::IamV1::Empty
1708
+ command.params['name'] = name unless name.nil?
1709
+ command.query['fields'] = fields unless fields.nil?
1710
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1711
+ execute_or_queue_command(command, &block)
1712
+ end
1713
+
1714
+ # Gets an individual OauthClientCredential.
1715
+ # @param [String] name
1716
+ # Required. The name of the oauth client credential to retrieve. Format: `
1717
+ # projects/`project`/locations/`location`/oauthClients/`oauth_client`/
1718
+ # credentials/`credential``.
1719
+ # @param [String] fields
1720
+ # Selector specifying which fields to include in a partial response.
1721
+ # @param [String] quota_user
1722
+ # Available to use for quota purposes for server-side applications. Can be any
1723
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1724
+ # @param [Google::Apis::RequestOptions] options
1725
+ # Request-specific options
1726
+ #
1727
+ # @yield [result, err] Result & error if block supplied
1728
+ # @yieldparam result [Google::Apis::IamV1::OauthClientCredential] parsed result object
1729
+ # @yieldparam err [StandardError] error object if request failed
1730
+ #
1731
+ # @return [Google::Apis::IamV1::OauthClientCredential]
1732
+ #
1733
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1734
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1735
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1736
+ def get_project_location_oauth_client_credential(name, fields: nil, quota_user: nil, options: nil, &block)
1737
+ command = make_simple_command(:get, 'v1/{+name}', options)
1738
+ command.response_representation = Google::Apis::IamV1::OauthClientCredential::Representation
1739
+ command.response_class = Google::Apis::IamV1::OauthClientCredential
1740
+ command.params['name'] = name unless name.nil?
1741
+ command.query['fields'] = fields unless fields.nil?
1742
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1743
+ execute_or_queue_command(command, &block)
1744
+ end
1745
+
1746
+ # Lists all OauthClientCredentialss in a OauthClient.
1747
+ # @param [String] parent
1748
+ # Required. The parent to list oauth client credentials for.
1749
+ # @param [String] fields
1750
+ # Selector specifying which fields to include in a partial response.
1751
+ # @param [String] quota_user
1752
+ # Available to use for quota purposes for server-side applications. Can be any
1753
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1754
+ # @param [Google::Apis::RequestOptions] options
1755
+ # Request-specific options
1756
+ #
1757
+ # @yield [result, err] Result & error if block supplied
1758
+ # @yieldparam result [Google::Apis::IamV1::ListOauthClientCredentialsResponse] parsed result object
1759
+ # @yieldparam err [StandardError] error object if request failed
1760
+ #
1761
+ # @return [Google::Apis::IamV1::ListOauthClientCredentialsResponse]
1762
+ #
1763
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1764
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1765
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1766
+ def list_project_location_oauth_client_credentials(parent, fields: nil, quota_user: nil, options: nil, &block)
1767
+ command = make_simple_command(:get, 'v1/{+parent}/credentials', options)
1768
+ command.response_representation = Google::Apis::IamV1::ListOauthClientCredentialsResponse::Representation
1769
+ command.response_class = Google::Apis::IamV1::ListOauthClientCredentialsResponse
1770
+ command.params['parent'] = parent unless parent.nil?
1771
+ command.query['fields'] = fields unless fields.nil?
1772
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1773
+ execute_or_queue_command(command, &block)
1774
+ end
1775
+
1776
+ # Updates an existing OauthClientCredential.
1777
+ # @param [String] name
1778
+ # Immutable. The resource name of the oauth client credential. Format: `projects/
1779
+ # `project`/locations/`location`/oauthClients/`oauth_client`/credentials/`
1780
+ # credential``
1781
+ # @param [Google::Apis::IamV1::OauthClientCredential] oauth_client_credential_object
1782
+ # @param [String] update_mask
1783
+ # Required. The list of fields to update.
1784
+ # @param [String] fields
1785
+ # Selector specifying which fields to include in a partial response.
1786
+ # @param [String] quota_user
1787
+ # Available to use for quota purposes for server-side applications. Can be any
1788
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1789
+ # @param [Google::Apis::RequestOptions] options
1790
+ # Request-specific options
1791
+ #
1792
+ # @yield [result, err] Result & error if block supplied
1793
+ # @yieldparam result [Google::Apis::IamV1::OauthClientCredential] parsed result object
1794
+ # @yieldparam err [StandardError] error object if request failed
1795
+ #
1796
+ # @return [Google::Apis::IamV1::OauthClientCredential]
1797
+ #
1798
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1799
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1800
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1801
+ def patch_project_location_oauth_client_credential(name, oauth_client_credential_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1802
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1803
+ command.request_representation = Google::Apis::IamV1::OauthClientCredential::Representation
1804
+ command.request_object = oauth_client_credential_object
1805
+ command.response_representation = Google::Apis::IamV1::OauthClientCredential::Representation
1806
+ command.response_class = Google::Apis::IamV1::OauthClientCredential
1807
+ command.params['name'] = name unless name.nil?
1808
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1809
+ command.query['fields'] = fields unless fields.nil?
1810
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1811
+ execute_or_queue_command(command, &block)
1812
+ end
1813
+
1411
1814
  # Creates a new WorkloadIdentityPool. You cannot reuse the name of a deleted
1412
1815
  # pool until 30 days after deletion.
1413
1816
  # @param [String] parent
@@ -2207,20 +2610,20 @@ module Google
2207
2610
  # Creates a new custom Role.
2208
2611
  # @param [String] parent
2209
2612
  # The `parent` parameter's value depends on the target resource for the request,
2210
- # namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
2211
- # roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
2212
- # organizations.roles). Each resource type's `parent` value format is described
2213
- # below: * [`projects.roles.create()`](https://cloud.google.com/iam/reference/
2214
- # rest/v1/projects.roles/create): `projects/`PROJECT_ID``. This method creates
2215
- # project-level [custom roles](https://cloud.google.com/iam/docs/understanding-
2216
- # custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/`
2217
- # PROJECT_ID`/roles` * [`organizations.roles.create()`](https://cloud.google.com/
2218
- # iam/reference/rest/v1/organizations.roles/create): `organizations/`
2219
- # ORGANIZATION_ID``. This method creates organization-level [custom roles](https:
2220
- # //cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `
2221
- # https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles` Note:
2222
- # Wildcard (*) values are invalid; you must specify a complete project ID or
2223
- # organization ID.
2613
+ # namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
2614
+ # projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
2615
+ # reference/rest/v1/organizations.roles). Each resource type's `parent` value
2616
+ # format is described below: * [`projects.roles.create()`](https://cloud.google.
2617
+ # com/iam/docs/reference/rest/v1/projects.roles/create): `projects/`PROJECT_ID``.
2618
+ # This method creates project-level [custom roles](https://cloud.google.com/iam/
2619
+ # docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.
2620
+ # com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.create()`](https://
2621
+ # cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/create): `
2622
+ # organizations/`ORGANIZATION_ID``. This method creates organization-level [
2623
+ # custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
2624
+ # Example request URL: `https://iam.googleapis.com/v1/organizations/`
2625
+ # ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
2626
+ # specify a complete project ID or organization ID.
2224
2627
  # @param [Google::Apis::IamV1::CreateRoleRequest] create_role_request_object
2225
2628
  # @param [String] fields
2226
2629
  # Selector specifying which fields to include in a partial response.
@@ -2261,22 +2664,22 @@ module Google
2261
2664
  # binding is permanently removed.
2262
2665
  # @param [String] name
2263
2666
  # The `name` parameter's value depends on the target resource for the request,
2264
- # namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
2265
- # roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
2266
- # organizations.roles). Each resource type's `name` value format is described
2267
- # below: * [`projects.roles.delete()`](https://cloud.google.com/iam/reference/
2268
- # rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
2269
- # This method deletes only [custom roles](https://cloud.google.com/iam/docs/
2270
- # understanding-custom-roles) that have been created at the project level.
2271
- # Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
2272
- # roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.delete()`](https://cloud.
2273
- # google.com/iam/reference/rest/v1/organizations.roles/delete): `organizations/`
2274
- # ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes only [custom
2275
- # roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
2276
- # been created at the organization level. Example request URL: `https://iam.
2277
- # googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
2278
- # Wildcard (*) values are invalid; you must specify a complete project ID or
2279
- # organization ID.
2667
+ # namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
2668
+ # projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
2669
+ # reference/rest/v1/organizations.roles). Each resource type's `name` value
2670
+ # format is described below: * [`projects.roles.delete()`](https://cloud.google.
2671
+ # com/iam/docs/reference/rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/
2672
+ # roles/`CUSTOM_ROLE_ID``. This method deletes only [custom roles](https://cloud.
2673
+ # google.com/iam/docs/understanding-custom-roles) that have been created at the
2674
+ # project level. Example request URL: `https://iam.googleapis.com/v1/projects/`
2675
+ # PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.delete()`](https://
2676
+ # cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/delete): `
2677
+ # organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes
2678
+ # only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
2679
+ # roles) that have been created at the organization level. Example request URL: `
2680
+ # https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
2681
+ # CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
2682
+ # complete project ID or organization ID.
2280
2683
  # @param [String] etag
2281
2684
  # Used to perform a consistent read-modify-write.
2282
2685
  # @param [String] fields
@@ -2310,26 +2713,27 @@ module Google
2310
2713
  # Gets the definition of a Role.
2311
2714
  # @param [String] name
2312
2715
  # The `name` parameter's value depends on the target resource for the request,
2313
- # namely [`roles`](https://cloud.google.com/iam/reference/rest/v1/roles), [`
2314
- # projects`](https://cloud.google.com/iam/reference/rest/v1/projects.roles), or [
2315
- # `organizations`](https://cloud.google.com/iam/reference/rest/v1/organizations.
2316
- # roles). Each resource type's `name` value format is described below: * [`roles.
2317
- # get()`](https://cloud.google.com/iam/reference/rest/v1/roles/get): `roles/`
2318
- # ROLE_NAME``. This method returns results from all [predefined roles](https://
2319
- # cloud.google.com/iam/docs/understanding-roles#predefined_roles) in Cloud IAM.
2320
- # Example request URL: `https://iam.googleapis.com/v1/roles/`ROLE_NAME`` * [`
2321
- # projects.roles.get()`](https://cloud.google.com/iam/reference/rest/v1/projects.
2322
- # roles/get): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method
2323
- # returns only [custom roles](https://cloud.google.com/iam/docs/understanding-
2324
- # custom-roles) that have been created at the project level. Example request URL:
2325
- # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` *
2326
- # [`organizations.roles.get()`](https://cloud.google.com/iam/reference/rest/v1/
2327
- # organizations.roles/get): `organizations/`ORGANIZATION_ID`/roles/`
2716
+ # namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
2717
+ # projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
2718
+ # or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
2719
+ # organizations.roles). Each resource type's `name` value format is described
2720
+ # below: * [`roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/
2721
+ # roles/get): `roles/`ROLE_NAME``. This method returns results from all [
2722
+ # predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
2723
+ # predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/
2724
+ # roles/`ROLE_NAME`` * [`projects.roles.get()`](https://cloud.google.com/iam/
2725
+ # docs/reference/rest/v1/projects.roles/get): `projects/`PROJECT_ID`/roles/`
2328
2726
  # CUSTOM_ROLE_ID``. This method returns only [custom roles](https://cloud.google.
2329
- # com/iam/docs/understanding-custom-roles) that have been created at the
2330
- # organization level. Example request URL: `https://iam.googleapis.com/v1/
2331
- # organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note: Wildcard (*)
2332
- # values are invalid; you must specify a complete project ID or organization ID.
2727
+ # com/iam/docs/understanding-custom-roles) that have been created at the project
2728
+ # level. Example request URL: `https://iam.googleapis.com/v1/projects/`
2729
+ # PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.get()`](https://
2730
+ # cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `
2731
+ # organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method returns
2732
+ # only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
2733
+ # roles) that have been created at the organization level. Example request URL: `
2734
+ # https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
2735
+ # CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
2736
+ # complete project ID or organization ID.
2333
2737
  # @param [String] fields
2334
2738
  # Selector specifying which fields to include in a partial response.
2335
2739
  # @param [String] quota_user
@@ -2361,25 +2765,25 @@ module Google
2361
2765
  # defined for an organization or project.
2362
2766
  # @param [String] parent
2363
2767
  # The `parent` parameter's value depends on the target resource for the request,
2364
- # namely [`roles`](https://cloud.google.com/iam/reference/rest/v1/roles), [`
2365
- # projects`](https://cloud.google.com/iam/reference/rest/v1/projects.roles), or [
2366
- # `organizations`](https://cloud.google.com/iam/reference/rest/v1/organizations.
2367
- # roles). Each resource type's `parent` value format is described below: * [`
2368
- # roles.list()`](https://cloud.google.com/iam/reference/rest/v1/roles/list): An
2369
- # empty string. This method doesn't require a resource; it simply returns all [
2370
- # predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
2371
- # predefined_roles) in Cloud IAM. Example request URL: `https://iam.googleapis.
2372
- # com/v1/roles` * [`projects.roles.list()`](https://cloud.google.com/iam/
2373
- # reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``. This method
2374
- # lists all project-level [custom roles](https://cloud.google.com/iam/docs/
2375
- # understanding-custom-roles). Example request URL: `https://iam.googleapis.com/
2376
- # v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`](https://cloud.
2377
- # google.com/iam/reference/rest/v1/organizations.roles/list): `organizations/`
2378
- # ORGANIZATION_ID``. This method lists all organization-level [custom roles](
2379
- # https://cloud.google.com/iam/docs/understanding-custom-roles). Example request
2380
- # URL: `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles`
2381
- # Note: Wildcard (*) values are invalid; you must specify a complete project ID
2382
- # or organization ID.
2768
+ # namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
2769
+ # projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
2770
+ # or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
2771
+ # organizations.roles). Each resource type's `parent` value format is described
2772
+ # below: * [`roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/
2773
+ # roles/list): An empty string. This method doesn't require a resource; it
2774
+ # simply returns all [predefined roles](https://cloud.google.com/iam/docs/
2775
+ # understanding-roles#predefined_roles) in IAM. Example request URL: `https://
2776
+ # iam.googleapis.com/v1/roles` * [`projects.roles.list()`](https://cloud.google.
2777
+ # com/iam/docs/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``.
2778
+ # This method lists all project-level [custom roles](https://cloud.google.com/
2779
+ # iam/docs/understanding-custom-roles). Example request URL: `https://iam.
2780
+ # googleapis.com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`]
2781
+ # (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list):
2782
+ # `organizations/`ORGANIZATION_ID``. This method lists all organization-level [
2783
+ # custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
2784
+ # Example request URL: `https://iam.googleapis.com/v1/organizations/`
2785
+ # ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
2786
+ # specify a complete project ID or organization ID.
2383
2787
  # @param [Fixnum] page_size
2384
2788
  # Optional limit on the number of roles to include in the response. The default
2385
2789
  # is 300, and the maximum is 1,000.
@@ -2426,22 +2830,22 @@ module Google
2426
2830
  # Updates the definition of a custom Role.
2427
2831
  # @param [String] name
2428
2832
  # The `name` parameter's value depends on the target resource for the request,
2429
- # namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
2430
- # roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
2431
- # organizations.roles). Each resource type's `name` value format is described
2432
- # below: * [`projects.roles.patch()`](https://cloud.google.com/iam/reference/
2433
- # rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
2434
- # This method updates only [custom roles](https://cloud.google.com/iam/docs/
2435
- # understanding-custom-roles) that have been created at the project level.
2436
- # Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
2437
- # roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.patch()`](https://cloud.google.
2438
- # com/iam/reference/rest/v1/organizations.roles/patch): `organizations/`
2439
- # ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method updates only [custom
2440
- # roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
2441
- # been created at the organization level. Example request URL: `https://iam.
2442
- # googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
2443
- # Wildcard (*) values are invalid; you must specify a complete project ID or
2444
- # organization ID.
2833
+ # namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
2834
+ # projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
2835
+ # reference/rest/v1/organizations.roles). Each resource type's `name` value
2836
+ # format is described below: * [`projects.roles.patch()`](https://cloud.google.
2837
+ # com/iam/docs/reference/rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/
2838
+ # roles/`CUSTOM_ROLE_ID``. This method updates only [custom roles](https://cloud.
2839
+ # google.com/iam/docs/understanding-custom-roles) that have been created at the
2840
+ # project level. Example request URL: `https://iam.googleapis.com/v1/projects/`
2841
+ # PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.patch()`](https://
2842
+ # cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/patch): `
2843
+ # organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method updates
2844
+ # only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
2845
+ # roles) that have been created at the organization level. Example request URL: `
2846
+ # https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
2847
+ # CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
2848
+ # complete project ID or organization ID.
2445
2849
  # @param [Google::Apis::IamV1::Role] role_object
2446
2850
  # @param [String] update_mask
2447
2851
  # A mask describing which fields in the Role have changed.
@@ -2478,22 +2882,22 @@ module Google
2478
2882
  # Undeletes a custom Role.
2479
2883
  # @param [String] name
2480
2884
  # The `name` parameter's value depends on the target resource for the request,
2481
- # namely [`projects`](https://cloud.google.com/iam/reference/rest/v1/projects.
2482
- # roles) or [`organizations`](https://cloud.google.com/iam/reference/rest/v1/
2483
- # organizations.roles). Each resource type's `name` value format is described
2484
- # below: * [`projects.roles.undelete()`](https://cloud.google.com/iam/reference/
2485
- # rest/v1/projects.roles/undelete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`
2486
- # `. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/
2487
- # understanding-custom-roles) that have been created at the project level.
2488
- # Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
2489
- # roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.undelete()`](https://cloud.
2490
- # google.com/iam/reference/rest/v1/organizations.roles/undelete): `organizations/
2491
- # `ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes only [custom
2492
- # roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
2493
- # been created at the organization level. Example request URL: `https://iam.
2494
- # googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
2495
- # Wildcard (*) values are invalid; you must specify a complete project ID or
2496
- # organization ID.
2885
+ # namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
2886
+ # projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
2887
+ # reference/rest/v1/organizations.roles). Each resource type's `name` value
2888
+ # format is described below: * [`projects.roles.undelete()`](https://cloud.
2889
+ # google.com/iam/docs/reference/rest/v1/projects.roles/undelete): `projects/`
2890
+ # PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes only [custom roles](
2891
+ # https://cloud.google.com/iam/docs/understanding-custom-roles) that have been
2892
+ # created at the project level. Example request URL: `https://iam.googleapis.com/
2893
+ # v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.
2894
+ # undelete()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.
2895
+ # roles/undelete): `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``.
2896
+ # This method undeletes only [custom roles](https://cloud.google.com/iam/docs/
2897
+ # understanding-custom-roles) that have been created at the organization level.
2898
+ # Example request URL: `https://iam.googleapis.com/v1/organizations/`
2899
+ # ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid;
2900
+ # you must specify a complete project ID or organization ID.
2497
2901
  # @param [Google::Apis::IamV1::UndeleteRoleRequest] undelete_role_request_object
2498
2902
  # @param [String] fields
2499
2903
  # Selector specifying which fields to include in a partial response.
@@ -3402,6 +3806,40 @@ module Google
3402
3806
  execute_or_queue_command(command, &block)
3403
3807
  end
3404
3808
 
3809
+ # Patches a ServiceAccountKey.
3810
+ # @param [String] name
3811
+ # The resource name of the service account key in the following format `projects/
3812
+ # `PROJECT_ID`/serviceAccounts/`ACCOUNT`/keys/`key``.
3813
+ # @param [Google::Apis::IamV1::PatchServiceAccountKeyRequest] patch_service_account_key_request_object
3814
+ # @param [String] fields
3815
+ # Selector specifying which fields to include in a partial response.
3816
+ # @param [String] quota_user
3817
+ # Available to use for quota purposes for server-side applications. Can be any
3818
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3819
+ # @param [Google::Apis::RequestOptions] options
3820
+ # Request-specific options
3821
+ #
3822
+ # @yield [result, err] Result & error if block supplied
3823
+ # @yieldparam result [Google::Apis::IamV1::ServiceAccountKey] parsed result object
3824
+ # @yieldparam err [StandardError] error object if request failed
3825
+ #
3826
+ # @return [Google::Apis::IamV1::ServiceAccountKey]
3827
+ #
3828
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3829
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3830
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3831
+ def patch_service_account_key(name, patch_service_account_key_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3832
+ command = make_simple_command(:post, 'v1/{+name}:patch', options)
3833
+ command.request_representation = Google::Apis::IamV1::PatchServiceAccountKeyRequest::Representation
3834
+ command.request_object = patch_service_account_key_request_object
3835
+ command.response_representation = Google::Apis::IamV1::ServiceAccountKey::Representation
3836
+ command.response_class = Google::Apis::IamV1::ServiceAccountKey
3837
+ command.params['name'] = name unless name.nil?
3838
+ command.query['fields'] = fields unless fields.nil?
3839
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3840
+ execute_or_queue_command(command, &block)
3841
+ end
3842
+
3405
3843
  # Uploads the public key portion of a key pair that you manage, and associates
3406
3844
  # the public key with a ServiceAccount. After you upload the public key, you can
3407
3845
  # use the private key from the key pair as a service account key.
@@ -3449,26 +3887,27 @@ module Google
3449
3887
  # Gets the definition of a Role.
3450
3888
  # @param [String] name
3451
3889
  # The `name` parameter's value depends on the target resource for the request,
3452
- # namely [`roles`](https://cloud.google.com/iam/reference/rest/v1/roles), [`
3453
- # projects`](https://cloud.google.com/iam/reference/rest/v1/projects.roles), or [
3454
- # `organizations`](https://cloud.google.com/iam/reference/rest/v1/organizations.
3455
- # roles). Each resource type's `name` value format is described below: * [`roles.
3456
- # get()`](https://cloud.google.com/iam/reference/rest/v1/roles/get): `roles/`
3457
- # ROLE_NAME``. This method returns results from all [predefined roles](https://
3458
- # cloud.google.com/iam/docs/understanding-roles#predefined_roles) in Cloud IAM.
3459
- # Example request URL: `https://iam.googleapis.com/v1/roles/`ROLE_NAME`` * [`
3460
- # projects.roles.get()`](https://cloud.google.com/iam/reference/rest/v1/projects.
3461
- # roles/get): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method
3462
- # returns only [custom roles](https://cloud.google.com/iam/docs/understanding-
3463
- # custom-roles) that have been created at the project level. Example request URL:
3464
- # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` *
3465
- # [`organizations.roles.get()`](https://cloud.google.com/iam/reference/rest/v1/
3466
- # organizations.roles/get): `organizations/`ORGANIZATION_ID`/roles/`
3890
+ # namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
3891
+ # projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
3892
+ # or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
3893
+ # organizations.roles). Each resource type's `name` value format is described
3894
+ # below: * [`roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/
3895
+ # roles/get): `roles/`ROLE_NAME``. This method returns results from all [
3896
+ # predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
3897
+ # predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/
3898
+ # roles/`ROLE_NAME`` * [`projects.roles.get()`](https://cloud.google.com/iam/
3899
+ # docs/reference/rest/v1/projects.roles/get): `projects/`PROJECT_ID`/roles/`
3467
3900
  # CUSTOM_ROLE_ID``. This method returns only [custom roles](https://cloud.google.
3468
- # com/iam/docs/understanding-custom-roles) that have been created at the
3469
- # organization level. Example request URL: `https://iam.googleapis.com/v1/
3470
- # organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note: Wildcard (*)
3471
- # values are invalid; you must specify a complete project ID or organization ID.
3901
+ # com/iam/docs/understanding-custom-roles) that have been created at the project
3902
+ # level. Example request URL: `https://iam.googleapis.com/v1/projects/`
3903
+ # PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.get()`](https://
3904
+ # cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `
3905
+ # organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method returns
3906
+ # only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
3907
+ # roles) that have been created at the organization level. Example request URL: `
3908
+ # https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
3909
+ # CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
3910
+ # complete project ID or organization ID.
3472
3911
  # @param [String] fields
3473
3912
  # Selector specifying which fields to include in a partial response.
3474
3913
  # @param [String] quota_user
@@ -3505,25 +3944,25 @@ module Google
3505
3944
  # Optional pagination token returned in an earlier ListRolesResponse.
3506
3945
  # @param [String] parent
3507
3946
  # The `parent` parameter's value depends on the target resource for the request,
3508
- # namely [`roles`](https://cloud.google.com/iam/reference/rest/v1/roles), [`
3509
- # projects`](https://cloud.google.com/iam/reference/rest/v1/projects.roles), or [
3510
- # `organizations`](https://cloud.google.com/iam/reference/rest/v1/organizations.
3511
- # roles). Each resource type's `parent` value format is described below: * [`
3512
- # roles.list()`](https://cloud.google.com/iam/reference/rest/v1/roles/list): An
3513
- # empty string. This method doesn't require a resource; it simply returns all [
3514
- # predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
3515
- # predefined_roles) in Cloud IAM. Example request URL: `https://iam.googleapis.
3516
- # com/v1/roles` * [`projects.roles.list()`](https://cloud.google.com/iam/
3517
- # reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``. This method
3518
- # lists all project-level [custom roles](https://cloud.google.com/iam/docs/
3519
- # understanding-custom-roles). Example request URL: `https://iam.googleapis.com/
3520
- # v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`](https://cloud.
3521
- # google.com/iam/reference/rest/v1/organizations.roles/list): `organizations/`
3522
- # ORGANIZATION_ID``. This method lists all organization-level [custom roles](
3523
- # https://cloud.google.com/iam/docs/understanding-custom-roles). Example request
3524
- # URL: `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles`
3525
- # Note: Wildcard (*) values are invalid; you must specify a complete project ID
3526
- # or organization ID.
3947
+ # namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
3948
+ # projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
3949
+ # or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
3950
+ # organizations.roles). Each resource type's `parent` value format is described
3951
+ # below: * [`roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/
3952
+ # roles/list): An empty string. This method doesn't require a resource; it
3953
+ # simply returns all [predefined roles](https://cloud.google.com/iam/docs/
3954
+ # understanding-roles#predefined_roles) in IAM. Example request URL: `https://
3955
+ # iam.googleapis.com/v1/roles` * [`projects.roles.list()`](https://cloud.google.
3956
+ # com/iam/docs/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``.
3957
+ # This method lists all project-level [custom roles](https://cloud.google.com/
3958
+ # iam/docs/understanding-custom-roles). Example request URL: `https://iam.
3959
+ # googleapis.com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`]
3960
+ # (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list):
3961
+ # `organizations/`ORGANIZATION_ID``. This method lists all organization-level [
3962
+ # custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
3963
+ # Example request URL: `https://iam.googleapis.com/v1/organizations/`
3964
+ # ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
3965
+ # specify a complete project ID or organization ID.
3527
3966
  # @param [Boolean] show_deleted
3528
3967
  # Include Roles that have been deleted.
3529
3968
  # @param [String] view