Fix method doc signatures for multiline required parameters (#374)
* Fix method doc signatures for multiline required parameters.
Existing doc generator failed to recognize parameters as required when parameter descriptions
extended over more than one line. Besides presenting incorrect information, resulting
inconsistencies broke checks for automated sample generation.
* Regen docs
diff --git a/docs/dyn/cloudresourcemanager_v1beta1.projects.html b/docs/dyn/cloudresourcemanager_v1beta1.projects.html
index 95d1923..e6f0051 100644
--- a/docs/dyn/cloudresourcemanager_v1beta1.projects.html
+++ b/docs/dyn/cloudresourcemanager_v1beta1.projects.html
@@ -78,16 +78,16 @@
<code><a href="#create">create(body, useLegacyStack=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a Project resource.</p>
<p class="toc_element">
- <code><a href="#delete">delete(projectId=None, x__xgafv=None)</a></code></p>
+ <code><a href="#delete">delete(projectId, x__xgafv=None)</a></code></p>
<p class="firstline">Marks the Project identified by the specified</p>
<p class="toc_element">
- <code><a href="#get">get(projectId=None, x__xgafv=None)</a></code></p>
+ <code><a href="#get">get(projectId, x__xgafv=None)</a></code></p>
<p class="firstline">Retrieves the Project identified by the specified</p>
<p class="toc_element">
- <code><a href="#getAncestry">getAncestry(projectId=None, body, x__xgafv=None)</a></code></p>
+ <code><a href="#getAncestry">getAncestry(projectId, body, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a list of ancestors in the resource hierarchy for the Project</p>
<p class="toc_element">
- <code><a href="#getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+ <code><a href="#getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</a></code></p>
<p class="firstline">Returns the IAM access control policy for the specified Project.</p>
<p class="toc_element">
<code><a href="#list">list(pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
@@ -96,16 +96,16 @@
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<p class="toc_element">
- <code><a href="#setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+ <code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
<p class="firstline">Sets the IAM access control policy for the specified Project. Replaces</p>
<p class="toc_element">
- <code><a href="#testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</a></code></p>
+ <code><a href="#testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</a></code></p>
<p class="firstline">Returns permissions that a caller has on the specified Project.</p>
<p class="toc_element">
- <code><a href="#undelete">undelete(projectId=None, body, x__xgafv=None)</a></code></p>
+ <code><a href="#undelete">undelete(projectId, body, x__xgafv=None)</a></code></p>
<p class="firstline">Restores the Project identified by the specified</p>
<p class="toc_element">
- <code><a href="#update">update(projectId=None, body, x__xgafv=None)</a></code></p>
+ <code><a href="#update">update(projectId, body, x__xgafv=None)</a></code></p>
<p class="firstline">Updates the attributes of the Project identified by the specified</p>
<h3>Method Details</h3>
<div class="method">
@@ -173,15 +173,15 @@
# Read-write.
"a_key": "A String",
},
- "projectNumber": "A String", # The number uniquely identifying the project.
+ "createTime": "A String", # Creation time.
#
- # Example: <code>415104041262</code>
# Read-only.
"lifecycleState": "A String", # The Project lifecycle state.
#
# Read-only.
- "createTime": "A String", # Creation time.
+ "projectNumber": "A String", # The number uniquely identifying the project.
#
+ # Example: <code>415104041262</code>
# Read-only.
}
@@ -244,21 +244,21 @@
# Read-write.
"a_key": "A String",
},
- "projectNumber": "A String", # The number uniquely identifying the project.
+ "createTime": "A String", # Creation time.
#
- # Example: <code>415104041262</code>
# Read-only.
"lifecycleState": "A String", # The Project lifecycle state.
#
# Read-only.
- "createTime": "A String", # Creation time.
+ "projectNumber": "A String", # The number uniquely identifying the project.
#
+ # Example: <code>415104041262</code>
# Read-only.
}</pre>
</div>
<div class="method">
- <code class="details" id="delete">delete(projectId=None, x__xgafv=None)</code>
+ <code class="details" id="delete">delete(projectId, x__xgafv=None)</code>
<pre>Marks the Project identified by the specified
`project_id` (for example, `my-project-123`) for deletion.
This method will only affect the Project if the following criteria are met:
@@ -309,7 +309,7 @@
</div>
<div class="method">
- <code class="details" id="get">get(projectId=None, x__xgafv=None)</code>
+ <code class="details" id="get">get(projectId, x__xgafv=None)</code>
<pre>Retrieves the Project identified by the specified
`project_id` (for example, `my-project-123`).
@@ -377,21 +377,21 @@
# Read-write.
"a_key": "A String",
},
- "projectNumber": "A String", # The number uniquely identifying the project.
+ "createTime": "A String", # Creation time.
#
- # Example: <code>415104041262</code>
# Read-only.
"lifecycleState": "A String", # The Project lifecycle state.
#
# Read-only.
- "createTime": "A String", # Creation time.
+ "projectNumber": "A String", # The number uniquely identifying the project.
#
+ # Example: <code>415104041262</code>
# Read-only.
}</pre>
</div>
<div class="method">
- <code class="details" id="getAncestry">getAncestry(projectId=None, body, x__xgafv=None)</code>
+ <code class="details" id="getAncestry">getAncestry(projectId, body, x__xgafv=None)</code>
<pre>Gets a list of ancestors in the resource hierarchy for the Project
identified by the specified `project_id` (for example, `my-project-123`).
@@ -437,7 +437,7 @@
</div>
<div class="method">
- <code class="details" id="getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</code>
+ <code class="details" id="getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</code>
<pre>Returns the IAM access control policy for the specified Project.
Permission is denied if the policy or the resource does not exist.
@@ -522,6 +522,17 @@
],
},
],
+ "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+ # prevent simultaneous updates of a policy from overwriting each other.
+ # It is strongly suggested that systems make use of the `etag` in the
+ # read-modify-write cycle to perform policy updates in order to avoid race
+ # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+ # systems are expected to put that etag in the request to `setIamPolicy` to
+ # ensure that their change will be applied to the same version of the policy.
+ #
+ # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+ # policy is overwritten blindly.
+ "version": 42, # Version of the `Policy`. The default version is 0.
"auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
{ # Specifies the audit configuration for a service.
# The configuration determines which permission types are logged, and what
@@ -605,17 +616,6 @@
# `allServices` is a special value that covers all services.
},
],
- "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
- # prevent simultaneous updates of a policy from overwriting each other.
- # It is strongly suggested that systems make use of the `etag` in the
- # read-modify-write cycle to perform policy updates in order to avoid race
- # conditions: An `etag` is returned in the response to `getIamPolicy`, and
- # systems are expected to put that etag in the request to `setIamPolicy` to
- # ensure that their change will be applied to the same version of the policy.
- #
- # If no `etag` is provided in the call to `setIamPolicy`, then the existing
- # policy is overwritten blindly.
- "version": 42, # Version of the `Policy`. The default version is 0.
}</pre>
</div>
@@ -733,15 +733,15 @@
# Read-write.
"a_key": "A String",
},
- "projectNumber": "A String", # The number uniquely identifying the project.
+ "createTime": "A String", # Creation time.
#
- # Example: <code>415104041262</code>
# Read-only.
"lifecycleState": "A String", # The Project lifecycle state.
#
# Read-only.
- "createTime": "A String", # Creation time.
+ "projectNumber": "A String", # The number uniquely identifying the project.
#
+ # Example: <code>415104041262</code>
# Read-only.
},
],
@@ -763,7 +763,7 @@
</div>
<div class="method">
- <code class="details" id="setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</code>
+ <code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
<pre>Sets the IAM access control policy for the specified Project. Replaces
any existing policy.
@@ -876,6 +876,17 @@
],
},
],
+ "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+ # prevent simultaneous updates of a policy from overwriting each other.
+ # It is strongly suggested that systems make use of the `etag` in the
+ # read-modify-write cycle to perform policy updates in order to avoid race
+ # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+ # systems are expected to put that etag in the request to `setIamPolicy` to
+ # ensure that their change will be applied to the same version of the policy.
+ #
+ # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+ # policy is overwritten blindly.
+ "version": 42, # Version of the `Policy`. The default version is 0.
"auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
{ # Specifies the audit configuration for a service.
# The configuration determines which permission types are logged, and what
@@ -959,17 +970,6 @@
# `allServices` is a special value that covers all services.
},
],
- "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
- # prevent simultaneous updates of a policy from overwriting each other.
- # It is strongly suggested that systems make use of the `etag` in the
- # read-modify-write cycle to perform policy updates in order to avoid race
- # conditions: An `etag` is returned in the response to `getIamPolicy`, and
- # systems are expected to put that etag in the request to `setIamPolicy` to
- # ensure that their change will be applied to the same version of the policy.
- #
- # If no `etag` is provided in the call to `setIamPolicy`, then the existing
- # policy is overwritten blindly.
- "version": 42, # Version of the `Policy`. The default version is 0.
},
"updateMask": "A String", # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
# the fields in the mask will be modified. If no mask is provided, the
@@ -1050,6 +1050,17 @@
],
},
],
+ "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+ # prevent simultaneous updates of a policy from overwriting each other.
+ # It is strongly suggested that systems make use of the `etag` in the
+ # read-modify-write cycle to perform policy updates in order to avoid race
+ # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+ # systems are expected to put that etag in the request to `setIamPolicy` to
+ # ensure that their change will be applied to the same version of the policy.
+ #
+ # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+ # policy is overwritten blindly.
+ "version": 42, # Version of the `Policy`. The default version is 0.
"auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
{ # Specifies the audit configuration for a service.
# The configuration determines which permission types are logged, and what
@@ -1133,22 +1144,11 @@
# `allServices` is a special value that covers all services.
},
],
- "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
- # prevent simultaneous updates of a policy from overwriting each other.
- # It is strongly suggested that systems make use of the `etag` in the
- # read-modify-write cycle to perform policy updates in order to avoid race
- # conditions: An `etag` is returned in the response to `getIamPolicy`, and
- # systems are expected to put that etag in the request to `setIamPolicy` to
- # ensure that their change will be applied to the same version of the policy.
- #
- # If no `etag` is provided in the call to `setIamPolicy`, then the existing
- # policy is overwritten blindly.
- "version": 42, # Version of the `Policy`. The default version is 0.
}</pre>
</div>
<div class="method">
- <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
+ <code class="details" id="testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</code>
<pre>Returns permissions that a caller has on the specified Project.
Args:
@@ -1183,7 +1183,7 @@
</div>
<div class="method">
- <code class="details" id="undelete">undelete(projectId=None, body, x__xgafv=None)</code>
+ <code class="details" id="undelete">undelete(projectId, body, x__xgafv=None)</code>
<pre>Restores the Project identified by the specified
`project_id` (for example, `my-project-123`).
You can only use this method for a Project that has a lifecycle state of
@@ -1224,7 +1224,7 @@
</div>
<div class="method">
- <code class="details" id="update">update(projectId=None, body, x__xgafv=None)</code>
+ <code class="details" id="update">update(projectId, body, x__xgafv=None)</code>
<pre>Updates the attributes of the Project identified by the specified
`project_id` (for example, `my-project-123`).
@@ -1287,15 +1287,15 @@
# Read-write.
"a_key": "A String",
},
- "projectNumber": "A String", # The number uniquely identifying the project.
+ "createTime": "A String", # Creation time.
#
- # Example: <code>415104041262</code>
# Read-only.
"lifecycleState": "A String", # The Project lifecycle state.
#
# Read-only.
- "createTime": "A String", # Creation time.
+ "projectNumber": "A String", # The number uniquely identifying the project.
#
+ # Example: <code>415104041262</code>
# Read-only.
}
@@ -1357,15 +1357,15 @@
# Read-write.
"a_key": "A String",
},
- "projectNumber": "A String", # The number uniquely identifying the project.
+ "createTime": "A String", # Creation time.
#
- # Example: <code>415104041262</code>
# Read-only.
"lifecycleState": "A String", # The Project lifecycle state.
#
# Read-only.
- "createTime": "A String", # Creation time.
+ "projectNumber": "A String", # The number uniquely identifying the project.
#
+ # Example: <code>415104041262</code>
# Read-only.
}</pre>
</div>