Skip to content

Commit 0727fb2

Browse files
author
ci.datadog-api-spec
committed
Regenerate client from commit 754ff74 of spec repo
1 parent 2135f5e commit 0727fb2

16 files changed

+819
-10
lines changed

.generated-info

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
{
2-
"spec_repo_commit": "8ca2883",
3-
"generated": "2025-07-22 07:15:04.416"
2+
"spec_repo_commit": "754ff74",
3+
"generated": "2025-07-22 09:52:30.031"
44
}

.generator/schemas/v2/openapi.yaml

Lines changed: 229 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12925,6 +12925,42 @@ components:
1292512925
description: The type of the resource. The value should always be device.
1292612926
type: string
1292712927
type: object
12928+
DnsMetricKey:
12929+
description: The metric key for DNS metrics.
12930+
enum:
12931+
- dns_total_requests
12932+
- dns_failures
12933+
- dns_successful_responses
12934+
- dns_failed_responses
12935+
- dns_timeouts
12936+
- dns_responses.nxdomain
12937+
- dns_responses.servfail
12938+
- dns_responses.other
12939+
- dns_success_latency_percentile
12940+
- dns_failure_latency_percentile
12941+
type: string
12942+
x-enum-descriptions:
12943+
- The total number of DNS requests made by the client.
12944+
- The total number of timeouts and errors in DNS requests.
12945+
- The total number of successful DNS responses.
12946+
- The total number of failed DNS responses.
12947+
- The total number of DNS timeouts.
12948+
- The total number of DNS responses with the NXDOMAIN error code.
12949+
- The total number of DNS responses with the SERVFAIL error code.
12950+
- The total number of DNS responses with other error codes.
12951+
- The latency percentile for successful DNS responses.
12952+
- The latency percentile for failed DNS responses.
12953+
x-enum-varnames:
12954+
- DNS_TOTAL_REQUESTS
12955+
- DNS_FAILURES
12956+
- DNS_SUCCESSFUL_RESPONSES
12957+
- DNS_FAILED_RESPONSES
12958+
- DNS_TIMEOUTS
12959+
- DNS_RESPONSES_NXDOMAIN
12960+
- DNS_RESPONSES_SERVFAIL
12961+
- DNS_RESPONSES_OTHER
12962+
- DNS_SUCCESS_LATENCY_PERCENTILE
12963+
- DNS_FAILURE_LATENCY_PERCENTILE
1292812964
DomainAllowlist:
1292912965
description: The email domain allowlist for an org.
1293012966
properties:
@@ -38398,6 +38434,134 @@ components:
3839838434
type: string
3839938435
x-enum-varnames:
3840038436
- AGGREGATED_CONNECTION
38437+
SingleAggregatedDnsResponseArray:
38438+
additionalProperties: {}
38439+
description: List of aggregated DNS flows.
38440+
example:
38441+
data:
38442+
- attributes:
38443+
group_bys:
38444+
- key: client_team
38445+
value: networks
38446+
- key: server_service
38447+
value: hucklebuck
38448+
metrics:
38449+
- key: dns_total_requests
38450+
value: 100
38451+
- key: dns_failures
38452+
value: 6
38453+
- key: dns_successful_responses
38454+
value: 95
38455+
- key: dns_failed_responses
38456+
value: 4
38457+
- key: dns_timeouts
38458+
value: 2
38459+
- key: dns_responses.nxdomain
38460+
value: 1
38461+
- key: dns_responses.servfail
38462+
value: 1
38463+
- key: dns_responses.other
38464+
value: 3
38465+
- key: dns_success_latency_percentile
38466+
value: 50
38467+
- key: dns_failure_latency_percentile
38468+
value: 75
38469+
id: client_team:networks, server_service:hucklebuck
38470+
type: aggregated_dns
38471+
properties:
38472+
data:
38473+
description: Array of aggregated DNS objects.
38474+
items:
38475+
$ref: '#/components/schemas/SingleAggregatedDnsResponseData'
38476+
type: array
38477+
type: object
38478+
SingleAggregatedDnsResponseData:
38479+
description: Object describing an aggregated DNS flow.
38480+
properties:
38481+
attributes:
38482+
$ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
38483+
id:
38484+
description: A unique identifier for the aggregated DNS traffic based on
38485+
the group by values.
38486+
example: client_service:example-service,network.dns_query:example.com
38487+
type: string
38488+
type:
38489+
$ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
38490+
example: aggregated_dns
38491+
type: object
38492+
SingleAggregatedDnsResponseDataAttributes:
38493+
description: Attributes for an aggregated DNS flow.
38494+
properties:
38495+
group_bys:
38496+
additionalProperties: {}
38497+
description: The key, value pairs for each group by.
38498+
example:
38499+
- key: client_service
38500+
value: example-service
38501+
- key: network.dns_query
38502+
value: example.com
38503+
items:
38504+
$ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
38505+
type: array
38506+
metrics:
38507+
additionalProperties: {}
38508+
description: Metrics associated with an aggregated DNS flow.
38509+
example:
38510+
- key: dns_total_requests
38511+
value: 100
38512+
- key: dns_failures
38513+
value: 7
38514+
- key: dns_successful_responses
38515+
value: 93
38516+
- key: dns_failed_responses
38517+
value: 5
38518+
- key: dns_timeouts
38519+
value: 2
38520+
- key: dns_responses.nxdomain
38521+
value: 1
38522+
- key: dns_responses.servfail
38523+
value: 1
38524+
- key: dns_responses.other
38525+
value: 3
38526+
- key: dns_success_latency_percentile
38527+
value: 50
38528+
- key: dns_failure_latency_percentile
38529+
value: 76
38530+
items:
38531+
$ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
38532+
type: array
38533+
type: object
38534+
SingleAggregatedDnsResponseDataAttributesGroupByItems:
38535+
description: Attributes associated with a group by
38536+
properties:
38537+
key:
38538+
description: The group by key.
38539+
type: string
38540+
value:
38541+
additionalProperties:
38542+
items:
38543+
type: string
38544+
type: array
38545+
description: The group by value.
38546+
type: object
38547+
SingleAggregatedDnsResponseDataAttributesMetricsItems:
38548+
description: Metrics associated with an aggregated DNS flow.
38549+
properties:
38550+
key:
38551+
$ref: '#/components/schemas/DnsMetricKey'
38552+
value:
38553+
description: The metric value.
38554+
format: int64
38555+
type: integer
38556+
type: object
38557+
SingleAggregatedDnsResponseDataType:
38558+
default: aggregated_dns
38559+
description: Aggregated DNS resource type.
38560+
enum:
38561+
- aggregated_dns
38562+
type: string
38563+
x-enum-varnames:
38564+
- AGGREGATED_DNS
3840138565
SlackIntegrationMetadata:
3840238566
description: Incident integration metadata for the Slack integration.
3840338567
properties:
@@ -55045,6 +55209,69 @@ paths:
5504555209
x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
5504655210

