[Cloud Network Monitoring API] Update text for response (#2487)

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

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

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-04-03 09:26:22.840697",
-            "spec_repo_commit": "f1a43647"
+            "regenerated": "2025-04-03 16:27:55.129965",
+            "spec_repo_commit": "4468962d"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-04-03 09:26:22.855310",
-            "spec_repo_commit": "f1a43647"
+            "regenerated": "2025-04-03 16:27:55.144771",
+            "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.py

@@ -1,5 +1,5 @@
 """
-Get aggregated connections returns "OK" response
+Get all aggregated connections returns "OK" response
 """
 
 from datadog_api_client import ApiClient, Configuration

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

@@ -0,0 +1,14 @@
+"""
+Get aggregated connections returns "OK" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.cloud_network_monitoring_api import CloudNetworkMonitoringApi
+
+configuration = Configuration()
+configuration.unstable_operations["get_aggregated_connections"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = CloudNetworkMonitoringApi(api_client)
+    response = api_instance.get_aggregated_connections()
+
+    print(response)

src/datadog_api_client/v2/api/cloud_network_monitoring_api.py

@@ -81,13 +81,13 @@ def get_aggregated_connections(
         tags: Union[str, UnsetType] = unset,
         limit: Union[int, UnsetType] = unset,
     ) -> SingleAggregatedConnectionResponseArray:
-        """Get aggregated connections.
+        """Get all aggregated connections.
 
-        Get aggregated connections
+        Get all aggregated connections.
 
-        :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].
+        :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]``.
         :type _from: int, optional
-        :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].
+        :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]``.
         :type to: int, optional
         :param group_by: Comma-separated list of fields to group connections by.
         :type group_by: str, optional

src/datadog_api_client/v2/model/single_aggregated_connection_response_array.py

@@ -36,9 +36,9 @@ def openapi_types(_):
 
     def __init__(self_, data: Union[List[SingleAggregatedConnectionResponseData], UnsetType] = unset, **kwargs):
         """
-        The definition of ``SingleAggregatedConnectionResponseArray`` object.
+        List of aggregated connections.
 
-        :param data: The ``SingleAggregatedConnectionResponseArray`` ``data``.
+        :param data: Array of aggregated connection objects.
         :type data: [SingleAggregatedConnectionResponseData], optional
         """
         if data is not unset:

src/datadog_api_client/v2/model/single_aggregated_connection_response_data.py

@@ -52,16 +52,15 @@ def __init__(
         **kwargs,
     ):
         """
-        The definition of ``SingleAggregatedConnectionResponseData`` object.
+        Object describing an aggregated connection.
 
-        :param attributes: The definition of ``SingleAggregatedConnectionResponseDataAttributes`` object.
+        :param attributes: Attributes for an aggregated connection.
         :type attributes: SingleAggregatedConnectionResponseDataAttributes, optional
 
-        :param id: The ``SingleAggregatedConnectionResponseData`` ``id``.
+        :param id: A unique identifier for the aggregated connection based on the group by values.
         :type id: str, optional
 
-        :param type: Aggregated connection resource type. Allowed enum values: ``aggregated_connection``.
-            default: ``aggregated_connection``
+        :param type: Aggregated connection resource type.
         :type type: SingleAggregatedConnectionResponseDataType, optional
         """
         if attributes is not unset:

src/datadog_api_client/v2/model/single_aggregated_connection_response_data_attributes.py

@@ -63,15 +63,15 @@ def __init__(
         **kwargs,
     ):
         """
-        The definition of ``SingleAggregatedConnectionResponseDataAttributes`` object.
+        Attributes for an aggregated connection.
 
         :param bytes_sent_by_client: The total number of bytes sent by the client over the given period.
         :type bytes_sent_by_client: int, optional
 
         :param bytes_sent_by_server: The total number of bytes sent by the server over the given period.
         :type bytes_sent_by_server: int, optional
 
-        :param group_bys: The ``attributes`` ``group_bys``.
+        :param group_bys: The key, value pairs for each group by.
         :type group_bys: {str: ([str],)}, optional
 
         :param packets_sent_by_client: The total number of packets sent by the client over the given period.

src/datadog_api_client/v2/model/single_aggregated_connection_response_data_type.py

@@ -14,8 +14,7 @@
 
 class SingleAggregatedConnectionResponseDataType(ModelSimple):
     """
-    Aggregated connection resource type. Allowed enum values: `aggregated_connection`.
-        default: `aggregated_connection`
+    Aggregated connection resource type.
 
     :param value: If omitted defaults to "aggregated_connection". Must be one of ["aggregated_connection"].
     :type value: str

tests/v2/features/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