Add specs for Cloud Network Monitoring API (#2480)

Co-authored-by: ci.datadog-api-spec <[email protected]>

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

Diff for: .apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-03-31 17:40:02.585066",
-            "spec_repo_commit": "3826157e"
+            "regenerated": "2025-04-01 20:55:53.502642",
+            "spec_repo_commit": "f629f10b"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-03-31 17:40:02.599977",
-            "spec_repo_commit": "3826157e"
+            "regenerated": "2025-04-01 20:55:53.517608",
+            "spec_repo_commit": "f629f10b"
         }
     }
 }

Diff for: .generator/schemas/v2/openapi.yaml

@@ -30188,6 +30188,125 @@ components:
           description: Link to the Incident created on ServiceNow
           type: string
       type: object
+    SingleAggregatedConnectionResponseArray:
+      description: The definition of `SingleAggregatedConnectionResponseArray` object.
+      example:
+        data:
+        - attributes:
+            bytes_sent_by_client: 100
+            bytes_sent_by_server: 200
+            group_bys:
+              client_team:
+              - networks
+              server_service:
+              - hucklebuck
+            packets_sent_by_client: 10
+            packets_sent_by_server: 20
+            rtt_micro_seconds: 800
+            tcp_closed_connections: 30
+            tcp_established_connections: 40
+            tcp_refusals: 7
+            tcp_resets: 5
+            tcp_retransmits: 30
+            tcp_timeouts: 6
+          id: client_team:networks, server_service:hucklebuck
+          type: aggregated_connection
+      properties:
+        data:
+          description: The `SingleAggregatedConnectionResponseArray` `data`.
+          items:
+            $ref: '#/components/schemas/SingleAggregatedConnectionResponseData'
+          type: array
+      type: object
+    SingleAggregatedConnectionResponseData:
+      description: The definition of `SingleAggregatedConnectionResponseData` object.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/SingleAggregatedConnectionResponseDataAttributes'
+        id:
+          description: The `SingleAggregatedConnectionResponseData` `id`.
+          type: string
+        type:
+          $ref: '#/components/schemas/SingleAggregatedConnectionResponseDataType'
+      type: object
+    SingleAggregatedConnectionResponseDataAttributes:
+      description: The definition of `SingleAggregatedConnectionResponseDataAttributes`
+        object.
+      properties:
+        bytes_sent_by_client:
+          description: The total number of bytes sent by the client over the given
+            period.
+          format: int64
+          type: integer
+        bytes_sent_by_server:
+          description: The total number of bytes sent by the server over the given
+            period.
+          format: int64
+          type: integer
+        group_bys:
+          additionalProperties:
+            items:
+              type: string
+            type: array
+          description: The `attributes` `group_bys`.
+          type: object
+        packets_sent_by_client:
+          description: The total number of packets sent by the client over the given
+            period.
+          format: int64
+          type: integer
+        packets_sent_by_server:
+          description: The total number of packets sent by the server over the given
+            period.
+          format: int64
+          type: integer
+        rtt_micro_seconds:
+          description: Measured as TCP smoothed roundtrip time in microseconds (the
+            time between a TCP frame being sent and acknowledged).
+          format: int64
+          type: integer
+        tcp_closed_connections:
+          description: The number of TCP connections in a closed state. Measured in
+            connections per second from the client.
+          format: int64
+          type: integer
+        tcp_established_connections:
+          description: The number of TCP connections in an established state. Measured
+            in connections per second from the client.
+          format: int64
+          type: integer
+        tcp_refusals:
+          description: The number of TCP connections that were refused by the server.
+            Typically this indicates an attempt to connect to an IP/port that is not
+            receiving connections, or a firewall/security misconfiguration.
+          format: int64
+          type: integer
+        tcp_resets:
+          description: The number of TCP connections that were reset by the server.
+          format: int64
+          type: integer
+        tcp_retransmits:
+          description: TCP Retransmits represent detected failures that are retransmitted
+            to ensure delivery. Measured in count of retransmits from the client.
+          format: int64
+          type: integer
+        tcp_timeouts:
+          description: The number of TCP connections that timed out from the perspective
+            of the operating system. This can indicate general connectivity and latency
+            issues.
+          format: int64
+          type: integer
+      type: object
+    SingleAggregatedConnectionResponseDataType:
+      default: aggregated_connection
+      description: 'Aggregated connection resource type. Allowed enum values: `aggregated_connection`.
+
+        default: `aggregated_connection`'
+      enum:
+      - aggregated_connection
+      type: string
+      x-enum-varnames:
+      - AGGREGATED_CONNECTION
     SlackIntegrationMetadata:
       description: Incident integration metadata for the Slack integration.
       properties:
