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/logging_v2.exclusions.html b/docs/dyn/logging_v2.exclusions.html
index e9885ce..cf80024 100644
--- a/docs/dyn/logging_v2.exclusions.html
+++ b/docs/dyn/logging_v2.exclusions.html
@@ -84,7 +84,7 @@
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Gets the description of an exclusion.</p>
<p class="toc_element">
- <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists all the exclusions in a parent resource.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -99,22 +99,22 @@
Args:
parent: string, Required. The parent resource in which to create the exclusion:
-"projects/[PROJECT_ID]"
-"organizations/[ORGANIZATION_ID]"
-"billingAccounts/[BILLING_ACCOUNT_ID]"
-"folders/[FOLDER_ID]"
-Examples: "projects/my-logging-project", "organizations/123456789". (required)
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+"billingAccounts/[BILLING_ACCOUNT_ID]"
+"folders/[FOLDER_ID]"
+Examples: "projects/my-logging-project", "organizations/123456789". (required)
body: object, The request body.
The object takes the form of:
-{ # Specifies a set of log entries that are not to be stored in Logging. If your GCP resource receives a large volume of logs, you can use exclusions to reduce your chargeable logs. Exclusions are processed after log sinks, so you can export log entries before they are excluded. Note that organization-level and folder-level exclusions don't apply to child resources, and that you can't exclude audit log entries.
- "disabled": True or False, # Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.
- "updateTime": "A String", # Output only. The last update timestamp of the exclusion.This field may not be present for older exclusions.
- "name": "A String", # Required. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
- "filter": "A String", # Required. An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"
- "createTime": "A String", # Output only. The creation timestamp of the exclusion.This field may not be present for older exclusions.
- "description": "A String", # Optional. A description of this exclusion.
- }
+{ # Specifies a set of log entries that are not to be stored in Logging. If your GCP resource receives a large volume of logs, you can use exclusions to reduce your chargeable logs. Exclusions are processed after log sinks, so you can export log entries before they are excluded. Note that organization-level and folder-level exclusions don't apply to child resources, and that you can't exclude audit log entries.
+ "filter": "A String", # Required. An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced-queries) that matches the log entries to be excluded. By using the sample function (https://cloud.google.com/logging/docs/view/advanced-queries#sample), you can exclude less than 100% of the matching log entries. For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"
+ "description": "A String", # Optional. A description of this exclusion.
+ "disabled": True or False, # Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.
+ "createTime": "A String", # Output only. The creation timestamp of the exclusion.This field may not be present for older exclusions.
+ "updateTime": "A String", # Output only. The last update timestamp of the exclusion.This field may not be present for older exclusions.
+ "name": "A String", # Required. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
+}
x__xgafv: string, V1 error format.
Allowed values
@@ -124,14 +124,14 @@
Returns:
An object of the form:
- { # Specifies a set of log entries that are not to be stored in Logging. If your GCP resource receives a large volume of logs, you can use exclusions to reduce your chargeable logs. Exclusions are processed after log sinks, so you can export log entries before they are excluded. Note that organization-level and folder-level exclusions don't apply to child resources, and that you can't exclude audit log entries.
- "disabled": True or False, # Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.
- "updateTime": "A String", # Output only. The last update timestamp of the exclusion.This field may not be present for older exclusions.
- "name": "A String", # Required. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
- "filter": "A String", # Required. An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"
- "createTime": "A String", # Output only. The creation timestamp of the exclusion.This field may not be present for older exclusions.
- "description": "A String", # Optional. A description of this exclusion.
- }</pre>
+ { # Specifies a set of log entries that are not to be stored in Logging. If your GCP resource receives a large volume of logs, you can use exclusions to reduce your chargeable logs. Exclusions are processed after log sinks, so you can export log entries before they are excluded. Note that organization-level and folder-level exclusions don't apply to child resources, and that you can't exclude audit log entries.
+ "filter": "A String", # Required. An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced-queries) that matches the log entries to be excluded. By using the sample function (https://cloud.google.com/logging/docs/view/advanced-queries#sample), you can exclude less than 100% of the matching log entries. For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"
+ "description": "A String", # Optional. A description of this exclusion.
+ "disabled": True or False, # Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.
+ "createTime": "A String", # Output only. The creation timestamp of the exclusion.This field may not be present for older exclusions.
+ "updateTime": "A String", # Output only. The last update timestamp of the exclusion.This field may not be present for older exclusions.
+ "name": "A String", # Required. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
+ }</pre>
</div>
<div class="method">
@@ -140,11 +140,11 @@
Args:
name: string, Required. The resource name of an existing exclusion to delete:
-"projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
-"organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
-"billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
-"folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
-Example: "projects/my-project-id/exclusions/my-exclusion-id". (required)
+"projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+"organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+"billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+"folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+Example: "projects/my-project-id/exclusions/my-exclusion-id". (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -167,11 +167,11 @@
Args:
name: string, Required. The resource name of an existing exclusion:
-"projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
-"organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
-"billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
-"folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
-Example: "projects/my-project-id/exclusions/my-exclusion-id". (required)
+"projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+"organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+"billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+"folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+Example: "projects/my-project-id/exclusions/my-exclusion-id". (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -180,29 +180,29 @@
Returns:
An object of the form:
- { # Specifies a set of log entries that are not to be stored in Logging. If your GCP resource receives a large volume of logs, you can use exclusions to reduce your chargeable logs. Exclusions are processed after log sinks, so you can export log entries before they are excluded. Note that organization-level and folder-level exclusions don't apply to child resources, and that you can't exclude audit log entries.
- "disabled": True or False, # Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.
- "updateTime": "A String", # Output only. The last update timestamp of the exclusion.This field may not be present for older exclusions.
- "name": "A String", # Required. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
- "filter": "A String", # Required. An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"
- "createTime": "A String", # Output only. The creation timestamp of the exclusion.This field may not be present for older exclusions.
- "description": "A String", # Optional. A description of this exclusion.
- }</pre>
+ { # Specifies a set of log entries that are not to be stored in Logging. If your GCP resource receives a large volume of logs, you can use exclusions to reduce your chargeable logs. Exclusions are processed after log sinks, so you can export log entries before they are excluded. Note that organization-level and folder-level exclusions don't apply to child resources, and that you can't exclude audit log entries.
+ "filter": "A String", # Required. An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced-queries) that matches the log entries to be excluded. By using the sample function (https://cloud.google.com/logging/docs/view/advanced-queries#sample), you can exclude less than 100% of the matching log entries. For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"
+ "description": "A String", # Optional. A description of this exclusion.
+ "disabled": True or False, # Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.
+ "createTime": "A String", # Output only. The creation timestamp of the exclusion.This field may not be present for older exclusions.
+ "updateTime": "A String", # Output only. The last update timestamp of the exclusion.This field may not be present for older exclusions.
+ "name": "A String", # Required. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
+ }</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</code>
<pre>Lists all the exclusions in a parent resource.
Args:
parent: string, Required. The parent resource whose exclusions are to be listed.
-"projects/[PROJECT_ID]"
-"organizations/[ORGANIZATION_ID]"
-"billingAccounts/[BILLING_ACCOUNT_ID]"
-"folders/[FOLDER_ID]"
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+"billingAccounts/[BILLING_ACCOUNT_ID]"
+"folders/[FOLDER_ID]"
(required)
- pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+ pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -212,17 +212,17 @@
An object of the form:
{ # Result returned from ListExclusions.
- "nextPageToken": "A String", # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call the same method again using the value of nextPageToken as pageToken.
- "exclusions": [ # A list of exclusions.
- { # Specifies a set of log entries that are not to be stored in Logging. If your GCP resource receives a large volume of logs, you can use exclusions to reduce your chargeable logs. Exclusions are processed after log sinks, so you can export log entries before they are excluded. Note that organization-level and folder-level exclusions don't apply to child resources, and that you can't exclude audit log entries.
- "disabled": True or False, # Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.
- "updateTime": "A String", # Output only. The last update timestamp of the exclusion.This field may not be present for older exclusions.
- "name": "A String", # Required. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
- "filter": "A String", # Required. An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"
- "createTime": "A String", # Output only. The creation timestamp of the exclusion.This field may not be present for older exclusions.
- "description": "A String", # Optional. A description of this exclusion.
- },
+ "exclusions": [ # A list of exclusions.
+ { # Specifies a set of log entries that are not to be stored in Logging. If your GCP resource receives a large volume of logs, you can use exclusions to reduce your chargeable logs. Exclusions are processed after log sinks, so you can export log entries before they are excluded. Note that organization-level and folder-level exclusions don't apply to child resources, and that you can't exclude audit log entries.
+ "filter": "A String", # Required. An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced-queries) that matches the log entries to be excluded. By using the sample function (https://cloud.google.com/logging/docs/view/advanced-queries#sample), you can exclude less than 100% of the matching log entries. For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"
+ "description": "A String", # Optional. A description of this exclusion.
+ "disabled": True or False, # Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.
+ "createTime": "A String", # Output only. The creation timestamp of the exclusion.This field may not be present for older exclusions.
+ "updateTime": "A String", # Output only. The last update timestamp of the exclusion.This field may not be present for older exclusions.
+ "name": "A String", # Required. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
+ },
],
+ "nextPageToken": "A String", # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call the same method again using the value of nextPageToken as pageToken.
}</pre>
</div>
@@ -235,7 +235,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>
@@ -246,24 +246,24 @@
Args:
name: string, Required. The resource name of the exclusion to update:
-"projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
-"organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
-"billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
-"folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
-Example: "projects/my-project-id/exclusions/my-exclusion-id". (required)
+"projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+"organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+"billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+"folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+Example: "projects/my-project-id/exclusions/my-exclusion-id". (required)
body: object, The request body.
The object takes the form of:
-{ # Specifies a set of log entries that are not to be stored in Logging. If your GCP resource receives a large volume of logs, you can use exclusions to reduce your chargeable logs. Exclusions are processed after log sinks, so you can export log entries before they are excluded. Note that organization-level and folder-level exclusions don't apply to child resources, and that you can't exclude audit log entries.
- "disabled": True or False, # Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.
- "updateTime": "A String", # Output only. The last update timestamp of the exclusion.This field may not be present for older exclusions.
- "name": "A String", # Required. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
- "filter": "A String", # Required. An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"
- "createTime": "A String", # Output only. The creation timestamp of the exclusion.This field may not be present for older exclusions.
- "description": "A String", # Optional. A description of this exclusion.
- }
+{ # Specifies a set of log entries that are not to be stored in Logging. If your GCP resource receives a large volume of logs, you can use exclusions to reduce your chargeable logs. Exclusions are processed after log sinks, so you can export log entries before they are excluded. Note that organization-level and folder-level exclusions don't apply to child resources, and that you can't exclude audit log entries.
+ "filter": "A String", # Required. An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced-queries) that matches the log entries to be excluded. By using the sample function (https://cloud.google.com/logging/docs/view/advanced-queries#sample), you can exclude less than 100% of the matching log entries. For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"
+ "description": "A String", # Optional. A description of this exclusion.
+ "disabled": True or False, # Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.
+ "createTime": "A String", # Output only. The creation timestamp of the exclusion.This field may not be present for older exclusions.
+ "updateTime": "A String", # Output only. The last update timestamp of the exclusion.This field may not be present for older exclusions.
+ "name": "A String", # Required. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
+}
- updateMask: string, Required. A non-empty list of fields to change in the existing exclusion. New values for the fields are taken from the corresponding fields in the LogExclusion included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.For example, to change the filter and description of an exclusion, specify an update_mask of "filter,description".
+ updateMask: string, Required. A non-empty list of fields to change in the existing exclusion. New values for the fields are taken from the corresponding fields in the LogExclusion included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.For example, to change the filter and description of an exclusion, specify an update_mask of "filter,description".
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -272,14 +272,14 @@
Returns:
An object of the form:
- { # Specifies a set of log entries that are not to be stored in Logging. If your GCP resource receives a large volume of logs, you can use exclusions to reduce your chargeable logs. Exclusions are processed after log sinks, so you can export log entries before they are excluded. Note that organization-level and folder-level exclusions don't apply to child resources, and that you can't exclude audit log entries.
- "disabled": True or False, # Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.
- "updateTime": "A String", # Output only. The last update timestamp of the exclusion.This field may not be present for older exclusions.
- "name": "A String", # Required. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
- "filter": "A String", # Required. An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"
- "createTime": "A String", # Output only. The creation timestamp of the exclusion.This field may not be present for older exclusions.
- "description": "A String", # Optional. A description of this exclusion.
- }</pre>
+ { # Specifies a set of log entries that are not to be stored in Logging. If your GCP resource receives a large volume of logs, you can use exclusions to reduce your chargeable logs. Exclusions are processed after log sinks, so you can export log entries before they are excluded. Note that organization-level and folder-level exclusions don't apply to child resources, and that you can't exclude audit log entries.
+ "filter": "A String", # Required. An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced-queries) that matches the log entries to be excluded. By using the sample function (https://cloud.google.com/logging/docs/view/advanced-queries#sample), you can exclude less than 100% of the matching log entries. For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"
+ "description": "A String", # Optional. A description of this exclusion.
+ "disabled": True or False, # Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.
+ "createTime": "A String", # Output only. The creation timestamp of the exclusion.This field may not be present for older exclusions.
+ "updateTime": "A String", # Output only. The last update timestamp of the exclusion.This field may not be present for older exclusions.
+ "name": "A String", # Required. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
+ }</pre>
</div>
</body></html>
\ No newline at end of file