docs: update generated docs (#981)
diff --git a/docs/dyn/iam_v1.iamPolicies.html b/docs/dyn/iam_v1.iamPolicies.html
index f1fff01..4746c63 100644
--- a/docs/dyn/iam_v1.iamPolicies.html
+++ b/docs/dyn/iam_v1.iamPolicies.html
@@ -76,41 +76,25 @@
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#lintPolicy">lintPolicy(body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Lints a Cloud IAM policy object or its sub fields. Currently supports</p>
+<p class="firstline">Lints, or validates, an IAM policy. Currently checks the</p>
<p class="toc_element">
<code><a href="#queryAuditableServices">queryAuditableServices(body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Returns a list of services that support service level audit logging</p>
+<p class="firstline">Returns a list of services that allow you to opt into audit logs that are</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="lintPolicy">lintPolicy(body=None, x__xgafv=None)</code>
- <pre>Lints a Cloud IAM policy object or its sub fields. Currently supports
-google.iam.v1.Binding.condition.
+ <pre>Lints, or validates, an IAM policy. Currently checks the
+google.iam.v1.Binding.condition field, which contains a condition
+expression for a role binding.
-Each lint operation consists of multiple lint validation units.
-Each unit inspects the input object in regard to a particular linting
-aspect and issues a google.iam.admin.v1.LintResult disclosing the
-result.
-
-The set of applicable validation units is determined by the Cloud IAM
-server and is not configurable.
-
-Regardless of any lint issues or their severities, successful calls to
-`lintPolicy` return an HTTP 200 OK status code.
+Successful calls to this method always return an HTTP `200 OK` status code,
+even if the linter detects an issue in the IAM policy.
Args:
body: object, The request body.
The object takes the form of:
{ # The request to lint a Cloud IAM policy object.
- "fullResourceName": "A String", # The full resource name of the policy this lint request is about.
- #
- # The name follows the Google Cloud Platform (GCP) resource format.
- # For example, a GCP project with ID `my-project` will be named
- # `//cloudresourcemanager.googleapis.com/projects/my-project`.
- #
- # The resource name is not used to read the policy instance from the Cloud
- # IAM database. The candidate policy for lint has to be provided in the same
- # request object.
"condition": { # Represents a textual expression in the Common Expression Language (CEL) # google.iam.v1.Binding.condition object to be linted.
# syntax. CEL is a C-like expression language. The syntax and semantics of CEL
# are documented at https://github.com/google/cel-spec.
@@ -144,14 +128,23 @@
# documentation for additional information.
"description": "A String", # Optional. Description of the expression. This is a longer text which
# describes the expression, e.g. when hovered over it in a UI.
+ "location": "A String", # Optional. String indicating the location of the expression for error
+ # reporting, e.g. a file name and a position in the file.
"expression": "A String", # Textual representation of an expression in Common Expression Language
# syntax.
"title": "A String", # Optional. Title for the expression, i.e. a short string describing
# its purpose. This can be used e.g. in UIs which allow to enter the
# expression.
- "location": "A String", # Optional. String indicating the location of the expression for error
- # reporting, e.g. a file name and a position in the file.
},
+ "fullResourceName": "A String", # The full resource name of the policy this lint request is about.
+ #
+ # The name follows the Google Cloud Platform (GCP) resource format.
+ # For example, a GCP project with ID `my-project` will be named
+ # `//cloudresourcemanager.googleapis.com/projects/my-project`.
+ #
+ # The resource name is not used to read the policy instance from the Cloud
+ # IAM database. The candidate policy for lint has to be provided in the same
+ # request object.
}
x__xgafv: string, V1 error format.
@@ -166,10 +159,6 @@
# the operation was able to fully execute and no lint issue was found.
"lintResults": [ # List of lint results sorted by `severity` in descending order.
{ # Structured response of a single validation unit.
- "locationOffset": 42, # 0-based character position of problematic construct within the object
- # identified by `field_name`. Currently, this is populated only for condition
- # expression.
- "debugMessage": "A String", # Human readable debug message associated with the issue.
"fieldName": "A String", # The name of the field for which this lint result is about.
#
# For nested messages `field_name` consists of names of the embedded fields
@@ -177,10 +166,14 @@
# to lint in the request. For example, the `field_name` value
# `condition.expression` identifies a lint result for the `expression` field
# of the provided condition.
- "level": "A String", # The validation unit level.
"severity": "A String", # The validation unit severity.
+ "level": "A String", # The validation unit level.
"validationUnitName": "A String", # The validation unit name, for instance
# "lintValidationUnits/ConditionComplexityCheck".
+ "debugMessage": "A String", # Human readable debug message associated with the issue.
+ "locationOffset": 42, # 0-based character position of problematic construct within the object
+ # identified by `field_name`. Currently, this is populated only for condition
+ # expression.
},
],
}</pre>
@@ -188,8 +181,11 @@
<div class="method">
<code class="details" id="queryAuditableServices">queryAuditableServices(body=None, x__xgafv=None)</code>
- <pre>Returns a list of services that support service level audit logging
-configuration for the given resource.
+ <pre>Returns a list of services that allow you to opt into audit logs that are
+not generated by default.
+
+To learn more about audit logs, see the [Logging
+documentation](https://cloud.google.com/logging/docs/audit).
Args:
body: object, The request body.