5504755211
contact [Datadog support](https://docs.datadoghq.com/help/).'
55212+
/api/v2/network/dns/aggregate:
55213+
get:
55214+
description: Get all aggregated DNS traffic.
55215+
operationId: GetAggregatedDns
55216+
parameters:
55217+
- description: Unix timestamp (number of seconds since epoch) of the start of
55218+
the query window. If not provided, the start of the query window is 15 minutes
55219+
before the `to` timestamp. If neither `from` nor `to` are provided, the
55220+
query window is `[now - 15m, now]`.
55221+
in: query
55222+
name: from
55223+
schema:
55224+
format: int64
55225+
type: integer
55226+
- description: Unix timestamp (number of seconds since epoch) of the end of
55227+
the query window. If not provided, the end of the query window is the current
55228+
time. If neither `from` nor `to` are provided, the query window is `[now
55229+
- 15m, now]`.
55230+
in: query
55231+
name: to
55232+
schema:
55233+
format: int64
55234+
type: integer
55235+
- description: Comma-separated list of fields to group DNS traffic by. The server
55236+
side defaults to `network.dns_query` if unspecified. `server_ungrouped`
55237+
may be used if groups are not desired. The maximum number of group_by(s)
55238+
is 10.
55239+
in: query
55240+
name: group_by
55241+
schema:
55242+
type: string
55243+
- description: Comma-separated list of tags to filter DNS traffic by.
55244+
in: query
55245+
name: tags
55246+
schema:
55247+
type: string
55248+
- description: The number of aggregated DNS entries to be returned. The maximum
55249+
value is 7500.
55250+
in: query
55251+
name: limit
55252+
schema:
55253+
default: 100
55254+
format: int32
55255+
maximum: 7500
55256+
minimum: 1
55257+
type: integer
55258+
responses:
55259+
'200':
55260+
content:
55261+
application/json:
55262+
schema:
55263+
$ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
55264+
description: OK
55265+
'400':
55266+
$ref: '#/components/responses/BadRequestResponse'
55267+
'429':
55268+
$ref: '#/components/responses/TooManyRequestsResponse'
55269+
summary: Get all aggregated DNS traffic
55270+
tags:
55271+
- Cloud Network Monitoring
55272+
x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55273+
55274+
contact [Datadog support](https://docs.datadoghq.com/help/).'
5504855275
/api/v2/on-call/escalation-policies:
5504955276
post:
5505055277
description: Create a new On-Call escalation policy
@@ -65836,7 +66063,8 @@ tags:
6583666063
documentation](https://docs.datadoghq.com/cloud_cost_management/).
6583766064
name: Cloud Cost Management
6583866065
- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
65839-
and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66066+
and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66067+
and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
6584066068
for more information.
6584166069
name: Cloud Network Monitoring
6584266070
- description: Manage your Datadog Cloudflare integration directly through the Datadog

docs/datadog_api_client.v2.model.rst

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4974,6 +4974,13 @@ datadog\_api\_client.v2.model.devices\_list\_data module
49744974
:members:
49754975
:show-inheritance:
49764976

4977+
datadog\_api\_client.v2.model.dns\_metric\_key module
4978+
-----------------------------------------------------
4979+
4980+
.. automodule:: datadog_api_client.v2.model.dns_metric_key
4981+
:members:
4982+
:show-inheritance:
4983+
49774984
datadog\_api\_client.v2.model.domain\_allowlist module
49784985
------------------------------------------------------
49794986

@@ -16552,6 +16559,48 @@ datadog\_api\_client.v2.model.single\_aggregated\_connection\_response\_data\_ty
1655216559
:members:
1655316560
:show-inheritance:
1655416561

16562+
datadog\_api\_client.v2.model.single\_aggregated\_dns\_response\_array module
16563+
-----------------------------------------------------------------------------
16564+
16565+
.. automodule:: datadog_api_client.v2.model.single_aggregated_dns_response_array
16566+
:members:
16567+
:show-inheritance:
16568+
16569+
datadog\_api\_client.v2.model.single\_aggregated\_dns\_response\_data module
16570+
----------------------------------------------------------------------------
16571+
16572+
.. automodule:: datadog_api_client.v2.model.single_aggregated_dns_response_data
16573+
:members:
16574+
:show-inheritance:
16575+
16576+
datadog\_api\_client.v2.model.single\_aggregated\_dns\_response\_data\_attributes module
16577+
----------------------------------------------------------------------------------------
16578+
16579+
.. automodule:: datadog_api_client.v2.model.single_aggregated_dns_response_data_attributes
16580+
:members:
16581+
:show-inheritance:
16582+
16583+
datadog\_api\_client.v2.model.single\_aggregated\_dns\_response\_data\_attributes\_group\_by\_items module
16584+
----------------------------------------------------------------------------------------------------------
16585+
16586+
.. automodule:: datadog_api_client.v2.model.single_aggregated_dns_response_data_attributes_group_by_items
16587+
:members:
16588+
:show-inheritance:
16589+
16590+
datadog\_api\_client.v2.model.single\_aggregated\_dns\_response\_data\_attributes\_metrics\_items module
16591+
--------------------------------------------------------------------------------------------------------
16592+
16593+
.. automodule:: datadog_api_client.v2.model.single_aggregated_dns_response_data_attributes_metrics_items
16594+
:members:
16595+
:show-inheritance:
16596+
16597+
datadog\_api\_client.v2.model.single\_aggregated\_dns\_response\_data\_type module
16598+
----------------------------------------------------------------------------------
16599+
16600+
.. automodule:: datadog_api_client.v2.model.single_aggregated_dns_response_data_type
16601+
:members:
16602+
:show-inheritance:
16603+
1655516604
datadog\_api\_client.v2.model.slack\_integration\_metadata module
1655616605
-----------------------------------------------------------------
1655716606

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
"""
2+
Get all aggregated DNS traffic returns "OK" response
3+
"""
4+
5+
from datadog_api_client import ApiClient, Configuration
6+
from datadog_api_client.v2.api.cloud_network_monitoring_api import CloudNetworkMonitoringApi
7+
8+
configuration = Configuration()
9+
configuration.unstable_operations["get_aggregated_dns"] = True
10+
with ApiClient(configuration) as api_client:
11+
api_instance = CloudNetworkMonitoringApi(api_client)
12+
response = api_instance.get_aggregated_dns()
13+
14+
print(response)

src/datadog_api_client/configuration.py

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -297,6 +297,7 @@ def __init__(
297297
"v2.validate_existing_monitor_user_template": False,
298298
"v2.validate_monitor_user_template": False,
299299
"v2.get_aggregated_connections": False,
300+
"v2.get_aggregated_dns": False,
300301
"v2.create_pipeline": False,
301302
"v2.delete_pipeline": False,
302303
"v2.get_pipeline": False,

0 commit comments

Comments
 (0)