From 98b61cbb06e339b885ff63a2ce56b4340e04e30d Mon Sep 17 00:00:00 2001 From: yoshi-code-bot <70984784+yoshi-code-bot@users.noreply.github.com> Date: Fri, 6 Feb 2026 18:23:46 -0800 Subject: [PATCH] chore: regenerate logging client --- .../v2/2.0.0/README.md | 4 +- .../api/services/logging/v2/Logging.java | 473 ++++++++++-------- .../logging/v2/model/BigQueryOptions.java | 30 +- .../logging/v2/model/CmekSettings.java | 34 +- .../logging/v2/model/DefaultSinkConfig.java | 33 +- .../logging/v2/model/FieldSource.java | 241 +++++++++ .../logging/v2/model/FilterExpression.java | 165 ++++++ .../logging/v2/model/FilterPredicate.java | 123 +++++ .../logging/v2/model/FunctionApplication.java | 112 +++++ .../logging/v2/model/IndexConfig.java | 6 +- .../services/logging/v2/model/LogBucket.java | 18 +- .../services/logging/v2/model/LogEntry.java | 108 ++-- .../logging/v2/model/LogExclusion.java | 33 +- .../services/logging/v2/model/LogSink.java | 51 +- .../logging/v2/model/LoggingQuery.java | 12 +- .../logging/v2/model/OpsAnalyticsQuery.java | 48 +- .../logging/v2/model/ProjectedField.java | 259 ++++++++++ .../logging/v2/model/QueryBuilderConfig.java | 213 ++++++++ .../logging/v2/model/RecentQuery.java | 6 +- .../services/logging/v2/model/SavedQuery.java | 18 +- .../services/logging/v2/model/Settings.java | 30 +- .../logging/v2/model/SortOrderParameter.java | 93 ++++ .../logging/v2/model/SummaryField.java | 4 +- .../v2/2.0.0/pom.xml | 4 +- .../google-api-services-logging/v2/README.md | 4 +- 25 files changed, 1711 insertions(+), 411 deletions(-) create mode 100644 clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FieldSource.java create mode 100644 clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FilterExpression.java create mode 100644 clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FilterPredicate.java create mode 100644 clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FunctionApplication.java create mode 100644 clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/ProjectedField.java create mode 100644 clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/QueryBuilderConfig.java create mode 100644 clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/SortOrderParameter.java diff --git a/clients/google-api-services-logging/v2/2.0.0/README.md b/clients/google-api-services-logging/v2/2.0.0/README.md index f4c9638f52e..c313f4dd701 100644 --- a/clients/google-api-services-logging/v2/2.0.0/README.md +++ b/clients/google-api-services-logging/v2/2.0.0/README.md @@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file: com.google.apis google-api-services-logging - v2-rev20260116-2.0.0 + v2-rev20260130-2.0.0 @@ -35,7 +35,7 @@ repositories { mavenCentral() } dependencies { - implementation 'com.google.apis:google-api-services-logging:v2-rev20260116-2.0.0' + implementation 'com.google.apis:google-api-services-logging:v2-rev20260130-2.0.0' } ``` diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/Logging.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/Logging.java index 47afbd25a94..881fbfeca71 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/Logging.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/Logging.java @@ -157,8 +157,8 @@ public class BillingAccounts { * Gets the Logging CMEK settings for the given resource.Note: CMEK for the Log Router can be * configured for Google Cloud projects, folders, organizations, and billing accounts. Once * configured for an organization, it applies to all projects and folders in the Google Cloud - * organization.See Enabling CMEK for Log Router - * (https://cloud.google.com/logging/docs/routing/managed-encryption) for more information. + * organization.See Configure CMEK for Cloud Logging + * (https://docs.cloud.google.com/logging/docs/routing/managed-encryption) for more information. * * Create a request for the method "billingAccounts.getCmekSettings". * @@ -191,8 +191,8 @@ public class GetCmekSettings extends LoggingRequest This is the Java data model class that specifies how to parse/serialize into the JSON that is * transmitted over HTTP when working with the Cloud Logging API. For a detailed explanation see: @@ -44,8 +44,8 @@ public final class CmekSettings extends com.google.api.client.json.GenericJson { * operations that are in progress will be completed with the key that was in use when they * started. Decryption operations will be completed using the key that was used at the time of * encryption unless access to that key has been revoked.To disable CMEK for the Log Router, set - * this field to an empty string.See Enabling CMEK for Log Router - * (https://cloud.google.com/logging/docs/routing/managed-encryption) for more information. + * this field to an empty string.See Configure CMEK for Cloud Logging + * (https://docs.cloud.google.com/logging/docs/routing/managed-encryption) for more information. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -75,9 +75,9 @@ public final class CmekSettings extends com.google.api.client.json.GenericJson { * Output only. The service account that will be used by the Log Router to access your Cloud KMS * key.Before enabling CMEK for Log Router, you must first assign the * cloudkms.cryptoKeyEncrypterDecrypter role to the service account that the Log Router will use - * to access your Cloud KMS key. Use GetCmekSettings to obtain the service account ID.See Enabling - * CMEK for Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for more - * information. + * to access your Cloud KMS key. Use GetCmekSettings to obtain the service account ID.See + * Configure CMEK for Cloud Logging (https://docs.cloud.google.com/logging/docs/routing/managed- + * encryption) for more information. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -94,8 +94,8 @@ public final class CmekSettings extends com.google.api.client.json.GenericJson { * operations that are in progress will be completed with the key that was in use when they * started. Decryption operations will be completed using the key that was used at the time of * encryption unless access to that key has been revoked.To disable CMEK for the Log Router, set - * this field to an empty string.See Enabling CMEK for Log Router - * (https://cloud.google.com/logging/docs/routing/managed-encryption) for more information. + * this field to an empty string.See Configure CMEK for Cloud Logging + * (https://docs.cloud.google.com/logging/docs/routing/managed-encryption) for more information. * @return value or {@code null} for none */ public java.lang.String getKmsKeyName() { @@ -113,8 +113,8 @@ public java.lang.String getKmsKeyName() { * operations that are in progress will be completed with the key that was in use when they * started. Decryption operations will be completed using the key that was used at the time of * encryption unless access to that key has been revoked.To disable CMEK for the Log Router, set - * this field to an empty string.See Enabling CMEK for Log Router - * (https://cloud.google.com/logging/docs/routing/managed-encryption) for more information. + * this field to an empty string.See Configure CMEK for Cloud Logging + * (https://docs.cloud.google.com/logging/docs/routing/managed-encryption) for more information. * @param kmsKeyName kmsKeyName or {@code null} for none */ public CmekSettings setKmsKeyName(java.lang.String kmsKeyName) { @@ -172,9 +172,9 @@ public CmekSettings setName(java.lang.String name) { * Output only. The service account that will be used by the Log Router to access your Cloud KMS * key.Before enabling CMEK for Log Router, you must first assign the * cloudkms.cryptoKeyEncrypterDecrypter role to the service account that the Log Router will use - * to access your Cloud KMS key. Use GetCmekSettings to obtain the service account ID.See Enabling - * CMEK for Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for more - * information. + * to access your Cloud KMS key. Use GetCmekSettings to obtain the service account ID.See + * Configure CMEK for Cloud Logging (https://docs.cloud.google.com/logging/docs/routing/managed- + * encryption) for more information. * @return value or {@code null} for none */ public java.lang.String getServiceAccountId() { @@ -185,9 +185,9 @@ public java.lang.String getServiceAccountId() { * Output only. The service account that will be used by the Log Router to access your Cloud KMS * key.Before enabling CMEK for Log Router, you must first assign the * cloudkms.cryptoKeyEncrypterDecrypter role to the service account that the Log Router will use - * to access your Cloud KMS key. Use GetCmekSettings to obtain the service account ID.See Enabling - * CMEK for Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for more - * information. + * to access your Cloud KMS key. Use GetCmekSettings to obtain the service account ID.See + * Configure CMEK for Cloud Logging (https://docs.cloud.google.com/logging/docs/routing/managed- + * encryption) for more information. * @param serviceAccountId serviceAccountId or {@code null} for none */ public CmekSettings setServiceAccountId(java.lang.String serviceAccountId) { diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/DefaultSinkConfig.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/DefaultSinkConfig.java index a28bf9cdb3f..ee2ba9672cc 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/DefaultSinkConfig.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/DefaultSinkConfig.java @@ -39,11 +39,12 @@ public final class DefaultSinkConfig extends com.google.api.client.json.GenericJ private java.util.List exclusions; /** - * Optional. An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced- - * queries). The only exported log entries are those that are in the resource owning the sink and - * that match the filter.For example:logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND - * severity>=ERRORTo match all logs, don't add exclusions and use the following line as the value - * of filter:logName:*Cannot be empty or unset when the value of mode is OVERWRITE. + * Optional. An advanced logs filter (https://docs.cloud.google.com/logging/docs/view/building- + * queries#queries-by-expression). The only exported log entries are those that are in the + * resource owning the sink and that match the filter.For + * example:logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERRORTo match all logs, + * don't add exclusions and use the following line as the value of filter:logName:*Cannot be empty + * or unset when the value of mode is OVERWRITE. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -77,11 +78,12 @@ public DefaultSinkConfig setExclusions(java.util.List exclusions) } /** - * Optional. An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced- - * queries). The only exported log entries are those that are in the resource owning the sink and - * that match the filter.For example:logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND - * severity>=ERRORTo match all logs, don't add exclusions and use the following line as the value - * of filter:logName:*Cannot be empty or unset when the value of mode is OVERWRITE. + * Optional. An advanced logs filter (https://docs.cloud.google.com/logging/docs/view/building- + * queries#queries-by-expression). The only exported log entries are those that are in the + * resource owning the sink and that match the filter.For + * example:logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERRORTo match all logs, + * don't add exclusions and use the following line as the value of filter:logName:*Cannot be empty + * or unset when the value of mode is OVERWRITE. * @return value or {@code null} for none */ public java.lang.String getFilter() { @@ -89,11 +91,12 @@ public java.lang.String getFilter() { } /** - * Optional. An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced- - * queries). The only exported log entries are those that are in the resource owning the sink and - * that match the filter.For example:logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND - * severity>=ERRORTo match all logs, don't add exclusions and use the following line as the value - * of filter:logName:*Cannot be empty or unset when the value of mode is OVERWRITE. + * Optional. An advanced logs filter (https://docs.cloud.google.com/logging/docs/view/building- + * queries#queries-by-expression). The only exported log entries are those that are in the + * resource owning the sink and that match the filter.For + * example:logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERRORTo match all logs, + * don't add exclusions and use the following line as the value of filter:logName:*Cannot be empty + * or unset when the value of mode is OVERWRITE. * @param filter filter or {@code null} for none */ public DefaultSinkConfig setFilter(java.lang.String filter) { diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FieldSource.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FieldSource.java new file mode 100644 index 00000000000..c52731b3b27 --- /dev/null +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FieldSource.java @@ -0,0 +1,241 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except + * in compliance with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software distributed under the License + * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express + * or implied. See the License for the specific language governing permissions and limitations under + * the License. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.logging.v2.model; + +/** + * A source that can be used to represent a field within various parts of a structured query, such + * as in SELECT, WHERE, or ORDER BY clauses. + * + *

This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Cloud Logging API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

+ * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class FieldSource extends com.google.api.client.json.GenericJson { + + /** + * The alias name for a field that has already been aliased within a different ProjectedField type + * elsewhere in the query model. The alias must be defined in the QueryBuilderConfig's + * field_sources list, otherwise the model is invalid. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String aliasRef; + + /** + * The type of the selected field. This comes from the schema. Can be one of the BigQuery data + * types: - STRING - INT64 - FLOAT64 - BOOL - TIMESTAMP - DATE - RECORD - JSON + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String columnType; + + /** + * The fully qualified, dot-delimited path to the selected atomic field (the leaf value). This + * path is used for primary selection and actions like drill-down or projection.The path + * components should match the exact field names or keys as they appear in the underlying data + * schema. For JSON fields, this means respecting the original casing (e.g., camelCase or + * snake_case as present in the JSON).To reference field names containing special characters + * (e.g., hyphens, spaces), enclose the individual path segment in backticks (`).Examples: * + * json_payload.labels.message * json_payload.request_id * httpRequest.status * json_payload.\my- + * custom-field`.value *jsonPayload.`my key with spaces`.data` + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String field; + + /** + * Whether the field is a JSON field, or has a parent that is a JSON field. This value is used to + * determine JSON extractions in generated SQL queries. Note that this is_json flag may be true + * when the column_type is not JSON if the parent is a JSON field. Ex: - A json_payload.message + * field might have is_json=true, since the 'json_payload' parent is of type JSON, and + * columnType='STRING' if the 'message' field is of type STRING. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.Boolean isJson; + + /** + * The dot-delimited path of the parent container that holds the target field.This path defines + * the structural hierarchy and is essential for correctly generating SQL when field keys contain + * special characters (e.g., dots or brackets).Example: json_payload.labels (This points to the + * 'labels' object). This is an empty string if the target field is at the root level. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String parentPath; + + /** + * A projected field option for when a user wants to use a field with some additional + * transformations such as casting or extractions. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private ProjectedField projectedField; + + /** + * The alias name for a field that has already been aliased within a different ProjectedField type + * elsewhere in the query model. The alias must be defined in the QueryBuilderConfig's + * field_sources list, otherwise the model is invalid. + * @return value or {@code null} for none + */ + public java.lang.String getAliasRef() { + return aliasRef; + } + + /** + * The alias name for a field that has already been aliased within a different ProjectedField type + * elsewhere in the query model. The alias must be defined in the QueryBuilderConfig's + * field_sources list, otherwise the model is invalid. + * @param aliasRef aliasRef or {@code null} for none + */ + public FieldSource setAliasRef(java.lang.String aliasRef) { + this.aliasRef = aliasRef; + return this; + } + + /** + * The type of the selected field. This comes from the schema. Can be one of the BigQuery data + * types: - STRING - INT64 - FLOAT64 - BOOL - TIMESTAMP - DATE - RECORD - JSON + * @return value or {@code null} for none + */ + public java.lang.String getColumnType() { + return columnType; + } + + /** + * The type of the selected field. This comes from the schema. Can be one of the BigQuery data + * types: - STRING - INT64 - FLOAT64 - BOOL - TIMESTAMP - DATE - RECORD - JSON + * @param columnType columnType or {@code null} for none + */ + public FieldSource setColumnType(java.lang.String columnType) { + this.columnType = columnType; + return this; + } + + /** + * The fully qualified, dot-delimited path to the selected atomic field (the leaf value). This + * path is used for primary selection and actions like drill-down or projection.The path + * components should match the exact field names or keys as they appear in the underlying data + * schema. For JSON fields, this means respecting the original casing (e.g., camelCase or + * snake_case as present in the JSON).To reference field names containing special characters + * (e.g., hyphens, spaces), enclose the individual path segment in backticks (`).Examples: * + * json_payload.labels.message * json_payload.request_id * httpRequest.status * json_payload.\my- + * custom-field`.value *jsonPayload.`my key with spaces`.data` + * @return value or {@code null} for none + */ + public java.lang.String getField() { + return field; + } + + /** + * The fully qualified, dot-delimited path to the selected atomic field (the leaf value). This + * path is used for primary selection and actions like drill-down or projection.The path + * components should match the exact field names or keys as they appear in the underlying data + * schema. For JSON fields, this means respecting the original casing (e.g., camelCase or + * snake_case as present in the JSON).To reference field names containing special characters + * (e.g., hyphens, spaces), enclose the individual path segment in backticks (`).Examples: * + * json_payload.labels.message * json_payload.request_id * httpRequest.status * json_payload.\my- + * custom-field`.value *jsonPayload.`my key with spaces`.data` + * @param field field or {@code null} for none + */ + public FieldSource setField(java.lang.String field) { + this.field = field; + return this; + } + + /** + * Whether the field is a JSON field, or has a parent that is a JSON field. This value is used to + * determine JSON extractions in generated SQL queries. Note that this is_json flag may be true + * when the column_type is not JSON if the parent is a JSON field. Ex: - A json_payload.message + * field might have is_json=true, since the 'json_payload' parent is of type JSON, and + * columnType='STRING' if the 'message' field is of type STRING. + * @return value or {@code null} for none + */ + public java.lang.Boolean getIsJson() { + return isJson; + } + + /** + * Whether the field is a JSON field, or has a parent that is a JSON field. This value is used to + * determine JSON extractions in generated SQL queries. Note that this is_json flag may be true + * when the column_type is not JSON if the parent is a JSON field. Ex: - A json_payload.message + * field might have is_json=true, since the 'json_payload' parent is of type JSON, and + * columnType='STRING' if the 'message' field is of type STRING. + * @param isJson isJson or {@code null} for none + */ + public FieldSource setIsJson(java.lang.Boolean isJson) { + this.isJson = isJson; + return this; + } + + /** + * The dot-delimited path of the parent container that holds the target field.This path defines + * the structural hierarchy and is essential for correctly generating SQL when field keys contain + * special characters (e.g., dots or brackets).Example: json_payload.labels (This points to the + * 'labels' object). This is an empty string if the target field is at the root level. + * @return value or {@code null} for none + */ + public java.lang.String getParentPath() { + return parentPath; + } + + /** + * The dot-delimited path of the parent container that holds the target field.This path defines + * the structural hierarchy and is essential for correctly generating SQL when field keys contain + * special characters (e.g., dots or brackets).Example: json_payload.labels (This points to the + * 'labels' object). This is an empty string if the target field is at the root level. + * @param parentPath parentPath or {@code null} for none + */ + public FieldSource setParentPath(java.lang.String parentPath) { + this.parentPath = parentPath; + return this; + } + + /** + * A projected field option for when a user wants to use a field with some additional + * transformations such as casting or extractions. + * @return value or {@code null} for none + */ + public ProjectedField getProjectedField() { + return projectedField; + } + + /** + * A projected field option for when a user wants to use a field with some additional + * transformations such as casting or extractions. + * @param projectedField projectedField or {@code null} for none + */ + public FieldSource setProjectedField(ProjectedField projectedField) { + this.projectedField = projectedField; + return this; + } + + @Override + public FieldSource set(String fieldName, Object value) { + return (FieldSource) super.set(fieldName, value); + } + + @Override + public FieldSource clone() { + return (FieldSource) super.clone(); + } + +} diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FilterExpression.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FilterExpression.java new file mode 100644 index 00000000000..8670bbbf8e1 --- /dev/null +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FilterExpression.java @@ -0,0 +1,165 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except + * in compliance with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software distributed under the License + * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express + * or implied. See the License for the specific language governing permissions and limitations under + * the License. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.logging.v2.model; + +/** + * This is a leaf of the FilterPredicate. Ex: { field: json_payload.message.error_code, + * filter_value: {numeric_value: 400}, comparator: EQUAL_TO} The field will be schema field that is + * selected using the . annotation to display the drill down value. The value will be the user + * inputted text that the filter is comparing against. + * + *

This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Cloud Logging API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

+ * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class FilterExpression extends com.google.api.client.json.GenericJson { + + /** + * The comparison type to use for the filter. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String comparator; + + /** + * Can be one of the FieldSource types: field name, alias ref, variable ref, or a literal value. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private FieldSource fieldSource; + + /** + * The field. This will be the field that is set as the Right Hand Side of the filter. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private FieldSource fieldSourceValue; + + /** + * Determines if the NOT flag should be added to the comparator. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.Boolean isNegation; + + /** + * The Value will be used to hold user defined constants set as the Right Hand Side of the filter. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.Object literalValue; + + /** + * The comparison type to use for the filter. + * @return value or {@code null} for none + */ + public java.lang.String getComparator() { + return comparator; + } + + /** + * The comparison type to use for the filter. + * @param comparator comparator or {@code null} for none + */ + public FilterExpression setComparator(java.lang.String comparator) { + this.comparator = comparator; + return this; + } + + /** + * Can be one of the FieldSource types: field name, alias ref, variable ref, or a literal value. + * @return value or {@code null} for none + */ + public FieldSource getFieldSource() { + return fieldSource; + } + + /** + * Can be one of the FieldSource types: field name, alias ref, variable ref, or a literal value. + * @param fieldSource fieldSource or {@code null} for none + */ + public FilterExpression setFieldSource(FieldSource fieldSource) { + this.fieldSource = fieldSource; + return this; + } + + /** + * The field. This will be the field that is set as the Right Hand Side of the filter. + * @return value or {@code null} for none + */ + public FieldSource getFieldSourceValue() { + return fieldSourceValue; + } + + /** + * The field. This will be the field that is set as the Right Hand Side of the filter. + * @param fieldSourceValue fieldSourceValue or {@code null} for none + */ + public FilterExpression setFieldSourceValue(FieldSource fieldSourceValue) { + this.fieldSourceValue = fieldSourceValue; + return this; + } + + /** + * Determines if the NOT flag should be added to the comparator. + * @return value or {@code null} for none + */ + public java.lang.Boolean getIsNegation() { + return isNegation; + } + + /** + * Determines if the NOT flag should be added to the comparator. + * @param isNegation isNegation or {@code null} for none + */ + public FilterExpression setIsNegation(java.lang.Boolean isNegation) { + this.isNegation = isNegation; + return this; + } + + /** + * The Value will be used to hold user defined constants set as the Right Hand Side of the filter. + * @return value or {@code null} for none + */ + public java.lang.Object getLiteralValue() { + return literalValue; + } + + /** + * The Value will be used to hold user defined constants set as the Right Hand Side of the filter. + * @param literalValue literalValue or {@code null} for none + */ + public FilterExpression setLiteralValue(java.lang.Object literalValue) { + this.literalValue = literalValue; + return this; + } + + @Override + public FilterExpression set(String fieldName, Object value) { + return (FilterExpression) super.set(fieldName, value); + } + + @Override + public FilterExpression clone() { + return (FilterExpression) super.clone(); + } + +} diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FilterPredicate.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FilterPredicate.java new file mode 100644 index 00000000000..bf68b09296b --- /dev/null +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FilterPredicate.java @@ -0,0 +1,123 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except + * in compliance with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software distributed under the License + * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express + * or implied. See the License for the specific language governing permissions and limitations under + * the License. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.logging.v2.model; + +/** + * A filter for a query. This equates to the WHERE clause in SQL. + * + *

This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Cloud Logging API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

+ * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class FilterPredicate extends com.google.api.client.json.GenericJson { + + /** + * The children of the filter predicate. This equates to the branches of the filter predicate that + * could contain further nested leaves. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List childPredicates; + + /** + * The leaves of the filter predicate. This equates to the last leaves of the filter predicate + * associated with an operator. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private FilterExpression leafPredicate; + + /** + * The operator type for the filter. Currently there is no support for multiple levels of nesting, + * so this will be a single value with no joining of different operator types + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String operatorType; + + /** + * The children of the filter predicate. This equates to the branches of the filter predicate that + * could contain further nested leaves. + * @return value or {@code null} for none + */ + public java.util.List getChildPredicates() { + return childPredicates; + } + + /** + * The children of the filter predicate. This equates to the branches of the filter predicate that + * could contain further nested leaves. + * @param childPredicates childPredicates or {@code null} for none + */ + public FilterPredicate setChildPredicates(java.util.List childPredicates) { + this.childPredicates = childPredicates; + return this; + } + + /** + * The leaves of the filter predicate. This equates to the last leaves of the filter predicate + * associated with an operator. + * @return value or {@code null} for none + */ + public FilterExpression getLeafPredicate() { + return leafPredicate; + } + + /** + * The leaves of the filter predicate. This equates to the last leaves of the filter predicate + * associated with an operator. + * @param leafPredicate leafPredicate or {@code null} for none + */ + public FilterPredicate setLeafPredicate(FilterExpression leafPredicate) { + this.leafPredicate = leafPredicate; + return this; + } + + /** + * The operator type for the filter. Currently there is no support for multiple levels of nesting, + * so this will be a single value with no joining of different operator types + * @return value or {@code null} for none + */ + public java.lang.String getOperatorType() { + return operatorType; + } + + /** + * The operator type for the filter. Currently there is no support for multiple levels of nesting, + * so this will be a single value with no joining of different operator types + * @param operatorType operatorType or {@code null} for none + */ + public FilterPredicate setOperatorType(java.lang.String operatorType) { + this.operatorType = operatorType; + return this; + } + + @Override + public FilterPredicate set(String fieldName, Object value) { + return (FilterPredicate) super.set(fieldName, value); + } + + @Override + public FilterPredicate clone() { + return (FilterPredicate) super.clone(); + } + +} diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FunctionApplication.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FunctionApplication.java new file mode 100644 index 00000000000..62b80557737 --- /dev/null +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/FunctionApplication.java @@ -0,0 +1,112 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except + * in compliance with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software distributed under the License + * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express + * or implied. See the License for the specific language governing permissions and limitations under + * the License. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.logging.v2.model; + +/** + * Defines the aggregation function to apply to this field. This message is used only when operation + * is set to AGGREGATE. + * + *

This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Cloud Logging API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

+ * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class FunctionApplication extends com.google.api.client.json.GenericJson { + + /** + * Optional. Parameters to be applied to the aggregation. Aggregations that support or require + * parameters are listed above. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List parameters; + + /** + * Required. Specifies the aggregation function. Use one of the following string identifiers: + * "average": Computes the average (AVG). Applies only to numeric values. "count": Counts the + * number of values (COUNT). "count-distinct": Counts the number of distinct values (COUNT + * DISTINCT). "count-distinct-approx": Approximates the count of distinct values + * (APPROX_COUNT_DISTINCT). "max": Finds the maximum value (MAX). Applies only to numeric values. + * "min": Finds the minimum value (MIN). Applies only to numeric values. "sum": Computes the sum + * (SUM). Applies only to numeric values. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String type; + + /** + * Optional. Parameters to be applied to the aggregation. Aggregations that support or require + * parameters are listed above. + * @return value or {@code null} for none + */ + public java.util.List getParameters() { + return parameters; + } + + /** + * Optional. Parameters to be applied to the aggregation. Aggregations that support or require + * parameters are listed above. + * @param parameters parameters or {@code null} for none + */ + public FunctionApplication setParameters(java.util.List parameters) { + this.parameters = parameters; + return this; + } + + /** + * Required. Specifies the aggregation function. Use one of the following string identifiers: + * "average": Computes the average (AVG). Applies only to numeric values. "count": Counts the + * number of values (COUNT). "count-distinct": Counts the number of distinct values (COUNT + * DISTINCT). "count-distinct-approx": Approximates the count of distinct values + * (APPROX_COUNT_DISTINCT). "max": Finds the maximum value (MAX). Applies only to numeric values. + * "min": Finds the minimum value (MIN). Applies only to numeric values. "sum": Computes the sum + * (SUM). Applies only to numeric values. + * @return value or {@code null} for none + */ + public java.lang.String getType() { + return type; + } + + /** + * Required. Specifies the aggregation function. Use one of the following string identifiers: + * "average": Computes the average (AVG). Applies only to numeric values. "count": Counts the + * number of values (COUNT). "count-distinct": Counts the number of distinct values (COUNT + * DISTINCT). "count-distinct-approx": Approximates the count of distinct values + * (APPROX_COUNT_DISTINCT). "max": Finds the maximum value (MAX). Applies only to numeric values. + * "min": Finds the minimum value (MIN). Applies only to numeric values. "sum": Computes the sum + * (SUM). Applies only to numeric values. + * @param type type or {@code null} for none + */ + public FunctionApplication setType(java.lang.String type) { + this.type = type; + return this; + } + + @Override + public FunctionApplication set(String fieldName, Object value) { + return (FunctionApplication) super.set(fieldName, value); + } + + @Override + public FunctionApplication clone() { + return (FunctionApplication) super.clone(); + } + +} diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/IndexConfig.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/IndexConfig.java index 99d8f8c6a91..827fd26fdaa 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/IndexConfig.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/IndexConfig.java @@ -40,7 +40,7 @@ public final class IndexConfig extends com.google.api.client.json.GenericJson { /** * Required. The LogEntry field path to index.Note that some paths are automatically indexed, and * other paths are not eligible for indexing. See indexing documentation( - * https://cloud.google.com/logging/docs/analyze/custom-index) for details.For example: + * https://docs.cloud.google.com/logging/docs/analyze/custom-index) for details.For example: * jsonPayload.request.status * The value may be {@code null}. */ @@ -76,7 +76,7 @@ public IndexConfig setCreateTime(String createTime) { /** * Required. The LogEntry field path to index.Note that some paths are automatically indexed, and * other paths are not eligible for indexing. See indexing documentation( - * https://cloud.google.com/logging/docs/analyze/custom-index) for details.For example: + * https://docs.cloud.google.com/logging/docs/analyze/custom-index) for details.For example: * jsonPayload.request.status * @return value or {@code null} for none */ @@ -87,7 +87,7 @@ public java.lang.String getFieldPath() { /** * Required. The LogEntry field path to index.Note that some paths are automatically indexed, and * other paths are not eligible for indexing. See indexing documentation( - * https://cloud.google.com/logging/docs/analyze/custom-index) for details.For example: + * https://docs.cloud.google.com/logging/docs/analyze/custom-index) for details.For example: * jsonPayload.request.status * @param fieldPath fieldPath or {@code null} for none */ diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogBucket.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogBucket.java index 93000e3ee13..17dea9d4502 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogBucket.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogBucket.java @@ -93,9 +93,9 @@ public final class LogBucket extends com.google.api.client.json.GenericJson { /** * Output only. The resource name of the bucket.For example:projects/my- * project/locations/global/buckets/my-bucketFor a list of supported locations, see Supported - * Regions (https://cloud.google.com/logging/docs/region-support)For the location of global it is - * unspecified where log entries are actually stored.After a bucket has been created, the location - * cannot be changed. + * Regions (https://docs.cloud.google.com/logging/docs/region-support)For the location of global + * it is unspecified where log entries are actually stored.After a bucket has been created, the + * location cannot be changed. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -261,9 +261,9 @@ public LogBucket setLocked(java.lang.Boolean locked) { /** * Output only. The resource name of the bucket.For example:projects/my- * project/locations/global/buckets/my-bucketFor a list of supported locations, see Supported - * Regions (https://cloud.google.com/logging/docs/region-support)For the location of global it is - * unspecified where log entries are actually stored.After a bucket has been created, the location - * cannot be changed. + * Regions (https://docs.cloud.google.com/logging/docs/region-support)For the location of global + * it is unspecified where log entries are actually stored.After a bucket has been created, the + * location cannot be changed. * @return value or {@code null} for none */ public java.lang.String getName() { @@ -273,9 +273,9 @@ public java.lang.String getName() { /** * Output only. The resource name of the bucket.For example:projects/my- * project/locations/global/buckets/my-bucketFor a list of supported locations, see Supported - * Regions (https://cloud.google.com/logging/docs/region-support)For the location of global it is - * unspecified where log entries are actually stored.After a bucket has been created, the location - * cannot be changed. + * Regions (https://docs.cloud.google.com/logging/docs/region-support)For the location of global + * it is unspecified where log entries are actually stored.After a bucket has been created, the + * location cannot be changed. * @param name name or {@code null} for none */ public LogBucket setName(java.lang.String name) { diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogEntry.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogEntry.java index 598fd3b5aff..c5fe170c60f 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogEntry.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogEntry.java @@ -179,22 +179,20 @@ public final class LogEntry extends com.google.api.client.json.GenericJson { private LogEntrySourceLocation sourceLocation; /** - * Optional. The ID of the Cloud Trace (https://cloud.google.com/trace) span associated with the - * current operation in which the log is being written. For example, if a span has the REST - * resource name of "projects/some-project/traces/some-trace/spans/some-span-id", then the span_id - * field is "some-span-id".A Span - * (https://cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span) + * Optional. The ID of the Cloud Trace (https://docs.cloud.google.com/trace/docs) span associated + * with the current operation in which the log is being written.A Span + * (https://docs.cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span) * represents a single operation within a trace. Whereas a trace may involve multiple different * microservices running on multiple different machines, a span generally corresponds to a single * logical operation being performed in a single instance of a microservice on one specific * machine. Spans are the nodes within the tree that is a trace.Applications that are instrumented - * for tracing (https://cloud.google.com/trace/docs/setup) will generally assign a new, unique - * span ID on each incoming request. It is also common to create and record additional spans - * corresponding to internal processing elements as well as issuing requests to dependencies.The - * span ID is expected to be a 16-character, hexadecimal encoding of an 8-byte array and should - * not be zero. It should be unique within the trace and should, ideally, be generated in a manner - * that is uniformly random.Example values: 000000000000004a 7a2190356c3fc94b 0000f00300090021 - * d39223e101960076 + * for tracing (https://docs.cloud.google.com/trace/docs/setup) will generally assign a new, + * unique span ID on each incoming request. It is also common to create and record additional + * spans corresponding to internal processing elements as well as issuing requests to + * dependencies.The span ID is expected to be a 16-character, hexadecimal encoding of an 8-byte + * array and should not be zero. It should be unique within the trace and should, ideally, be + * generated in a manner that is uniformly random.Example values: 000000000000004a + * 7a2190356c3fc94b 0000f00300090021 d39223e101960076 * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -230,12 +228,14 @@ public final class LogEntry extends com.google.api.client.json.GenericJson { private String timestamp; /** - * Optional. The REST resource name of the trace being written to Cloud Trace - * (https://cloud.google.com/trace) in association with this log entry. For example, if your trace - * data is stored in the Cloud project "my-trace-project" and if the service that is creating the - * log entry receives a trace header that includes the trace ID "12345", then the service should - * use "projects/my-trace-project/traces/12345".The trace field provides the link between logs and - * traces. By using this field, you can navigate from a log entry to a trace. + * Optional. The trace ID being written to Cloud Trace (https://docs.cloud.google.com/trace/docs) + * in association with this log entry. For example, if your trace data is stored in the Cloud + * project "my-trace-project" and if the service that is creating the log entry receives a trace + * header that includes the trace ID "12345", then the service should use "12345".The REST + * resource name of the trace is also supported, but using this format is not recommended. An + * example trace REST resource name is similar to "projects/my-trace-project/traces/12345".The + * trace field provides the link between logs and traces. By using this field, you can navigate + * from a log entry to a trace. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -598,22 +598,20 @@ public LogEntry setSourceLocation(LogEntrySourceLocation sourceLocation) { } /** - * Optional. The ID of the Cloud Trace (https://cloud.google.com/trace) span associated with the - * current operation in which the log is being written. For example, if a span has the REST - * resource name of "projects/some-project/traces/some-trace/spans/some-span-id", then the span_id - * field is "some-span-id".A Span - * (https://cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span) + * Optional. The ID of the Cloud Trace (https://docs.cloud.google.com/trace/docs) span associated + * with the current operation in which the log is being written.A Span + * (https://docs.cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span) * represents a single operation within a trace. Whereas a trace may involve multiple different * microservices running on multiple different machines, a span generally corresponds to a single * logical operation being performed in a single instance of a microservice on one specific * machine. Spans are the nodes within the tree that is a trace.Applications that are instrumented - * for tracing (https://cloud.google.com/trace/docs/setup) will generally assign a new, unique - * span ID on each incoming request. It is also common to create and record additional spans - * corresponding to internal processing elements as well as issuing requests to dependencies.The - * span ID is expected to be a 16-character, hexadecimal encoding of an 8-byte array and should - * not be zero. It should be unique within the trace and should, ideally, be generated in a manner - * that is uniformly random.Example values: 000000000000004a 7a2190356c3fc94b 0000f00300090021 - * d39223e101960076 + * for tracing (https://docs.cloud.google.com/trace/docs/setup) will generally assign a new, + * unique span ID on each incoming request. It is also common to create and record additional + * spans corresponding to internal processing elements as well as issuing requests to + * dependencies.The span ID is expected to be a 16-character, hexadecimal encoding of an 8-byte + * array and should not be zero. It should be unique within the trace and should, ideally, be + * generated in a manner that is uniformly random.Example values: 000000000000004a + * 7a2190356c3fc94b 0000f00300090021 d39223e101960076 * @return value or {@code null} for none */ public java.lang.String getSpanId() { @@ -621,22 +619,20 @@ public java.lang.String getSpanId() { } /** - * Optional. The ID of the Cloud Trace (https://cloud.google.com/trace) span associated with the - * current operation in which the log is being written. For example, if a span has the REST - * resource name of "projects/some-project/traces/some-trace/spans/some-span-id", then the span_id - * field is "some-span-id".A Span - * (https://cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span) + * Optional. The ID of the Cloud Trace (https://docs.cloud.google.com/trace/docs) span associated + * with the current operation in which the log is being written.A Span + * (https://docs.cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span) * represents a single operation within a trace. Whereas a trace may involve multiple different * microservices running on multiple different machines, a span generally corresponds to a single * logical operation being performed in a single instance of a microservice on one specific * machine. Spans are the nodes within the tree that is a trace.Applications that are instrumented - * for tracing (https://cloud.google.com/trace/docs/setup) will generally assign a new, unique - * span ID on each incoming request. It is also common to create and record additional spans - * corresponding to internal processing elements as well as issuing requests to dependencies.The - * span ID is expected to be a 16-character, hexadecimal encoding of an 8-byte array and should - * not be zero. It should be unique within the trace and should, ideally, be generated in a manner - * that is uniformly random.Example values: 000000000000004a 7a2190356c3fc94b 0000f00300090021 - * d39223e101960076 + * for tracing (https://docs.cloud.google.com/trace/docs/setup) will generally assign a new, + * unique span ID on each incoming request. It is also common to create and record additional + * spans corresponding to internal processing elements as well as issuing requests to + * dependencies.The span ID is expected to be a 16-character, hexadecimal encoding of an 8-byte + * array and should not be zero. It should be unique within the trace and should, ideally, be + * generated in a manner that is uniformly random.Example values: 000000000000004a + * 7a2190356c3fc94b 0000f00300090021 d39223e101960076 * @param spanId spanId or {@code null} for none */ public LogEntry setSpanId(java.lang.String spanId) { @@ -712,12 +708,14 @@ public LogEntry setTimestamp(String timestamp) { } /** - * Optional. The REST resource name of the trace being written to Cloud Trace - * (https://cloud.google.com/trace) in association with this log entry. For example, if your trace - * data is stored in the Cloud project "my-trace-project" and if the service that is creating the - * log entry receives a trace header that includes the trace ID "12345", then the service should - * use "projects/my-trace-project/traces/12345".The trace field provides the link between logs and - * traces. By using this field, you can navigate from a log entry to a trace. + * Optional. The trace ID being written to Cloud Trace (https://docs.cloud.google.com/trace/docs) + * in association with this log entry. For example, if your trace data is stored in the Cloud + * project "my-trace-project" and if the service that is creating the log entry receives a trace + * header that includes the trace ID "12345", then the service should use "12345".The REST + * resource name of the trace is also supported, but using this format is not recommended. An + * example trace REST resource name is similar to "projects/my-trace-project/traces/12345".The + * trace field provides the link between logs and traces. By using this field, you can navigate + * from a log entry to a trace. * @return value or {@code null} for none */ public java.lang.String getTrace() { @@ -725,12 +723,14 @@ public java.lang.String getTrace() { } /** - * Optional. The REST resource name of the trace being written to Cloud Trace - * (https://cloud.google.com/trace) in association with this log entry. For example, if your trace - * data is stored in the Cloud project "my-trace-project" and if the service that is creating the - * log entry receives a trace header that includes the trace ID "12345", then the service should - * use "projects/my-trace-project/traces/12345".The trace field provides the link between logs and - * traces. By using this field, you can navigate from a log entry to a trace. + * Optional. The trace ID being written to Cloud Trace (https://docs.cloud.google.com/trace/docs) + * in association with this log entry. For example, if your trace data is stored in the Cloud + * project "my-trace-project" and if the service that is creating the log entry receives a trace + * header that includes the trace ID "12345", then the service should use "12345".The REST + * resource name of the trace is also supported, but using this format is not recommended. An + * example trace REST resource name is similar to "projects/my-trace-project/traces/12345".The + * trace field provides the link between logs and traces. By using this field, you can navigate + * from a log entry to a trace. * @param trace trace or {@code null} for none */ public LogEntry setTrace(java.lang.String trace) { diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogExclusion.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogExclusion.java index e25e140ca00..4ff90119117 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogExclusion.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogExclusion.java @@ -56,11 +56,12 @@ public final class LogExclusion extends com.google.api.client.json.GenericJson { private java.lang.Boolean disabled; /** - * 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 + * Required. An advanced logs filter (https://docs.cloud.google.com/logging/docs/view/building- + * queries#queries-by-expression) that matches the log entries to be excluded. By using the sample + * function (https://docs.cloud.google.com/logging/docs/view/logging-query-language#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 * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -139,11 +140,12 @@ public LogExclusion setDisabled(java.lang.Boolean disabled) { } /** - * 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 + * Required. An advanced logs filter (https://docs.cloud.google.com/logging/docs/view/building- + * queries#queries-by-expression) that matches the log entries to be excluded. By using the sample + * function (https://docs.cloud.google.com/logging/docs/view/logging-query-language#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 * @return value or {@code null} for none */ public java.lang.String getFilter() { @@ -151,11 +153,12 @@ public java.lang.String getFilter() { } /** - * 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 + * Required. An advanced logs filter (https://docs.cloud.google.com/logging/docs/view/building- + * queries#queries-by-expression) that matches the log entries to be excluded. By using the sample + * function (https://docs.cloud.google.com/logging/docs/view/logging-query-language#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 * @param filter filter or {@code null} for none */ public LogExclusion setFilter(java.lang.String filter) { diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogSink.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogSink.java index 702660b859c..00ee7251883 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogSink.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LogSink.java @@ -60,8 +60,8 @@ public final class LogSink extends com.google.api.client.json.GenericJson { * "logging.googleapis.com/projects/[PROJECT_ID]" * "logging.googleapis.com/projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" The * sink's writer_identity, set when the sink is created, must have permission to write to the - * destination or else the log entries are not exported. For more information, see Exporting Logs - * with Sinks (https://cloud.google.com/logging/docs/api/tasks/exporting-logs). + * destination or else the log entries are not exported. For more information, see Route logs to + * supported destinations (https://docs.cloud.google.com/logging/docs/export/configure_export_v2). * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -89,10 +89,10 @@ public final class LogSink extends com.google.api.client.json.GenericJson { } /** - * Optional. An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced- - * queries). The only exported log entries are those that are in the resource owning the sink and - * that match the filter.For example:logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND - * severity>=ERROR + * Optional. An advanced logs filter (https://docs.cloud.google.com/logging/docs/view/building- + * queries#queries-by-expression). The only exported log entries are those that are in the + * resource owning the sink and that match the filter.For + * example:logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -166,8 +166,9 @@ public final class LogSink extends com.google.api.client.json.GenericJson { * exported log entries to the sink's destination. This field is either set by specifying * custom_writer_identity or set automatically by sinks.create and sinks.update based on the value * of unique_writer_identity in those methods.Until you grant this identity write-access to the - * destination, log entry exports from this sink will fail. For more information, see Granting - * Access for a Resource (https://cloud.google.com/iam/docs/granting-roles-to-service- + * destination, log entry exports from this sink will fail. For more information, see Manage + * access to projects, folders, and organizations + * (https://docs.cloud.google.com/iam/docs/granting-roles-to-service- * accounts#granting_access_to_a_service_account_for_a_resource). Consult the destination * service's documentation to determine the appropriate IAM roles to assign to the identity.Sinks * that have a destination that is a log bucket in the same project as the sink cannot have a @@ -235,8 +236,8 @@ public LogSink setDescription(java.lang.String description) { * "logging.googleapis.com/projects/[PROJECT_ID]" * "logging.googleapis.com/projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" The * sink's writer_identity, set when the sink is created, must have permission to write to the - * destination or else the log entries are not exported. For more information, see Exporting Logs - * with Sinks (https://cloud.google.com/logging/docs/api/tasks/exporting-logs). + * destination or else the log entries are not exported. For more information, see Route logs to + * supported destinations (https://docs.cloud.google.com/logging/docs/export/configure_export_v2). * @return value or {@code null} for none */ public java.lang.String getDestination() { @@ -250,8 +251,8 @@ public java.lang.String getDestination() { * "logging.googleapis.com/projects/[PROJECT_ID]" * "logging.googleapis.com/projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" The * sink's writer_identity, set when the sink is created, must have permission to write to the - * destination or else the log entries are not exported. For more information, see Exporting Logs - * with Sinks (https://cloud.google.com/logging/docs/api/tasks/exporting-logs). + * destination or else the log entries are not exported. For more information, see Route logs to + * supported destinations (https://docs.cloud.google.com/logging/docs/export/configure_export_v2). * @param destination destination or {@code null} for none */ public LogSink setDestination(java.lang.String destination) { @@ -296,10 +297,10 @@ public LogSink setExclusions(java.util.List exclusions) { } /** - * Optional. An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced- - * queries). The only exported log entries are those that are in the resource owning the sink and - * that match the filter.For example:logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND - * severity>=ERROR + * Optional. An advanced logs filter (https://docs.cloud.google.com/logging/docs/view/building- + * queries#queries-by-expression). The only exported log entries are those that are in the + * resource owning the sink and that match the filter.For + * example:logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR * @return value or {@code null} for none */ public java.lang.String getFilter() { @@ -307,10 +308,10 @@ public java.lang.String getFilter() { } /** - * Optional. An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced- - * queries). The only exported log entries are those that are in the resource owning the sink and - * that match the filter.For example:logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND - * severity>=ERROR + * Optional. An advanced logs filter (https://docs.cloud.google.com/logging/docs/view/building- + * queries#queries-by-expression). The only exported log entries are those that are in the + * resource owning the sink and that match the filter.For + * example:logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR * @param filter filter or {@code null} for none */ public LogSink setFilter(java.lang.String filter) { @@ -467,8 +468,9 @@ public LogSink setUpdateTime(String updateTime) { * exported log entries to the sink's destination. This field is either set by specifying * custom_writer_identity or set automatically by sinks.create and sinks.update based on the value * of unique_writer_identity in those methods.Until you grant this identity write-access to the - * destination, log entry exports from this sink will fail. For more information, see Granting - * Access for a Resource (https://cloud.google.com/iam/docs/granting-roles-to-service- + * destination, log entry exports from this sink will fail. For more information, see Manage + * access to projects, folders, and organizations + * (https://docs.cloud.google.com/iam/docs/granting-roles-to-service- * accounts#granting_access_to_a_service_account_for_a_resource). Consult the destination * service's documentation to determine the appropriate IAM roles to assign to the identity.Sinks * that have a destination that is a log bucket in the same project as the sink cannot have a @@ -484,8 +486,9 @@ public java.lang.String getWriterIdentity() { * exported log entries to the sink's destination. This field is either set by specifying * custom_writer_identity or set automatically by sinks.create and sinks.update based on the value * of unique_writer_identity in those methods.Until you grant this identity write-access to the - * destination, log entry exports from this sink will fail. For more information, see Granting - * Access for a Resource (https://cloud.google.com/iam/docs/granting-roles-to-service- + * destination, log entry exports from this sink will fail. For more information, see Manage + * access to projects, folders, and organizations + * (https://docs.cloud.google.com/iam/docs/granting-roles-to-service- * accounts#granting_access_to_a_service_account_for_a_resource). Consult the destination * service's documentation to determine the appropriate IAM roles to assign to the identity.Sinks * that have a destination that is a log bucket in the same project as the sink cannot have a diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LoggingQuery.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LoggingQuery.java index 724c5221939..b6c58f0e706 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LoggingQuery.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/LoggingQuery.java @@ -33,8 +33,8 @@ public final class LoggingQuery extends com.google.api.client.json.GenericJson { /** * Required. An advanced query using the Logging Query Language - * (https://cloud.google.com/logging/docs/view/logging-query-language). The maximum length of the - * filter is 20000 characters. + * (https://docs.cloud.google.com/logging/docs/view/logging-query-language). The maximum length of + * the filter is 20000 characters. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -63,8 +63,8 @@ public final class LoggingQuery extends com.google.api.client.json.GenericJson { /** * Required. An advanced query using the Logging Query Language - * (https://cloud.google.com/logging/docs/view/logging-query-language). The maximum length of the - * filter is 20000 characters. + * (https://docs.cloud.google.com/logging/docs/view/logging-query-language). The maximum length of + * the filter is 20000 characters. * @return value or {@code null} for none */ public java.lang.String getFilter() { @@ -73,8 +73,8 @@ public java.lang.String getFilter() { /** * Required. An advanced query using the Logging Query Language - * (https://cloud.google.com/logging/docs/view/logging-query-language). The maximum length of the - * filter is 20000 characters. + * (https://docs.cloud.google.com/logging/docs/view/logging-query-language). The maximum length of + * the filter is 20000 characters. * @param filter filter or {@code null} for none */ public LoggingQuery setFilter(java.lang.String filter) { diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/OpsAnalyticsQuery.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/OpsAnalyticsQuery.java index 3c25b568fb6..8264876ba5c 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/OpsAnalyticsQuery.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/OpsAnalyticsQuery.java @@ -17,8 +17,7 @@ package com.google.api.services.logging.v2.model; /** - * Describes an analytics query that can be run in the Log Analytics page of Google Cloud - * console.Preview: This is a preview feature and may be subject to change before final release. + * Describes a query that can be run in Log Analytics. * *

This is the Java data model class that specifies how to parse/serialize into the JSON that is * transmitted over HTTP when working with the Cloud Logging API. For a detailed explanation see: @@ -31,16 +30,48 @@ public final class OpsAnalyticsQuery extends com.google.api.client.json.GenericJson { /** - * Required. A logs analytics SQL query, which generally follows BigQuery format.This is the SQL - * query that appears in the Log Analytics UI's query editor. + * Optional. A query builder configuration used in Log Analytics.If both query_builder and + * sql_query_text fields are set, then the sql_query_text will be used, if its non-empty. At least + * one of the two fields must be set. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private QueryBuilderConfig queryBuilder; + + /** + * Optional. A Log Analytics SQL query in text format.If both sql_query_text and query_builder + * fields are set, then the sql_query_text will be used, if its non-empty. At least one of the two + * fields must be set. * The value may be {@code null}. */ @com.google.api.client.util.Key private java.lang.String sqlQueryText; /** - * Required. A logs analytics SQL query, which generally follows BigQuery format.This is the SQL - * query that appears in the Log Analytics UI's query editor. + * Optional. A query builder configuration used in Log Analytics.If both query_builder and + * sql_query_text fields are set, then the sql_query_text will be used, if its non-empty. At least + * one of the two fields must be set. + * @return value or {@code null} for none + */ + public QueryBuilderConfig getQueryBuilder() { + return queryBuilder; + } + + /** + * Optional. A query builder configuration used in Log Analytics.If both query_builder and + * sql_query_text fields are set, then the sql_query_text will be used, if its non-empty. At least + * one of the two fields must be set. + * @param queryBuilder queryBuilder or {@code null} for none + */ + public OpsAnalyticsQuery setQueryBuilder(QueryBuilderConfig queryBuilder) { + this.queryBuilder = queryBuilder; + return this; + } + + /** + * Optional. A Log Analytics SQL query in text format.If both sql_query_text and query_builder + * fields are set, then the sql_query_text will be used, if its non-empty. At least one of the two + * fields must be set. * @return value or {@code null} for none */ public java.lang.String getSqlQueryText() { @@ -48,8 +79,9 @@ public java.lang.String getSqlQueryText() { } /** - * Required. A logs analytics SQL query, which generally follows BigQuery format.This is the SQL - * query that appears in the Log Analytics UI's query editor. + * Optional. A Log Analytics SQL query in text format.If both sql_query_text and query_builder + * fields are set, then the sql_query_text will be used, if its non-empty. At least one of the two + * fields must be set. * @param sqlQueryText sqlQueryText or {@code null} for none */ public OpsAnalyticsQuery setSqlQueryText(java.lang.String sqlQueryText) { diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/ProjectedField.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/ProjectedField.java new file mode 100644 index 00000000000..d6a875ea6f2 --- /dev/null +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/ProjectedField.java @@ -0,0 +1,259 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except + * in compliance with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software distributed under the License + * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express + * or implied. See the License for the specific language governing permissions and limitations under + * the License. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.logging.v2.model; + +/** + * Represents a field selected in the query, analogous to an item in a SQL SELECT clause. It + * specifies the source field and optionally applies transformations like aggregation, casting, + * regex extraction, or assigns an alias. Use ProjectedField when you need more than just the raw + * source field name (for which you might use FieldSource directly in QueryBuilderConfig's + * field_sources list if no transformations or specific operation type are needed). + * + *

This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Cloud Logging API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

+ * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class ProjectedField extends com.google.api.client.json.GenericJson { + + /** + * The alias name for the field. Valid alias examples are: - single word alias: TestAlias - + * numbers in an alias: Alias123 - multi word alias should be enclosed in quotes: "Test Alias" + * Invalid alias examples are: - alias containing keywords: WHERE, SELECT, FROM, etc. - alias + * starting with a number: 1stAlias + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String alias; + + /** + * The cast for the field. This can any SQL cast type. Examples: - STRING - CHAR - DATE - + * TIMESTAMP - DATETIME - INT - FLOAT + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String cast; + + /** + * The field name. This will be the field that is selected using the dot notation to display the + * drill down value. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String field; + + /** + * Specifies the role of this field (direct selection, grouping, or aggregation). + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String operation; + + /** + * The re2 extraction for the field. This will be used to extract the value from the field using + * REGEXP_EXTRACT. More information on re2 can be found here: + * https://github.com/google/re2/wiki/Syntax. Meta characters like +?()| will need to be escaped. + * Examples: - ".(autoscaler.*)$" will be converted to + * REGEXP_EXTRACT(JSON_VALUE(field),"request(.*(autoscaler.*)$)")in SQL. - "\(test_value\)$" will + * be converted to REGEXP_EXTRACT(JSON_VALUE(field),"request(\(test_value\)$)") in SQL. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String regexExtraction; + + /** + * The function to apply to the field. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private FunctionApplication sqlAggregationFunction; + + /** + * The truncation granularity when grouping by a time/date field. This will be used to truncate + * the field to the granularity specified. This can be either a date or a time granularity found + * at https://cloud.google.com/bigquery/docs/reference/standard- + * sql/timestamp_functions#timestamp_trunc_granularity_date and + * https://cloud.google.com/bigquery/docs/reference/standard- + * sql/timestamp_functions#timestamp_trunc_granularity_time respectively. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String truncationGranularity; + + /** + * The alias name for the field. Valid alias examples are: - single word alias: TestAlias - + * numbers in an alias: Alias123 - multi word alias should be enclosed in quotes: "Test Alias" + * Invalid alias examples are: - alias containing keywords: WHERE, SELECT, FROM, etc. - alias + * starting with a number: 1stAlias + * @return value or {@code null} for none + */ + public java.lang.String getAlias() { + return alias; + } + + /** + * The alias name for the field. Valid alias examples are: - single word alias: TestAlias - + * numbers in an alias: Alias123 - multi word alias should be enclosed in quotes: "Test Alias" + * Invalid alias examples are: - alias containing keywords: WHERE, SELECT, FROM, etc. - alias + * starting with a number: 1stAlias + * @param alias alias or {@code null} for none + */ + public ProjectedField setAlias(java.lang.String alias) { + this.alias = alias; + return this; + } + + /** + * The cast for the field. This can any SQL cast type. Examples: - STRING - CHAR - DATE - + * TIMESTAMP - DATETIME - INT - FLOAT + * @return value or {@code null} for none + */ + public java.lang.String getCast() { + return cast; + } + + /** + * The cast for the field. This can any SQL cast type. Examples: - STRING - CHAR - DATE - + * TIMESTAMP - DATETIME - INT - FLOAT + * @param cast cast or {@code null} for none + */ + public ProjectedField setCast(java.lang.String cast) { + this.cast = cast; + return this; + } + + /** + * The field name. This will be the field that is selected using the dot notation to display the + * drill down value. + * @return value or {@code null} for none + */ + public java.lang.String getField() { + return field; + } + + /** + * The field name. This will be the field that is selected using the dot notation to display the + * drill down value. + * @param field field or {@code null} for none + */ + public ProjectedField setField(java.lang.String field) { + this.field = field; + return this; + } + + /** + * Specifies the role of this field (direct selection, grouping, or aggregation). + * @return value or {@code null} for none + */ + public java.lang.String getOperation() { + return operation; + } + + /** + * Specifies the role of this field (direct selection, grouping, or aggregation). + * @param operation operation or {@code null} for none + */ + public ProjectedField setOperation(java.lang.String operation) { + this.operation = operation; + return this; + } + + /** + * The re2 extraction for the field. This will be used to extract the value from the field using + * REGEXP_EXTRACT. More information on re2 can be found here: + * https://github.com/google/re2/wiki/Syntax. Meta characters like +?()| will need to be escaped. + * Examples: - ".(autoscaler.*)$" will be converted to + * REGEXP_EXTRACT(JSON_VALUE(field),"request(.*(autoscaler.*)$)")in SQL. - "\(test_value\)$" will + * be converted to REGEXP_EXTRACT(JSON_VALUE(field),"request(\(test_value\)$)") in SQL. + * @return value or {@code null} for none + */ + public java.lang.String getRegexExtraction() { + return regexExtraction; + } + + /** + * The re2 extraction for the field. This will be used to extract the value from the field using + * REGEXP_EXTRACT. More information on re2 can be found here: + * https://github.com/google/re2/wiki/Syntax. Meta characters like +?()| will need to be escaped. + * Examples: - ".(autoscaler.*)$" will be converted to + * REGEXP_EXTRACT(JSON_VALUE(field),"request(.*(autoscaler.*)$)")in SQL. - "\(test_value\)$" will + * be converted to REGEXP_EXTRACT(JSON_VALUE(field),"request(\(test_value\)$)") in SQL. + * @param regexExtraction regexExtraction or {@code null} for none + */ + public ProjectedField setRegexExtraction(java.lang.String regexExtraction) { + this.regexExtraction = regexExtraction; + return this; + } + + /** + * The function to apply to the field. + * @return value or {@code null} for none + */ + public FunctionApplication getSqlAggregationFunction() { + return sqlAggregationFunction; + } + + /** + * The function to apply to the field. + * @param sqlAggregationFunction sqlAggregationFunction or {@code null} for none + */ + public ProjectedField setSqlAggregationFunction(FunctionApplication sqlAggregationFunction) { + this.sqlAggregationFunction = sqlAggregationFunction; + return this; + } + + /** + * The truncation granularity when grouping by a time/date field. This will be used to truncate + * the field to the granularity specified. This can be either a date or a time granularity found + * at https://cloud.google.com/bigquery/docs/reference/standard- + * sql/timestamp_functions#timestamp_trunc_granularity_date and + * https://cloud.google.com/bigquery/docs/reference/standard- + * sql/timestamp_functions#timestamp_trunc_granularity_time respectively. + * @return value or {@code null} for none + */ + public java.lang.String getTruncationGranularity() { + return truncationGranularity; + } + + /** + * The truncation granularity when grouping by a time/date field. This will be used to truncate + * the field to the granularity specified. This can be either a date or a time granularity found + * at https://cloud.google.com/bigquery/docs/reference/standard- + * sql/timestamp_functions#timestamp_trunc_granularity_date and + * https://cloud.google.com/bigquery/docs/reference/standard- + * sql/timestamp_functions#timestamp_trunc_granularity_time respectively. + * @param truncationGranularity truncationGranularity or {@code null} for none + */ + public ProjectedField setTruncationGranularity(java.lang.String truncationGranularity) { + this.truncationGranularity = truncationGranularity; + return this; + } + + @Override + public ProjectedField set(String fieldName, Object value) { + return (ProjectedField) super.set(fieldName, value); + } + + @Override + public ProjectedField clone() { + return (ProjectedField) super.clone(); + } + +} diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/QueryBuilderConfig.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/QueryBuilderConfig.java new file mode 100644 index 00000000000..a11f23400ae --- /dev/null +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/QueryBuilderConfig.java @@ -0,0 +1,213 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except + * in compliance with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software distributed under the License + * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express + * or implied. See the License for the specific language governing permissions and limitations under + * the License. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.logging.v2.model; + +/** + * Defines a structured query configuration that can be used instead of writing raw SQL. This + * configuration represents the components of a SQL query (FROM, SELECT, WHERE, ORDER BY, LIMIT) and + * is typically converted into an executable query (e.g., BigQuery SQL) by the backend service to + * retrieve data for analysis or visualization. + * + *

This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Cloud Logging API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

+ * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class QueryBuilderConfig extends com.google.api.client.json.GenericJson { + + /** + * Defines the items to include in the query result, analogous to a SQL SELECT clause. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List fieldSources; + + static { + // hack to force ProGuard to consider FieldSource used, since otherwise it would be stripped out + // see https://github.com/google/google-api-java-client/issues/543 + com.google.api.client.util.Data.nullOf(FieldSource.class); + } + + /** + * The filter to use for the query. This equates to the WHERE clause in SQL. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private FilterPredicate filter; + + /** + * The limit to use for the query. This equates to the LIMIT clause in SQL. A limit of 0 will be + * treated as not enabled. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key @com.google.api.client.json.JsonString + private java.lang.Long limit; + + /** + * The sort orders to use for the query. This equates to the ORDER BY clause in SQL. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List orderBys; + + /** + * Required. The view/resource to query. For now only a single view/resource will be sent, but + * there are plans to allow multiple views in the future. Marking as repeated for that purpose. + * Example: - "projects/123/locations/global/buckets/456/views/_Default" - + * "projects/123/locations/global/metricBuckets/456/views/_Default" + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List resourceNames; + + /** + * The plain text search to use for the query. There is no support for multiple search terms. This + * uses the SEARCH functionality in BigQuery. For example, a search_term = 'ERROR' would result in + * the following SQL:SELECT * FROM resource WHERE SEARCH(resource, 'ERROR') LIMIT 100 + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String searchTerm; + + /** + * Defines the items to include in the query result, analogous to a SQL SELECT clause. + * @return value or {@code null} for none + */ + public java.util.List getFieldSources() { + return fieldSources; + } + + /** + * Defines the items to include in the query result, analogous to a SQL SELECT clause. + * @param fieldSources fieldSources or {@code null} for none + */ + public QueryBuilderConfig setFieldSources(java.util.List fieldSources) { + this.fieldSources = fieldSources; + return this; + } + + /** + * The filter to use for the query. This equates to the WHERE clause in SQL. + * @return value or {@code null} for none + */ + public FilterPredicate getFilter() { + return filter; + } + + /** + * The filter to use for the query. This equates to the WHERE clause in SQL. + * @param filter filter or {@code null} for none + */ + public QueryBuilderConfig setFilter(FilterPredicate filter) { + this.filter = filter; + return this; + } + + /** + * The limit to use for the query. This equates to the LIMIT clause in SQL. A limit of 0 will be + * treated as not enabled. + * @return value or {@code null} for none + */ + public java.lang.Long getLimit() { + return limit; + } + + /** + * The limit to use for the query. This equates to the LIMIT clause in SQL. A limit of 0 will be + * treated as not enabled. + * @param limit limit or {@code null} for none + */ + public QueryBuilderConfig setLimit(java.lang.Long limit) { + this.limit = limit; + return this; + } + + /** + * The sort orders to use for the query. This equates to the ORDER BY clause in SQL. + * @return value or {@code null} for none + */ + public java.util.List getOrderBys() { + return orderBys; + } + + /** + * The sort orders to use for the query. This equates to the ORDER BY clause in SQL. + * @param orderBys orderBys or {@code null} for none + */ + public QueryBuilderConfig setOrderBys(java.util.List orderBys) { + this.orderBys = orderBys; + return this; + } + + /** + * Required. The view/resource to query. For now only a single view/resource will be sent, but + * there are plans to allow multiple views in the future. Marking as repeated for that purpose. + * Example: - "projects/123/locations/global/buckets/456/views/_Default" - + * "projects/123/locations/global/metricBuckets/456/views/_Default" + * @return value or {@code null} for none + */ + public java.util.List getResourceNames() { + return resourceNames; + } + + /** + * Required. The view/resource to query. For now only a single view/resource will be sent, but + * there are plans to allow multiple views in the future. Marking as repeated for that purpose. + * Example: - "projects/123/locations/global/buckets/456/views/_Default" - + * "projects/123/locations/global/metricBuckets/456/views/_Default" + * @param resourceNames resourceNames or {@code null} for none + */ + public QueryBuilderConfig setResourceNames(java.util.List resourceNames) { + this.resourceNames = resourceNames; + return this; + } + + /** + * The plain text search to use for the query. There is no support for multiple search terms. This + * uses the SEARCH functionality in BigQuery. For example, a search_term = 'ERROR' would result in + * the following SQL:SELECT * FROM resource WHERE SEARCH(resource, 'ERROR') LIMIT 100 + * @return value or {@code null} for none + */ + public java.lang.String getSearchTerm() { + return searchTerm; + } + + /** + * The plain text search to use for the query. There is no support for multiple search terms. This + * uses the SEARCH functionality in BigQuery. For example, a search_term = 'ERROR' would result in + * the following SQL:SELECT * FROM resource WHERE SEARCH(resource, 'ERROR') LIMIT 100 + * @param searchTerm searchTerm or {@code null} for none + */ + public QueryBuilderConfig setSearchTerm(java.lang.String searchTerm) { + this.searchTerm = searchTerm; + return this; + } + + @Override + public QueryBuilderConfig set(String fieldName, Object value) { + return (QueryBuilderConfig) super.set(fieldName, value); + } + + @Override + public QueryBuilderConfig clone() { + return (QueryBuilderConfig) super.clone(); + } + +} diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/RecentQuery.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/RecentQuery.java index 12604c19aaf..133fbefb77c 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/RecentQuery.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/RecentQuery.java @@ -47,7 +47,7 @@ public final class RecentQuery extends com.google.api.client.json.GenericJson { /** * Output only. Resource name of the recent query.In the format: * "projects/[PROJECT_ID]/locations/[LOCATION_ID]/recentQueries/[QUERY_ID]" For a list of - * supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region- + * supported locations, see Supported Regions (https://docs.cloud.google.com/logging/docs/region- * support)The QUERY_ID is a system generated alphanumeric ID. * The value may be {@code null}. */ @@ -98,7 +98,7 @@ public RecentQuery setLoggingQuery(LoggingQuery loggingQuery) { /** * Output only. Resource name of the recent query.In the format: * "projects/[PROJECT_ID]/locations/[LOCATION_ID]/recentQueries/[QUERY_ID]" For a list of - * supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region- + * supported locations, see Supported Regions (https://docs.cloud.google.com/logging/docs/region- * support)The QUERY_ID is a system generated alphanumeric ID. * @return value or {@code null} for none */ @@ -109,7 +109,7 @@ public java.lang.String getName() { /** * Output only. Resource name of the recent query.In the format: * "projects/[PROJECT_ID]/locations/[LOCATION_ID]/recentQueries/[QUERY_ID]" For a list of - * supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region- + * supported locations, see Supported Regions (https://docs.cloud.google.com/logging/docs/region- * support)The QUERY_ID is a system generated alphanumeric ID. * @param name name or {@code null} for none */ diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/SavedQuery.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/SavedQuery.java index 94902a1552b..f3725eedaca 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/SavedQuery.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/SavedQuery.java @@ -60,9 +60,9 @@ public final class SavedQuery extends com.google.api.client.json.GenericJson { /** * Output only. Resource name of the saved query.In the format: * "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For a list of supported - * locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket- - * regions)After the saved query is created, the location cannot be changed.If the user doesn't - * provide a QUERY_ID, the system will generate an alphanumeric ID. + * locations, see Supported Regions (https://docs.cloud.google.com/logging/docs/region- + * support#bucket-regions)After the saved query is created, the location cannot be changed.If the + * user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -160,9 +160,9 @@ public SavedQuery setLoggingQuery(LoggingQuery loggingQuery) { /** * Output only. Resource name of the saved query.In the format: * "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For a list of supported - * locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket- - * regions)After the saved query is created, the location cannot be changed.If the user doesn't - * provide a QUERY_ID, the system will generate an alphanumeric ID. + * locations, see Supported Regions (https://docs.cloud.google.com/logging/docs/region- + * support#bucket-regions)After the saved query is created, the location cannot be changed.If the + * user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID. * @return value or {@code null} for none */ public java.lang.String getName() { @@ -172,9 +172,9 @@ public java.lang.String getName() { /** * Output only. Resource name of the saved query.In the format: * "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For a list of supported - * locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket- - * regions)After the saved query is created, the location cannot be changed.If the user doesn't - * provide a QUERY_ID, the system will generate an alphanumeric ID. + * locations, see Supported Regions (https://docs.cloud.google.com/logging/docs/region- + * support#bucket-regions)After the saved query is created, the location cannot be changed.If the + * user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID. * @param name name or {@code null} for none */ public SavedQuery setName(java.lang.String name) { diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/Settings.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/Settings.java index f1ed51e3b9e..f34629c15ac 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/Settings.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/Settings.java @@ -53,8 +53,9 @@ public final class Settings extends com.google.api.client.json.GenericJson { * CMEK, set this field to a valid kms_key_name for which the associated service account has the * required roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key.The Cloud KMS key * used by the Log Router can be updated by changing the kms_key_name to a new valid key name.To - * disable CMEK for the Log Router, set this field to an empty string.See Enabling CMEK for Log - * Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for more information. + * disable CMEK for the Log Router, set this field to an empty string.See Configure CMEK for Cloud + * Logging (https://docs.cloud.google.com/logging/docs/routing/managed-encryption) for more + * information. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -64,8 +65,9 @@ public final class Settings extends com.google.api.client.json.GenericJson { * Output only. The service account that will be used by the Log Router to access your Cloud KMS * key.Before enabling CMEK, you must first assign the role * roles/cloudkms.cryptoKeyEncrypterDecrypter to the service account that will be used to access - * your Cloud KMS key. Use GetSettings to obtain the service account ID.See Enabling CMEK for Log - * Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for more information. + * your Cloud KMS key. Use GetSettings to obtain the service account ID.See Configure CMEK for + * Cloud Logging (https://docs.cloud.google.com/logging/docs/routing/managed-encryption) for more + * information. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -144,8 +146,9 @@ public Settings setDisableDefaultSink(java.lang.Boolean disableDefaultSink) { * CMEK, set this field to a valid kms_key_name for which the associated service account has the * required roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key.The Cloud KMS key * used by the Log Router can be updated by changing the kms_key_name to a new valid key name.To - * disable CMEK for the Log Router, set this field to an empty string.See Enabling CMEK for Log - * Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for more information. + * disable CMEK for the Log Router, set this field to an empty string.See Configure CMEK for Cloud + * Logging (https://docs.cloud.google.com/logging/docs/routing/managed-encryption) for more + * information. * @return value or {@code null} for none */ public java.lang.String getKmsKeyName() { @@ -159,8 +162,9 @@ public java.lang.String getKmsKeyName() { * CMEK, set this field to a valid kms_key_name for which the associated service account has the * required roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key.The Cloud KMS key * used by the Log Router can be updated by changing the kms_key_name to a new valid key name.To - * disable CMEK for the Log Router, set this field to an empty string.See Enabling CMEK for Log - * Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for more information. + * disable CMEK for the Log Router, set this field to an empty string.See Configure CMEK for Cloud + * Logging (https://docs.cloud.google.com/logging/docs/routing/managed-encryption) for more + * information. * @param kmsKeyName kmsKeyName or {@code null} for none */ public Settings setKmsKeyName(java.lang.String kmsKeyName) { @@ -172,8 +176,9 @@ public Settings setKmsKeyName(java.lang.String kmsKeyName) { * Output only. The service account that will be used by the Log Router to access your Cloud KMS * key.Before enabling CMEK, you must first assign the role * roles/cloudkms.cryptoKeyEncrypterDecrypter to the service account that will be used to access - * your Cloud KMS key. Use GetSettings to obtain the service account ID.See Enabling CMEK for Log - * Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for more information. + * your Cloud KMS key. Use GetSettings to obtain the service account ID.See Configure CMEK for + * Cloud Logging (https://docs.cloud.google.com/logging/docs/routing/managed-encryption) for more + * information. * @return value or {@code null} for none */ public java.lang.String getKmsServiceAccountId() { @@ -184,8 +189,9 @@ public java.lang.String getKmsServiceAccountId() { * Output only. The service account that will be used by the Log Router to access your Cloud KMS * key.Before enabling CMEK, you must first assign the role * roles/cloudkms.cryptoKeyEncrypterDecrypter to the service account that will be used to access - * your Cloud KMS key. Use GetSettings to obtain the service account ID.See Enabling CMEK for Log - * Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for more information. + * your Cloud KMS key. Use GetSettings to obtain the service account ID.See Configure CMEK for + * Cloud Logging (https://docs.cloud.google.com/logging/docs/routing/managed-encryption) for more + * information. * @param kmsServiceAccountId kmsServiceAccountId or {@code null} for none */ public Settings setKmsServiceAccountId(java.lang.String kmsServiceAccountId) { diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/SortOrderParameter.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/SortOrderParameter.java new file mode 100644 index 00000000000..49eed709db9 --- /dev/null +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/SortOrderParameter.java @@ -0,0 +1,93 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except + * in compliance with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software distributed under the License + * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express + * or implied. See the License for the specific language governing permissions and limitations under + * the License. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.logging.v2.model; + +/** + * A sort order for a query based on a column. + * + *

This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Cloud Logging API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

+ * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class SortOrderParameter extends com.google.api.client.json.GenericJson { + + /** + * The field to sort on. Can be one of the FieldSource types: field name, alias ref, variable ref, + * or a literal value. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private FieldSource fieldSource; + + /** + * The sort order to use for the query. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String sortOrderDirection; + + /** + * The field to sort on. Can be one of the FieldSource types: field name, alias ref, variable ref, + * or a literal value. + * @return value or {@code null} for none + */ + public FieldSource getFieldSource() { + return fieldSource; + } + + /** + * The field to sort on. Can be one of the FieldSource types: field name, alias ref, variable ref, + * or a literal value. + * @param fieldSource fieldSource or {@code null} for none + */ + public SortOrderParameter setFieldSource(FieldSource fieldSource) { + this.fieldSource = fieldSource; + return this; + } + + /** + * The sort order to use for the query. + * @return value or {@code null} for none + */ + public java.lang.String getSortOrderDirection() { + return sortOrderDirection; + } + + /** + * The sort order to use for the query. + * @param sortOrderDirection sortOrderDirection or {@code null} for none + */ + public SortOrderParameter setSortOrderDirection(java.lang.String sortOrderDirection) { + this.sortOrderDirection = sortOrderDirection; + return this; + } + + @Override + public SortOrderParameter set(String fieldName, Object value) { + return (SortOrderParameter) super.set(fieldName, value); + } + + @Override + public SortOrderParameter clone() { + return (SortOrderParameter) super.clone(); + } + +} diff --git a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/SummaryField.java b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/SummaryField.java index 933d396643d..6a0188bb66f 100644 --- a/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/SummaryField.java +++ b/clients/google-api-services-logging/v2/2.0.0/com/google/api/services/logging/v2/model/SummaryField.java @@ -18,8 +18,8 @@ /** * A field from the LogEntry that is added to the summary line - * (https://cloud.google.com/logging/docs/view/logs-explorer-interface#add-summary-fields) for a - * query in the Logs Explorer. + * (https://docs.cloud.google.com/logging/docs/view/logs-explorer-interface#preferences) for a query + * in the Logs Explorer. * *

This is the Java data model class that specifies how to parse/serialize into the JSON that is * transmitted over HTTP when working with the Cloud Logging API. For a detailed explanation see: diff --git a/clients/google-api-services-logging/v2/2.0.0/pom.xml b/clients/google-api-services-logging/v2/2.0.0/pom.xml index 0715895a498..4d4cc8f7697 100644 --- a/clients/google-api-services-logging/v2/2.0.0/pom.xml +++ b/clients/google-api-services-logging/v2/2.0.0/pom.xml @@ -8,8 +8,8 @@ com.google.apis google-api-services-logging - v2-rev20260116-2.0.0 - Cloud Logging API v2-rev20260116-2.0.0 + v2-rev20260130-2.0.0 + Cloud Logging API v2-rev20260130-2.0.0 jar 2011 diff --git a/clients/google-api-services-logging/v2/README.md b/clients/google-api-services-logging/v2/README.md index f4c9638f52e..c313f4dd701 100644 --- a/clients/google-api-services-logging/v2/README.md +++ b/clients/google-api-services-logging/v2/README.md @@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file: com.google.apis google-api-services-logging - v2-rev20260116-2.0.0 + v2-rev20260130-2.0.0 @@ -35,7 +35,7 @@ repositories { mavenCentral() } dependencies { - implementation 'com.google.apis:google-api-services-logging:v2-rev20260116-2.0.0' + implementation 'com.google.apis:google-api-services-logging:v2-rev20260130-2.0.0' } ```