@@ -44282,6 +44401,68 @@ paths:
       summary: Update the tags for a device
       tags:
       - Network Device Monitoring
+  /api/v2/network/connections/aggregate:
+    get:
+      description: Get 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].
+        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].
+        in: query
+        name: to
+        schema:
+          format: int64
+          type: integer
+      - description: Comma-separated list of fields to group connections by.
+        in: query
+        name: group_by
+        schema:
+          type: string
+      - description: Comma-separated list of tags to filter connections by.
+        in: query
+        name: tags
+        schema:
+          type: string
+      - description: The number of connections to be returned. The maximum value is
+          5000.
+        in: query
+        name: limit
+        schema:
+          default: 100
+          format: int32
+          maximum: 5000
+          minimum: 1
+          type: integer
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SingleAggregatedConnectionResponseArray'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Get aggregated connections
+      tags:
+      - Cloud Network Monitoring
+      x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
+
+        contact [Datadog support](https://docs.datadoghq.com/help/).
+
+        type: safe'
   /api/v2/org_configs:
     get:
       description: Returns all Org Configs (name, description, and value).
@@ -53624,6 +53805,10 @@ tags:
     and the `cloud_cost` data source. For more information, see the [Cloud Cost Management
     documentation](https://docs.datadoghq.com/cloud_cost_management/).
   name: Cloud Cost Management
+- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
+    and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
+    for more information.
+  name: Cloud Network Monitoring
 - description: Manage your Datadog Cloudflare integration directly through the Datadog
     API. See the [Cloudflare integration page](https://docs.datadoghq.com/integrations/cloudflare/)
     for more information.

Diff for: docs/datadog_api_client.v2.api.rst

@@ -102,6 +102,13 @@ datadog\_api\_client.v2.api.cloud\_cost\_management\_api module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.api.cloud\_network\_monitoring\_api module
+------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.api.cloud_network_monitoring_api
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.api.cloudflare\_integration\_api module
 ---------------------------------------------------------------
 

Diff for: docs/datadog_api_client.v2.model.rst

@@ -13185,6 +13185,34 @@ datadog\_api\_client.v2.model.service\_now\_ticket\_result module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.single\_aggregated\_connection\_response\_array module
+------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.single_aggregated_connection_response_array
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.single\_aggregated\_connection\_response\_data module
+-----------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.single_aggregated_connection_response_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.single\_aggregated\_connection\_response\_data\_attributes module
+-----------------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.single_aggregated_connection_response_data_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.single\_aggregated\_connection\_response\_data\_type module
+-----------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.single_aggregated_connection_response_data_type
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.slack\_integration\_metadata module
 -----------------------------------------------------------------
 

Diff for: examples/v2/cloud-network-monitoring/GetAggregatedConnections.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)

Diff for: src/datadog_api_client/configuration.py

@@ -277,6 +277,7 @@ def __init__(
                 "v2.list_aws_namespaces": False,
                 "v2.update_aws_account": False,
                 "v2.list_aws_logs_services": False,
+                "v2.get_aggregated_connections": False,
                 "v2.cancel_historical_job": False,
                 "v2.convert_job_result_to_signal": False,
                 "v2.delete_historical_job": False,