docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/iam_v1.roles.html b/docs/dyn/iam_v1.roles.html
index 8d06dfe..6ab1358 100644
--- a/docs/dyn/iam_v1.roles.html
+++ b/docs/dyn/iam_v1.roles.html
@@ -78,7 +78,7 @@
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a Role definition.</p>
<p class="toc_element">
- <code><a href="#list">list(parent=None, showDeleted=None, pageToken=None, pageSize=None, view=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(showDeleted=None, pageToken=None, pageSize=None, view=None, parent=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists the Roles defined on a resource.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -131,13 +131,6 @@
An object of the form:
{ # A role in the Identity and Access Management API.
- "name": "A String", # The name of the role.
- #
- # When Role is used in CreateRole, the role name must not be set.
- #
- # When Role is used in output and other input such as UpdateRole, the role
- # name is the complete path, e.g., roles/logging.viewer for predefined roles
- # and organizations/{ORGANIZATION_ID}/roles/logging.viewer for custom roles.
"deleted": True or False, # The current deleted state of the role. This field is read only.
# It will be ignored in calls to CreateRole and UpdateRole.
"title": "A String", # Optional. A human-readable title for the role. Typically this
@@ -150,14 +143,28 @@
"stage": "A String", # The current launch stage of the role. If the `ALPHA` launch stage has been
# selected for a role, the `stage` field will not be included in the
# returned definition for the role.
+ "name": "A String", # The name of the role.
+ #
+ # When Role is used in CreateRole, the role name must not be set.
+ #
+ # When Role is used in output and other input such as UpdateRole, the role
+ # name is the complete path, e.g., roles/logging.viewer for predefined roles
+ # and organizations/{ORGANIZATION_ID}/roles/logging.viewer for custom roles.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent=None, showDeleted=None, pageToken=None, pageSize=None, view=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(showDeleted=None, pageToken=None, pageSize=None, view=None, parent=None, x__xgafv=None)</code>
<pre>Lists the Roles defined on a resource.
Args:
+ showDeleted: boolean, Include Roles that have been deleted.
+ pageToken: string, Optional pagination token returned in an earlier ListRolesResponse.
+ pageSize: integer, Optional limit on the number of roles to include in the response.
+ view: string, Optional view for the returned Role objects. When `FULL` is specified,
+the `includedPermissions` field is returned, which includes a list of all
+permissions in the role. The default value is `BASIC`, which does not
+return the `includedPermissions` field.
parent: string, The `parent` parameter's value depends on the target resource for the
request, namely
[`roles`](/iam/reference/rest/v1/roles),
@@ -185,13 +192,6 @@
Note: Wildcard (*) values are invalid; you must specify a complete project
ID or organization ID.
- showDeleted: boolean, Include Roles that have been deleted.
- pageToken: string, Optional pagination token returned in an earlier ListRolesResponse.
- pageSize: integer, Optional limit on the number of roles to include in the response.
- view: string, Optional view for the returned Role objects. When `FULL` is specified,
-the `includedPermissions` field is returned, which includes a list of all
-permissions in the role. The default value is `BASIC`, which does not
-return the `includedPermissions` field.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -203,13 +203,6 @@
{ # The response containing the roles defined under a resource.
"roles": [ # The Roles defined on this resource.
{ # A role in the Identity and Access Management API.
- "name": "A String", # The name of the role.
- #
- # When Role is used in CreateRole, the role name must not be set.
- #
- # When Role is used in output and other input such as UpdateRole, the role
- # name is the complete path, e.g., roles/logging.viewer for predefined roles
- # and organizations/{ORGANIZATION_ID}/roles/logging.viewer for custom roles.
"deleted": True or False, # The current deleted state of the role. This field is read only.
# It will be ignored in calls to CreateRole and UpdateRole.
"title": "A String", # Optional. A human-readable title for the role. Typically this
@@ -222,6 +215,13 @@
"stage": "A String", # The current launch stage of the role. If the `ALPHA` launch stage has been
# selected for a role, the `stage` field will not be included in the
# returned definition for the role.
+ "name": "A String", # The name of the role.
+ #
+ # When Role is used in CreateRole, the role name must not be set.
+ #
+ # When Role is used in output and other input such as UpdateRole, the role
+ # name is the complete path, e.g., roles/logging.viewer for predefined roles
+ # and organizations/{ORGANIZATION_ID}/roles/logging.viewer for custom roles.
},
],
"nextPageToken": "A String", # To retrieve the next page of results, set
@@ -276,13 +276,6 @@
{ # The grantable role query response.
"roles": [ # The list of matching roles.
{ # A role in the Identity and Access Management API.
- "name": "A String", # The name of the role.
- #
- # When Role is used in CreateRole, the role name must not be set.
- #
- # When Role is used in output and other input such as UpdateRole, the role
- # name is the complete path, e.g., roles/logging.viewer for predefined roles
- # and organizations/{ORGANIZATION_ID}/roles/logging.viewer for custom roles.
"deleted": True or False, # The current deleted state of the role. This field is read only.
# It will be ignored in calls to CreateRole and UpdateRole.
"title": "A String", # Optional. A human-readable title for the role. Typically this
@@ -295,6 +288,13 @@
"stage": "A String", # The current launch stage of the role. If the `ALPHA` launch stage has been
# selected for a role, the `stage` field will not be included in the
# returned definition for the role.
+ "name": "A String", # The name of the role.
+ #
+ # When Role is used in CreateRole, the role name must not be set.
+ #
+ # When Role is used in output and other input such as UpdateRole, the role
+ # name is the complete path, e.g., roles/logging.viewer for predefined roles
+ # and organizations/{ORGANIZATION_ID}/roles/logging.viewer for custom roles.
},
],
"nextPageToken": "A String", # To retrieve the next page of results, set