Regenerate client from commit 5e7a63b of spec repo (#4505)

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

Author: dd-octo-sts[bot]

.generator/schemas/v2/openapi.yaml

@@ -96597,7 +96597,9 @@ components:
       x-enum-varnames:
         - PROCESS
     ProcessScalarQuery:
-      description: A query for host-level process metrics such as CPU and memory usage.
+      description: |-
+        Per-process metrics from Live Processes. Queries without `aggregator` fail. To scope to one process,
+        set `tag_filters` to its `identifying_tags` from `GET /api/v2/processes`.
       properties:
         aggregator:
           $ref: "#/components/schemas/MetricsAggregator"
@@ -96609,11 +96611,15 @@ components:
           description: Whether CPU metrics should be normalized by core count.
           type: boolean
         limit:
-          description: Maximum number of results to return.
+          description: |-
+            Maximum number of processes or groups to return. Large values can fail with an `Unprocessable
+            Content` error. If so, retry with a smaller limit.
           format: int64
           type: integer
         metric:
-          description: The process metric to query.
+          description: |-
+            The process metric to query, such as `process.stat.cpu.total_pct`, `process.stat.memory.rss`, or
+            `process.stat.memory.vms`.
           example: process.stat.cpu.total_pct
           type: string
         name:
@@ -96623,7 +96629,9 @@ components:
         sort:
           $ref: "#/components/schemas/QuerySortOrder"
         tag_filters:
-          description: Tag filters to narrow down processes.
+          description: |-
+            Tags to narrow down processes. To scope to one process, use its `identifying_tags` from
+            `GET /api/v2/processes`, for example `host:web-01` and `pid:1234`.
           items:
             description: A tag filter value.
             example: "env:prod"
@@ -96735,7 +96743,9 @@ components:
       x-enum-varnames:
         - PROCESS
     ProcessTimeseriesQuery:
-      description: A query for host-level process metrics such as CPU and memory usage.
+      description: |-
+        Per-process metrics from Live Processes over time, such as CPU and memory usage. To scope to one
+        process, set `tag_filters` to its `identifying_tags` from `GET /api/v2/processes`.
       properties:
         cross_org_uuids:
           $ref: "#/components/schemas/CrossOrgUuids"
@@ -96745,11 +96755,15 @@ components:
           description: Whether CPU metrics should be normalized by core count.
           type: boolean
         limit:
-          description: Maximum number of results to return.
+          description: |-
+            Maximum number of processes or groups to return. Large values can fail with an `Unprocessable
+            Content` error. If so, retry with a smaller limit.
           format: int64
           type: integer
         metric:
-          description: The process metric to query.
+          description: |-
+            The process metric to query, such as `process.stat.cpu.total_pct`, `process.stat.memory.rss`, or
+            `process.stat.memory.vms`.
           example: process.stat.cpu.total_pct
           type: string
         name:
@@ -96759,7 +96773,9 @@ components:
         sort:
           $ref: "#/components/schemas/QuerySortOrder"
         tag_filters:
-          description: Tag filters to narrow down processes.
+          description: |-
+            Tags to narrow down processes. To scope to one process, use its `identifying_tags` from
+            `GET /api/v2/processes`, for example `host:web-01` and `pid:1234`.
           items:
             description: A tag filter value.
             example: "env:prod"
@@ -210946,36 +210962,48 @@ paths:
           - dashboards_write
   /api/v2/processes:
     get:
-      description: Get all processes for your organization.
+      description: |-
+        Get processes collected by Live Processes for your organization. One request covers a window of
+        at most 1 hour that starts within the past 36 hours. To cover a longer period, make one request
+        per hour. Older data is not available from this endpoint.
+
+        When a process includes `identifying_tags`, pass them as `tag_filters` in a `process` data source
+        query to `/api/v2/query/scalar` or `/api/v2/query/timeseries` to get CPU or memory metrics for that
+        one process. If absent, don't substitute an empty filter, which would query all processes.
       operationId: ListProcesses
       parameters:
-        - description: String to search processes by.
+        - description: |-
+            Free-text search over process fields such as the executable and user. When it contains several
+            words, a process must match all of them. Use `tags` for exact values such as host.
           in: query
           name: search
           required: false
           schema:
             type: string
-        - description: Comma-separated list of tags to filter processes by.
+        - description: |-
+            Comma-separated `key:value` tags. A process must match every tag. Wildcards, negation
+            (`-key:value`), spaces, and `IN (...)` are not supported. To cover several hosts, make one
+            request per host.
           example: account:prod,user:admin
           in: query
           name: tags
           required: false
           schema:
             type: string
         - description: |-
-            Unix timestamp (number of seconds since epoch) of the start of the query window.
-            If not provided, the start of the query window will be 15 minutes before the `to` timestamp. If neither
-            `from` nor `to` are provided, the query window will be `[now - 15m, now]`.
+            Start of the query window, in Unix seconds. Must be within the past 36 hours and at most 1 hour
+            before `to`. If not provided, the start of the query window is 15 minutes before the `to` timestamp.
+            If neither `from` nor `to` is provided, the query window is `[now - 15m, now]`.
           in: query
           name: from
           required: false
           schema:
             format: int64
             type: integer
         - description: |-
-            Unix timestamp (number of seconds since epoch) of the end of the query window.
-            If not provided, the end of the query window will be 15 minutes after the `from` timestamp. If neither
-            `from` nor `to` are provided, the query window will be `[now - 15m, now]`.
+            End of the query window, in Unix seconds. Must be at most 1 hour after `from`. If not provided, the
+            end of the query window is 15 minutes after the `from` timestamp. If neither `from` nor `to` is
+            provided, the query window is `[now - 15m, now]`.
           in: query
           name: to
           required: false

src/main/java/com/datadog/api/client/v2/api/ProcessesApi.java

@@ -59,7 +59,9 @@ public static class ListProcessesOptionalParameters {
     /**
      * Set search.
      *
-     * @param search String to search processes by. (optional)
+     * @param search Free-text search over process fields such as the executable and user. When it
+     *     contains several words, a process must match all of them. Use <code>tags</code> for exact
+     *     values such as host. (optional)
      * @return ListProcessesOptionalParameters
      */
     public ListProcessesOptionalParameters search(String search) {
@@ -70,7 +72,9 @@ public ListProcessesOptionalParameters search(String search) {
     /**
      * Set tags.
      *
-     * @param tags Comma-separated list of tags to filter processes by. (optional)
+     * @param tags Comma-separated <code>key:value</code> tags. A process must match every tag.
+     *     Wildcards, negation (<code>-key:value</code>), spaces, and <code>IN (...)</code> are not
+     *     supported. To cover several hosts, make one request per host. (optional)
      * @return ListProcessesOptionalParameters
      */
     public ListProcessesOptionalParameters tags(String tags) {
@@ -81,10 +85,10 @@ public ListProcessesOptionalParameters tags(String tags) {
     /**
      * Set from.
      *
-     * @param from Unix timestamp (number of seconds since epoch) of the start of the query window.
-     *     If not provided, the start of the query window will be 15 minutes before the <code>to
-     *     </code> timestamp. If neither <code>from</code> nor <code>to</code> are provided, the
-     *     query window will be <code>[now - 15m, now]</code>. (optional)
+     * @param from Start of the query window, in Unix seconds. Must be within the past 36 hours and
+     *     at most 1 hour before <code>to</code>. If not provided, the start of the query window is
+     *     15 minutes before the <code>to</code> timestamp. If neither <code>from</code> nor <code>
+     *     to</code> is provided, the query window is <code>[now - 15m, now]</code>. (optional)
      * @return ListProcessesOptionalParameters
      */
     public ListProcessesOptionalParameters from(Long from) {
@@ -95,10 +99,10 @@ public ListProcessesOptionalParameters from(Long from) {
     /**
      * Set to.
      *
-     * @param to Unix timestamp (number of seconds since epoch) of the end of the query window. If
-     *     not provided, the end of the query window will be 15 minutes after the <code>from</code>
-     *     timestamp. If neither <code>from</code> nor <code>to</code> are provided, the query
-     *     window will be <code>[now - 15m, now]</code>. (optional)
+     * @param to End of the query window, in Unix seconds. Must be at most 1 hour after <code>from
+     *     </code>. If not provided, the end of the query window is 15 minutes after the <code>from
+     *     </code> timestamp. If neither <code>from</code> nor <code>to</code> is provided, the
+     *     query window is <code>[now - 15m, now]</code>. (optional)
      * @return ListProcessesOptionalParameters
      */
     public ListProcessesOptionalParameters to(Long to) {
@@ -243,7 +247,14 @@ public PaginationIterable<ProcessSummary> listProcessesWithPagination(
   }
 
   /**
-   * Get all processes for your organization.
+   * Get processes collected by Live Processes for your organization. One request covers a window of
+   * at most 1 hour that starts within the past 36 hours. To cover a longer period, make one request
+   * per hour. Older data is not available from this endpoint.
+   *
+   * <p>When a process includes <code>identifying_tags</code>, pass them as <code>tag_filters</code>
+   * in a <code>process</code> data source query to <code>/api/v2/query/scalar</code> or <code>
+   * /api/v2/query/timeseries</code> to get CPU or memory metrics for that one process. If absent,
+   * don't substitute an empty filter, which would query all processes.
    *
    * @param parameters Optional parameters for the request.
    * @return ApiResponse&lt;ProcessSummariesResponse&gt;

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

@@ -19,7 +19,11 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** A query for host-level process metrics such as CPU and memory usage. */
+/**
+ * Per-process metrics from Live Processes. Queries without <code>aggregator</code> fail. To scope
+ * to one process, set <code>tag_filters</code> to its <code>identifying_tags</code> from <code>
+ * GET /api/v2/processes</code>.
+ */
 @JsonPropertyOrder({
   ProcessScalarQuery.JSON_PROPERTY_AGGREGATOR,
   ProcessScalarQuery.JSON_PROPERTY_CROSS_ORG_UUIDS,
@@ -187,7 +191,9 @@ public ProcessScalarQuery limit(Long limit) {
   }
 
   /**
-   * Maximum number of results to return.
+   * Maximum number of processes or groups to return. Large values can fail with an <code>
+   * Unprocessable
+   * Content</code> error. If so, retry with a smaller limit.
    *
    * @return limit
    */
@@ -208,7 +214,8 @@ public ProcessScalarQuery metric(String metric) {
   }
 
   /**
-   * The process metric to query.
+   * The process metric to query, such as <code>process.stat.cpu.total_pct</code>, <code>
+   * process.stat.memory.rss</code>, or <code>process.stat.memory.vms</code>.
    *
    * @return metric
    */
@@ -281,7 +288,9 @@ public ProcessScalarQuery addTagFiltersItem(String tagFiltersItem) {
   }
 
   /**
-   * Tag filters to narrow down processes.
+   * Tags to narrow down processes. To scope to one process, use its <code>identifying_tags</code>
+   * from <code>GET /api/v2/processes</code>, for example <code>host:web-01</code> and <code>
+   * pid:1234</code>.
    *
    * @return tagFilters
    */

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

@@ -19,7 +19,11 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** A query for host-level process metrics such as CPU and memory usage. */
+/**
+ * Per-process metrics from Live Processes over time, such as CPU and memory usage. To scope to one
+ * process, set <code>tag_filters</code> to its <code>identifying_tags</code> from <code>
+ * GET /api/v2/processes</code>.
+ */
 @JsonPropertyOrder({
   ProcessTimeseriesQuery.JSON_PROPERTY_CROSS_ORG_UUIDS,
   ProcessTimeseriesQuery.JSON_PROPERTY_DATA_SOURCE,
@@ -158,7 +162,9 @@ public ProcessTimeseriesQuery limit(Long limit) {
   }
 
   /**
-   * Maximum number of results to return.
+   * Maximum number of processes or groups to return. Large values can fail with an <code>
+   * Unprocessable
+   * Content</code> error. If so, retry with a smaller limit.
    *
    * @return limit
    */
@@ -179,7 +185,8 @@ public ProcessTimeseriesQuery metric(String metric) {
   }
 
   /**
-   * The process metric to query.
+   * The process metric to query, such as <code>process.stat.cpu.total_pct</code>, <code>
+   * process.stat.memory.rss</code>, or <code>process.stat.memory.vms</code>.
    *
    * @return metric
    */
@@ -252,7 +259,9 @@ public ProcessTimeseriesQuery addTagFiltersItem(String tagFiltersItem) {
   }
 
   /**
-   * Tag filters to narrow down processes.
+   * Tags to narrow down processes. To scope to one process, use its <code>identifying_tags</code>
+   * from <code>GET /api/v2/processes</code>, for example <code>host:web-01</code> and <code>
+   * pid:1234</code>.
    *
    * @return tagFilters
    */