[Cloud Network Monitoring API] Update text for response

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-04-03 09:26:31.847840",
-            "spec_repo_commit": "f1a43647"
+            "regenerated": "2025-04-03 16:27:59.649576",
+            "spec_repo_commit": "4468962d"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-04-03 09:26:31.864167",
-            "spec_repo_commit": "f1a43647"
+            "regenerated": "2025-04-03 16:27:59.666584",
+            "spec_repo_commit": "4468962d"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -30212,7 +30212,7 @@ components:
           type: string
       type: object
     SingleAggregatedConnectionResponseArray:
-      description: The definition of `SingleAggregatedConnectionResponseArray` object.
+      description: List of aggregated connections.
       example:
         data:
         - attributes:
@@ -30236,25 +30236,25 @@ components:
           type: aggregated_connection
       properties:
         data:
-          description: The `SingleAggregatedConnectionResponseArray` `data`.
+          description: Array of aggregated connection objects.
           items:
             $ref: '#/components/schemas/SingleAggregatedConnectionResponseData'
           type: array
       type: object
     SingleAggregatedConnectionResponseData:
-      description: The definition of `SingleAggregatedConnectionResponseData` object.
+      description: Object describing an aggregated connection.
       properties:
         attributes:
           $ref: '#/components/schemas/SingleAggregatedConnectionResponseDataAttributes'
         id:
-          description: The `SingleAggregatedConnectionResponseData` `id`.
+          description: A unique identifier for the aggregated connection based on
+            the group by values.
           type: string
         type:
           $ref: '#/components/schemas/SingleAggregatedConnectionResponseDataType'
       type: object
     SingleAggregatedConnectionResponseDataAttributes:
-      description: The definition of `SingleAggregatedConnectionResponseDataAttributes`
-        object.
+      description: Attributes for an aggregated connection.
       properties:
         bytes_sent_by_client:
           description: The total number of bytes sent by the client over the given
@@ -30268,10 +30268,11 @@ components:
           type: integer
         group_bys:
           additionalProperties:
+            description: The values for each group by.
             items:
               type: string
             type: array
-          description: The `attributes` `group_bys`.
+          description: The key, value pairs for each group by.
           type: object
         packets_sent_by_client:
           description: The total number of packets sent by the client over the given
@@ -30322,9 +30323,7 @@ components:
       type: object
     SingleAggregatedConnectionResponseDataType:
       default: aggregated_connection
-      description: 'Aggregated connection resource type. Allowed enum values: `aggregated_connection`.
-
-        default: `aggregated_connection`'
+      description: Aggregated connection resource type.
       enum:
       - aggregated_connection
       type: string
@@ -44426,22 +44425,22 @@ paths:
       - Network Device Monitoring
   /api/v2/network/connections/aggregate:
     get:
-      description: Get aggregated connections
+      description: Get all aggregated connections.
       operationId: GetAggregatedConnections
       parameters:
       - description: Unix timestamp (number of seconds since epoch) of the start of
           the query window. If not provided, the start of the query window is 15 minutes
-          before the "to" timestamp. If neither "from" nor "to" are provided, the
-          query window is [now - 15m, now].
+          before the `to` timestamp. If neither `from` nor `to` are provided, the
+          query window is `[now - 15m, now]`.
         in: query
         name: from
         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 is the current
-          time. If neither "from" nor "to" are provided, the query window is [now
-          - 15m, now].
+          time. If neither `from` nor `to` are provided, the query window is `[now
+          - 15m, now]`.
         in: query
         name: to
         schema:
@@ -44478,7 +44477,7 @@ paths:
           $ref: '#/components/responses/BadRequestResponse'
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      summary: Get aggregated connections
+      summary: Get all aggregated connections
       tags:
       - Cloud Network Monitoring
       x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,

examples/v2/cloud-network-monitoring/GetAggregatedConnections.java

