Expose use_legacy_search_syntax flag in the Observability Pipelines API (#3433)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v2/openapi.yaml

@@ -37916,6 +37916,18 @@ components:
           items:
             $ref: '#/components/schemas/ObservabilityPipelineConfigSourceItem'
           type: array
+        use_legacy_search_syntax:
+          description: 'Set to `true` to continue using the legacy search syntax while
+            migrating filter queries. After migrating all queries to the new syntax,
+            set to `false`.
+
+            The legacy syntax is deprecated and will eventually be removed.
+
+            Requires Observability Pipelines Worker 2.11 or later.
+
+            See [Upgrade Your Filter Queries to the New Search Syntax](https://docs.datadoghq.com/observability_pipelines/guide/upgrade_your_filter_queries_to_the_new_search_syntax/)
+            for more information.'
+          type: boolean
       required:
       - sources
       - destinations

src/main/java/com/datadog/api/client/v2/model/ObservabilityPipelineConfig.java

@@ -25,7 +25,8 @@
   ObservabilityPipelineConfig.JSON_PROPERTY_PIPELINE_TYPE,
   ObservabilityPipelineConfig.JSON_PROPERTY_PROCESSOR_GROUPS,
   ObservabilityPipelineConfig.JSON_PROPERTY_PROCESSORS,
-  ObservabilityPipelineConfig.JSON_PROPERTY_SOURCES
+  ObservabilityPipelineConfig.JSON_PROPERTY_SOURCES,
+  ObservabilityPipelineConfig.JSON_PROPERTY_USE_LEGACY_SEARCH_SYNTAX
 })
 @jakarta.annotation.Generated(
     value = "https://github.com/DataDog/datadog-api-client-java/blob/master/.generator")
@@ -47,6 +48,9 @@ public class ObservabilityPipelineConfig {
   public static final String JSON_PROPERTY_SOURCES = "sources";
   private List<ObservabilityPipelineConfigSourceItem> sources = new ArrayList<>();
 
+  public static final String JSON_PROPERTY_USE_LEGACY_SEARCH_SYNTAX = "use_legacy_search_syntax";
+  private Boolean useLegacySearchSyntax;
+
   public ObservabilityPipelineConfig() {}
 
   @JsonCreator
@@ -222,6 +226,32 @@ public void setSources(List<ObservabilityPipelineConfigSourceItem> sources) {
     this.sources = sources;
   }
 
+  public ObservabilityPipelineConfig useLegacySearchSyntax(Boolean useLegacySearchSyntax) {
+    this.useLegacySearchSyntax = useLegacySearchSyntax;
+    return this;
+  }
+
+  /**
+   * Set to <code>true</code> to continue using the legacy search syntax while migrating filter
+   * queries. After migrating all queries to the new syntax, set to <code>false</code>. The legacy
+   * syntax is deprecated and will eventually be removed. Requires Observability Pipelines Worker
+   * 2.11 or later. See <a
+   * href="https://docs.datadoghq.com/observability_pipelines/guide/upgrade_your_filter_queries_to_the_new_search_syntax/">Upgrade
+   * Your Filter Queries to the New Search Syntax</a> for more information.
+   *
+   * @return useLegacySearchSyntax
+   */
+  @jakarta.annotation.Nullable
+  @JsonProperty(JSON_PROPERTY_USE_LEGACY_SEARCH_SYNTAX)
+  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  public Boolean getUseLegacySearchSyntax() {
+    return useLegacySearchSyntax;
+  }
+
+  public void setUseLegacySearchSyntax(Boolean useLegacySearchSyntax) {
+    this.useLegacySearchSyntax = useLegacySearchSyntax;
+  }
+
   /**
    * A container for additional, undeclared properties. This is a holder for any undeclared
    * properties as specified with the 'additionalProperties' keyword in the OAS document.
@@ -283,14 +313,22 @@ public boolean equals(Object o) {
         && Objects.equals(this.processorGroups, observabilityPipelineConfig.processorGroups)
         && Objects.equals(this.processors, observabilityPipelineConfig.processors)
         && Objects.equals(this.sources, observabilityPipelineConfig.sources)
+        && Objects.equals(
+            this.useLegacySearchSyntax, observabilityPipelineConfig.useLegacySearchSyntax)
         && Objects.equals(
             this.additionalProperties, observabilityPipelineConfig.additionalProperties);
   }
 
   @Override
   public int hashCode() {
     return Objects.hash(
-        destinations, pipelineType, processorGroups, processors, sources, additionalProperties);
+        destinations,
+        pipelineType,
+        processorGroups,
+        processors,
+        sources,
+        useLegacySearchSyntax,
+        additionalProperties);
   }
 
   @Override
@@ -302,6 +340,9 @@ public String toString() {
     sb.append("    processorGroups: ").append(toIndentedString(processorGroups)).append("\n");
     sb.append("    processors: ").append(toIndentedString(processors)).append("\n");
     sb.append("    sources: ").append(toIndentedString(sources)).append("\n");
+    sb.append("    useLegacySearchSyntax: ")
+        .append(toIndentedString(useLegacySearchSyntax))
+        .append("\n");
     sb.append("    additionalProperties: ")
         .append(toIndentedString(additionalProperties))
         .append("\n");