docs: update generated docs (#1053)
Updates for both discovery docs and epydoc API Documentation
Fixes: #1049
diff --git a/docs/dyn/cloudresourcemanager_v1.liens.html b/docs/dyn/cloudresourcemanager_v1.liens.html
index 1da53d1..844e1cd 100644
--- a/docs/dyn/cloudresourcemanager_v1.liens.html
+++ b/docs/dyn/cloudresourcemanager_v1.liens.html
@@ -75,63 +75,46 @@
<h1><a href="cloudresourcemanager_v1.html">Cloud Resource Manager API</a> . <a href="cloudresourcemanager_v1.liens.html">liens</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
+ <code><a href="#close">close()</a></code></p>
+<p class="firstline">Close httplib2 connections.</p>
+<p class="toc_element">
<code><a href="#create">create(body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Create a Lien which applies to the resource denoted by the `parent` field.</p>
+<p class="firstline">Create a Lien which applies to the resource denoted by the `parent` field. Callers of this method will require permission on the `parent` resource. For example, applying to `projects/1234` requires permission `resourcemanager.projects.updateLiens`. NOTE: Some resources may limit the number of Liens which may be applied.</p>
<p class="toc_element">
<code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
-<p class="firstline">Delete a Lien by `name`.</p>
+<p class="firstline">Delete a Lien by `name`. Callers of this method will require permission on the `parent` resource. For example, a Lien with a `parent` of `projects/1234` requires permission `resourcemanager.projects.updateLiens`.</p>
<p class="toc_element">
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
-<p class="firstline">Retrieve a Lien by `name`.</p>
+<p class="firstline">Retrieve a Lien by `name`. Callers of this method will require permission on the `parent` resource. For example, a Lien with a `parent` of `projects/1234` requires permission requires permission `resourcemanager.projects.get` or `resourcemanager.projects.updateLiens`.</p>
<p class="toc_element">
- <code><a href="#list">list(pageSize=None, parent=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">List all Liens applied to the `parent` resource.</p>
+ <code><a href="#list">list(parent=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+<p class="firstline">List all Liens applied to the `parent` resource. Callers of this method will require permission on the `parent` resource. For example, a Lien with a `parent` of `projects/1234` requires permission `resourcemanager.projects.get`.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
+ <code class="details" id="close">close()</code>
+ <pre>Close httplib2 connections.</pre>
+</div>
+
+<div class="method">
<code class="details" id="create">create(body=None, x__xgafv=None)</code>
- <pre>Create a Lien which applies to the resource denoted by the `parent` field.
-
-Callers of this method will require permission on the `parent` resource.
-For example, applying to `projects/1234` requires permission
-`resourcemanager.projects.updateLiens`.
-
-NOTE: Some resources may limit the number of Liens which may be applied.
+ <pre>Create a Lien which applies to the resource denoted by the `parent` field. Callers of this method will require permission on the `parent` resource. For example, applying to `projects/1234` requires permission `resourcemanager.projects.updateLiens`. NOTE: Some resources may limit the number of Liens which may be applied.
Args:
body: object, The request body.
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'
- "createTime": "A String", # The creation time of this Lien.
- "name": "A String", # A system-generated unique identifier for this Lien.
- #
- # Example: `liens/1234abcd`
- "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 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'
+ "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'
+ "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`
+ "name": "A String", # A system-generated unique identifier for this Lien. Example: `liens/1234abcd`
+ "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",
],
- "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.
}
x__xgafv: string, V1 error format.
@@ -142,44 +125,21 @@
Returns:
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'
- "createTime": "A String", # The creation time of this Lien.
- "name": "A String", # A system-generated unique identifier for this Lien.
- #
- # Example: `liens/1234abcd`
- "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 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'
+ "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'
+ "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`
+ "name": "A String", # A system-generated unique identifier for this Lien. Example: `liens/1234abcd`
+ "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",
],
- "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>
</div>
<div class="method">
<code class="details" id="delete">delete(name, x__xgafv=None)</code>
- <pre>Delete a Lien by `name`.
-
-Callers of this method will require permission on the `parent` resource.
-For example, a Lien with a `parent` of `projects/1234` requires permission
-`resourcemanager.projects.updateLiens`.
+ <pre>Delete a Lien by `name`. Callers of this method will require permission on the `parent` resource. For example, a Lien with a `parent` of `projects/1234` requires permission `resourcemanager.projects.updateLiens`.
Args:
name: string, Required. The name/identifier of the Lien to delete. (required)
@@ -191,26 +151,13 @@
Returns:
An object of the form:
- { # A generic empty message that you can re-use to avoid defining duplicated
- # empty messages in your APIs. A typical example is to use it as the request
- # or the response type of an API method. For instance:
- #
- # service Foo {
- # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
- # }
- #
- # The JSON representation for `Empty` is empty JSON object `{}`.
+ { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
}</pre>
</div>
<div class="method">
<code class="details" id="get">get(name, x__xgafv=None)</code>
- <pre>Retrieve a Lien by `name`.
-
-Callers of this method will require permission on the `parent` resource.
-For example, a Lien with a `parent` of `projects/1234` requires permission
-requires permission `resourcemanager.projects.get` or
-`resourcemanager.projects.updateLiens`.
+ <pre>Retrieve a Lien by `name`. Callers of this method will require permission on the `parent` resource. For example, a Lien with a `parent` of `projects/1234` requires permission requires permission `resourcemanager.projects.get` or `resourcemanager.projects.updateLiens`.
Args:
name: string, Required. The name/identifier of the Lien. (required)
@@ -222,53 +169,25 @@
Returns:
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'
- "createTime": "A String", # The creation time of this Lien.
- "name": "A String", # A system-generated unique identifier for this Lien.
- #
- # Example: `liens/1234abcd`
- "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 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'
+ "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'
+ "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`
+ "name": "A String", # A system-generated unique identifier for this Lien. Example: `liens/1234abcd`
+ "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",
],
- "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>
</div>
<div class="method">
- <code class="details" id="list">list(pageSize=None, parent=None, pageToken=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.
-For example, a Lien with a `parent` of `projects/1234` requires permission
-`resourcemanager.projects.get`.
+ <code class="details" id="list">list(parent=None, pageSize=None, pageToken=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. For example, a Lien with a `parent` of `projects/1234` requires permission `resourcemanager.projects.get`.
Args:
+ 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.
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
@@ -279,37 +198,17 @@
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.
+ "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.
- { # 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'
- "createTime": "A String", # The creation time of this Lien.
- "name": "A String", # A system-generated unique identifier for this Lien.
- #
- # Example: `liens/1234abcd`
- "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 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'
+ "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'
+ "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`
+ "name": "A String", # A system-generated unique identifier for this Lien. Example: `liens/1234abcd`
+ "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",
],
- "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>