@@ -1,4 +1,4 @@
-// Get aggregated connections returns "OK" response
+// Get all aggregated connections returns "OK" response
 
 import com.datadog.api.client.ApiClient;
 import com.datadog.api.client.ApiException;

examples/v2/cloud-network-monitoring/GetAggregatedConnections_3059356111.java

@@ -0,0 +1,26 @@
+// Get aggregated connections returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.CloudNetworkMonitoringApi;
+import com.datadog.api.client.v2.model.SingleAggregatedConnectionResponseArray;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.getAggregatedConnections", true);
+    CloudNetworkMonitoringApi apiInstance = new CloudNetworkMonitoringApi(defaultClient);
+
+    try {
+      SingleAggregatedConnectionResponseArray result = apiInstance.getAggregatedConnections();
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println(
+          "Exception when calling CloudNetworkMonitoringApi#getAggregatedConnections");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

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

@@ -56,8 +56,9 @@ public static class GetAggregatedConnectionsOptionalParameters {
      * 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 is 15 minutes before the "to" timestamp.
-     *     If neither "from" nor "to" are provided, the query window is [now - 15m, now]. (optional)
+     *     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> are provided, the query
+     *     window is <code>[now - 15m, now]</code>. (optional)
      * @return GetAggregatedConnectionsOptionalParameters
      */
     public GetAggregatedConnectionsOptionalParameters from(Long from) {
@@ -69,8 +70,9 @@ public GetAggregatedConnectionsOptionalParameters 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 is the current time. If neither "from" nor "to"
-     *     are provided, the query window is [now - 15m, now]. (optional)
+     *     not provided, the end of the query window is the current time. If neither <code>from
+     *     </code> nor <code>to</code> are provided, the query window is <code>[now - 15m, now]
+     *     </code>. (optional)
      * @return GetAggregatedConnectionsOptionalParameters
      */
     public GetAggregatedConnectionsOptionalParameters to(Long to) {
@@ -114,7 +116,7 @@ public GetAggregatedConnectionsOptionalParameters limit(Integer limit) {
   }
 
   /**
-   * Get aggregated connections.
+   * Get all aggregated connections.
    *
    * <p>See {@link #getAggregatedConnectionsWithHttpInfo}.
    *
@@ -127,7 +129,7 @@ public SingleAggregatedConnectionResponseArray getAggregatedConnections() throws
   }
 
   /**
-   * Get aggregated connections.
+   * Get all aggregated connections.
    *
    * <p>See {@link #getAggregatedConnectionsWithHttpInfoAsync}.
    *
@@ -144,7 +146,7 @@ public SingleAggregatedConnectionResponseArray getAggregatedConnections() throws
   }
 
   /**
-   * Get aggregated connections.
+   * Get all aggregated connections.
    *
    * <p>See {@link #getAggregatedConnectionsWithHttpInfo}.
    *
@@ -158,7 +160,7 @@ public SingleAggregatedConnectionResponseArray getAggregatedConnections(
   }
 
   /**
-   * Get aggregated connections.
+   * Get all aggregated connections.
    *
    * <p>See {@link #getAggregatedConnectionsWithHttpInfoAsync}.
    *
@@ -175,7 +177,7 @@ public CompletableFuture<SingleAggregatedConnectionResponseArray> getAggregatedC
   }
 
   /**
-   * Get aggregated connections
+   * Get all aggregated connections.
    *
    * @param parameters Optional parameters for the request.
    * @return ApiResponse&lt;SingleAggregatedConnectionResponseArray&gt;
@@ -237,7 +239,7 @@ public ApiResponse<SingleAggregatedConnectionResponseArray> getAggregatedConnect
   }
 
   /**
-   * Get aggregated connections.
+   * Get all aggregated connections.
    *
    * <p>See {@link #getAggregatedConnectionsWithHttpInfo}.
    *

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

@@ -18,7 +18,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** The definition of <code>SingleAggregatedConnectionResponseArray</code> object. */
+/** List of aggregated connections. */
 @JsonPropertyOrder({SingleAggregatedConnectionResponseArray.JSON_PROPERTY_DATA})
 @jakarta.annotation.Generated(
     value = "https://github.com/DataDog/datadog-api-client-java/blob/master/.generator")
@@ -47,7 +47,7 @@ public SingleAggregatedConnectionResponseArray addDataItem(
   }
 
   /**
-   * The <code>SingleAggregatedConnectionResponseArray</code> <code>data</code>.
+   * Array of aggregated connection objects.
    *
    * @return data
    */

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

@@ -16,7 +16,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** The definition of <code>SingleAggregatedConnectionResponseData</code> object. */
+/** Object describing an aggregated connection. */
 @JsonPropertyOrder({
   SingleAggregatedConnectionResponseData.JSON_PROPERTY_ATTRIBUTES,
   SingleAggregatedConnectionResponseData.JSON_PROPERTY_ID,
@@ -44,7 +44,7 @@ public SingleAggregatedConnectionResponseData attributes(
   }
 
   /**
-   * The definition of <code>SingleAggregatedConnectionResponseDataAttributes</code> object.
+   * Attributes for an aggregated connection.
    *
    * @return attributes
    */
@@ -65,7 +65,7 @@ public SingleAggregatedConnectionResponseData id(String id) {
   }
 
   /**
-   * The <code>SingleAggregatedConnectionResponseData</code> <code>id</code>.
+   * A unique identifier for the aggregated connection based on the group by values.
    *
    * @return id
    */
@@ -88,8 +88,7 @@ public SingleAggregatedConnectionResponseData type(
   }
 
   /**
-   * Aggregated connection resource type. Allowed enum values: <code>aggregated_connection</code>.
-   * default: <code>aggregated_connection</code>
+   * Aggregated connection resource type.
    *
    * @return type
    */

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

@@ -17,7 +17,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** The definition of <code>SingleAggregatedConnectionResponseDataAttributes</code> object. */
+/** Attributes for an aggregated connection. */
 @JsonPropertyOrder({
   SingleAggregatedConnectionResponseDataAttributes.JSON_PROPERTY_BYTES_SENT_BY_CLIENT,
   SingleAggregatedConnectionResponseDataAttributes.JSON_PROPERTY_BYTES_SENT_BY_SERVER,
@@ -133,7 +133,7 @@ public SingleAggregatedConnectionResponseDataAttributes putGroupBysItem(
   }
 
   /**
-   * The <code>attributes</code> <code>group_bys</code>.
+   * The key, value pairs for each group by.
    *
    * @return groupBys
    */

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

@@ -18,10 +18,7 @@
 import java.util.HashSet;
 import java.util.Set;
 
-/**
- * Aggregated connection resource type. Allowed enum values: <code>aggregated_connection</code>.
- * default: <code>aggregated_connection</code>
- */
+/** Aggregated connection resource type. */
 @JsonSerialize(
     using =
         SingleAggregatedConnectionResponseDataType

src/test/resources/com/datadog/api/client/v2/api/cloud_network_monitoring.feature

@@ -12,11 +12,6 @@ Feature: Cloud Network Monitoring
     And operation "GetAggregatedConnections" enabled
     And new "GetAggregatedConnections" request
 
-  @generated @skip @team:Datadog/networks
-  Scenario: Get aggregated connections returns "Bad Request" response
-    When the request is sent
-    Then the response status is 400 Bad Request
-
   @team:Datadog/networks
   Scenario: Get aggregated connections returns "OK" response
     When the request is sent
@@ -27,3 +22,8 @@ Feature: Cloud Network Monitoring
     Given request contains "limit" parameter with value 6000
     When the request is sent
     Then the response status is 400 Bad Request
+
+  @generated @skip @team:Datadog/networks
+  Scenario: Get all aggregated connections returns "OK" response
+    When the request is sent
+    Then the response status is 200 OK