docs: docs update (#911)
Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:
- [ ] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/google-api-python-client/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea
- [ ] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [ ] Appropriate docs were updated (if necessary)
Fixes #<issue_number_goes_here> 🦕
diff --git a/docs/dyn/cloudresourcemanager_v1.liens.html b/docs/dyn/cloudresourcemanager_v1.liens.html
index 29ab1d4..5a7ea12 100644
--- a/docs/dyn/cloudresourcemanager_v1.liens.html
+++ b/docs/dyn/cloudresourcemanager_v1.liens.html
@@ -84,7 +84,7 @@
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Retrieve a Lien by `name`.</p>
<p class="toc_element">
- <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+ <code><a href="#list">list(pageToken=None, pageSize=None, parent=None, x__xgafv=None)</a></code></p>
<p class="firstline">List all Liens applied to the `parent` resource.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -105,34 +105,34 @@
The object takes the form of:
{ # A Lien represents an encumbrance on the actions that can be performed on a
- # resource.
- "origin": "A String", # A stable, user-visible/meaningful string identifying the origin of the
- # Lien, intended to be inspected programmatically. Maximum length of 200
- # characters.
- #
- # Example: 'compute.googleapis.com'
- "restrictions": [ # The types of operations which should be blocked as a result of this Lien.
- # Each value should correspond to an IAM permission. The server will
- # validate the permissions against those for which Liens are supported.
- #
- # An empty list is meaningless and will be rejected.
- #
- # Example: ['resourcemanager.projects.delete']
- "A String",
- ],
- "name": "A String", # A system-generated unique identifier for this Lien.
- #
- # Example: `liens/1234abcd`
- "parent": "A String", # A reference to the resource this Lien is attached to. The server will
- # validate the parent against those for which Liens are supported.
- #
- # Example: `projects/1234`
- "reason": "A String", # Concise user-visible strings indicating why an action cannot be performed
- # on a resource. Maximum length of 200 characters.
- #
- # Example: 'Holds production API key'
- "createTime": "A String", # The creation time of this Lien.
- }
+ # resource.
+ "parent": "A String", # A reference to the resource this Lien is attached to. The server will
+ # validate the parent against those for which Liens are supported.
+ #
+ # Example: `projects/1234`
+ "createTime": "A String", # The creation time of this Lien.
+ "name": "A String", # A system-generated unique identifier for this Lien.
+ #
+ # Example: `liens/1234abcd`
+ "reason": "A String", # Concise user-visible strings indicating why an action cannot be performed
+ # on a resource. Maximum length of 200 characters.
+ #
+ # Example: 'Holds production API key'
+ "origin": "A String", # A stable, user-visible/meaningful string identifying the origin of the
+ # Lien, intended to be inspected programmatically. Maximum length of 200
+ # characters.
+ #
+ # Example: 'compute.googleapis.com'
+ "restrictions": [ # The types of operations which should be blocked as a result of this Lien.
+ # Each value should correspond to an IAM permission. The server will
+ # validate the permissions against those for which Liens are supported.
+ #
+ # An empty list is meaningless and will be rejected.
+ #
+ # Example: ['resourcemanager.projects.delete']
+ "A String",
+ ],
+}
x__xgafv: string, V1 error format.
Allowed values
@@ -143,34 +143,34 @@
An object of the form:
{ # A Lien represents an encumbrance on the actions that can be performed on a
- # resource.
- "origin": "A String", # A stable, user-visible/meaningful string identifying the origin of the
- # Lien, intended to be inspected programmatically. Maximum length of 200
- # characters.
- #
- # Example: 'compute.googleapis.com'
- "restrictions": [ # The types of operations which should be blocked as a result of this Lien.
- # Each value should correspond to an IAM permission. The server will
- # validate the permissions against those for which Liens are supported.
- #
- # An empty list is meaningless and will be rejected.
- #
- # Example: ['resourcemanager.projects.delete']
- "A String",
- ],
- "name": "A String", # A system-generated unique identifier for this Lien.
- #
- # Example: `liens/1234abcd`
- "parent": "A String", # A reference to the resource this Lien is attached to. The server will
- # validate the parent against those for which Liens are supported.
- #
- # Example: `projects/1234`
- "reason": "A String", # Concise user-visible strings indicating why an action cannot be performed
- # on a resource. Maximum length of 200 characters.
- #
- # Example: 'Holds production API key'
- "createTime": "A String", # The creation time of this Lien.
- }</pre>
+ # resource.
+ "parent": "A String", # A reference to the resource this Lien is attached to. The server will
+ # validate the parent against those for which Liens are supported.
+ #
+ # Example: `projects/1234`
+ "createTime": "A String", # The creation time of this Lien.
+ "name": "A String", # A system-generated unique identifier for this Lien.
+ #
+ # Example: `liens/1234abcd`
+ "reason": "A String", # Concise user-visible strings indicating why an action cannot be performed
+ # on a resource. Maximum length of 200 characters.
+ #
+ # Example: 'Holds production API key'
+ "origin": "A String", # A stable, user-visible/meaningful string identifying the origin of the
+ # Lien, intended to be inspected programmatically. Maximum length of 200
+ # characters.
+ #
+ # Example: 'compute.googleapis.com'
+ "restrictions": [ # The types of operations which should be blocked as a result of this Lien.
+ # Each value should correspond to an IAM permission. The server will
+ # validate the permissions against those for which Liens are supported.
+ #
+ # An empty list is meaningless and will be rejected.
+ #
+ # Example: ['resourcemanager.projects.delete']
+ "A String",
+ ],
+ }</pre>
</div>
<div class="method">
@@ -223,38 +223,38 @@
An object of the form:
{ # A Lien represents an encumbrance on the actions that can be performed on a
- # resource.
- "origin": "A String", # A stable, user-visible/meaningful string identifying the origin of the
- # Lien, intended to be inspected programmatically. Maximum length of 200
- # characters.
- #
- # Example: 'compute.googleapis.com'
- "restrictions": [ # The types of operations which should be blocked as a result of this Lien.
- # Each value should correspond to an IAM permission. The server will
- # validate the permissions against those for which Liens are supported.
- #
- # An empty list is meaningless and will be rejected.
- #
- # Example: ['resourcemanager.projects.delete']
- "A String",
- ],
- "name": "A String", # A system-generated unique identifier for this Lien.
- #
- # Example: `liens/1234abcd`
- "parent": "A String", # A reference to the resource this Lien is attached to. The server will
- # validate the parent against those for which Liens are supported.
- #
- # Example: `projects/1234`
- "reason": "A String", # Concise user-visible strings indicating why an action cannot be performed
- # on a resource. Maximum length of 200 characters.
- #
- # Example: 'Holds production API key'
- "createTime": "A String", # The creation time of this Lien.
- }</pre>
+ # resource.
+ "parent": "A String", # A reference to the resource this Lien is attached to. The server will
+ # validate the parent against those for which Liens are supported.
+ #
+ # Example: `projects/1234`
+ "createTime": "A String", # The creation time of this Lien.
+ "name": "A String", # A system-generated unique identifier for this Lien.
+ #
+ # Example: `liens/1234abcd`
+ "reason": "A String", # Concise user-visible strings indicating why an action cannot be performed
+ # on a resource. Maximum length of 200 characters.
+ #
+ # Example: 'Holds production API key'
+ "origin": "A String", # A stable, user-visible/meaningful string identifying the origin of the
+ # Lien, intended to be inspected programmatically. Maximum length of 200
+ # characters.
+ #
+ # Example: 'compute.googleapis.com'
+ "restrictions": [ # The types of operations which should be blocked as a result of this Lien.
+ # Each value should correspond to an IAM permission. The server will
+ # validate the permissions against those for which Liens are supported.
+ #
+ # An empty list is meaningless and will be rejected.
+ #
+ # Example: ['resourcemanager.projects.delete']
+ "A String",
+ ],
+ }</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</code>
+ <code class="details" id="list">list(pageToken=None, pageSize=None, parent=None, x__xgafv=None)</code>
<pre>List all Liens applied to the `parent` resource.
Callers of this method will require permission on the `parent` resource.
@@ -262,56 +262,56 @@
`resourcemanager.projects.get`.
Args:
+ pageToken: string, The `next_page_token` value returned from a previous List request, if any.
+ pageSize: integer, The maximum number of items to return. This is a suggestion for the server.
parent: string, Required. The name of the resource to list all attached Liens.
For example, `projects/1234`.
(google.api.field_policy).resource_type annotation is not set since the
parent depends on the meta api implementation. This field could be a
project or other sub project resources.
- pageToken: string, The `next_page_token` value returned from a previous List request, if any.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
- pageSize: integer, The maximum number of items to return. This is a suggestion for the server.
Returns:
An object of the form:
{ # The response message for Liens.ListLiens.
- "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more
- # results in the list.
- "liens": [ # A list of Liens.
+ "liens": [ # A list of Liens.
{ # A Lien represents an encumbrance on the actions that can be performed on a
- # resource.
- "origin": "A String", # A stable, user-visible/meaningful string identifying the origin of the
- # Lien, intended to be inspected programmatically. Maximum length of 200
- # characters.
- #
- # Example: 'compute.googleapis.com'
- "restrictions": [ # The types of operations which should be blocked as a result of this Lien.
- # Each value should correspond to an IAM permission. The server will
- # validate the permissions against those for which Liens are supported.
- #
- # An empty list is meaningless and will be rejected.
- #
- # Example: ['resourcemanager.projects.delete']
- "A String",
- ],
- "name": "A String", # A system-generated unique identifier for this Lien.
- #
- # Example: `liens/1234abcd`
- "parent": "A String", # A reference to the resource this Lien is attached to. The server will
- # validate the parent against those for which Liens are supported.
- #
- # Example: `projects/1234`
- "reason": "A String", # Concise user-visible strings indicating why an action cannot be performed
- # on a resource. Maximum length of 200 characters.
- #
- # Example: 'Holds production API key'
- "createTime": "A String", # The creation time of this Lien.
- },
+ # resource.
+ "parent": "A String", # A reference to the resource this Lien is attached to. The server will
+ # validate the parent against those for which Liens are supported.
+ #
+ # Example: `projects/1234`
+ "createTime": "A String", # The creation time of this Lien.
+ "name": "A String", # A system-generated unique identifier for this Lien.
+ #
+ # Example: `liens/1234abcd`
+ "reason": "A String", # Concise user-visible strings indicating why an action cannot be performed
+ # on a resource. Maximum length of 200 characters.
+ #
+ # Example: 'Holds production API key'
+ "origin": "A String", # A stable, user-visible/meaningful string identifying the origin of the
+ # Lien, intended to be inspected programmatically. Maximum length of 200
+ # characters.
+ #
+ # Example: 'compute.googleapis.com'
+ "restrictions": [ # The types of operations which should be blocked as a result of this Lien.
+ # Each value should correspond to an IAM permission. The server will
+ # validate the permissions against those for which Liens are supported.
+ #
+ # An empty list is meaningless and will be rejected.
+ #
+ # Example: ['resourcemanager.projects.delete']
+ "A String",
+ ],
+ },
],
+ "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more
+ # results in the list.
}</pre>
</div>
@@ -324,7 +324,7 @@
previous_response: The response from the request for the previous page. (required)
Returns:
- A request object that you can call 'execute()' on to request the next
+ A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.
</pre>
</div>