Skip to content

Commit 4090154

Browse files
author
ci.datadog-api-spec
committed
Regenerate client from commit f47d1c2f of spec repo
1 parent b133de9 commit 4090154

File tree

8 files changed

+2317
-8
lines changed

8 files changed

+2317
-8
lines changed

.apigentools-info

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,13 @@
44
"spec_versions": {
55
"v1": {
66
"apigentools_version": "1.6.6",
7-
"regenerated": "2025-07-18 16:54:27.438110",
8-
"spec_repo_commit": "0f24b8e5"
7+
"regenerated": "2025-07-18 18:38:48.484484",
8+
"spec_repo_commit": "f47d1c2f"
99
},
1010
"v2": {
1111
"apigentools_version": "1.6.6",
12-
"regenerated": "2025-07-18 16:54:36.732989",
13-
"spec_repo_commit": "0f24b8e5"
12+
"regenerated": "2025-07-18 18:38:57.874179",
13+
"spec_repo_commit": "f47d1c2f"
1414
}
1515
}
1616
}

config/_default/menus/api.en.yaml

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6248,6 +6248,19 @@ menu:
62486248
url: /api/latest/cloud-network-monitoring/
62496249
identifier: cloud-network-monitoring
62506250
generated: true
6251+
- name: Get all aggregated DNS traffic
6252+
url: '#get-all-aggregated-dns-traffic'
6253+
identifier: cloud-network-monitoring-get-all-aggregated-dns-traffic
6254+
parent: cloud-network-monitoring
6255+
generated: true
6256+
params:
6257+
versions:
6258+
- v2
6259+
operationids:
6260+
- GetAggregatedDns
6261+
unstable:
6262+
- v2
6263+
order: 2
62516264
- name: Get all aggregated connections
62526265
url: '#get-all-aggregated-connections'
62536266
identifier: cloud-network-monitoring-get-all-aggregated-connections

content/en/api/v2/cloud-network-monitoring/examples.json

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,5 +50,57 @@
5050
"json": {},
5151
"html": ""
5252
}
53+
},
54+
"GetAggregatedDns": {
55+
"responses": {
56+
"200": {
57+
"json": {
58+
"data": [
59+
{
60+
"attributes": {
61+
"group_bys": [
62+
{
63+
"key": "network.dns_query",
64+
"value": {
65+
"<any-key>": []
66+
}
67+
}
68+
],
69+
"metrics": [
70+
{
71+
"key": "dns_failure_latency_percentile",
72+
"value": 75
73+
}
74+
]
75+
},
76+
"id": "client_service:example-service,network.dns_query:example.com",
77+
"type": "aggregated_dns"
78+
}
79+
]
80+
},
81+
"html": "<div class=\"\"><div class=\"row hasChildData \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row js-collapse-trigger collapse-trigger \">\n <div class=\"col-4 column\">\n <p class=\"key\"><span class=\"toggle-arrow\"><svg width=\"6\" height=\"9\" viewBox=\"0 0 6 9\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M4.7294 4.45711L0.733399 7.82311L1.1294 8.29111L5.6654 4.45711L1.1294 0.641113L0.751398 1.12711L4.7294 4.45711Z\" fill=\"black\"/></svg></span> data</p>\n </div>\n <div class=\"col-2 column\"><p>[object]</p></div>\n <div class=\"col-6 column\"><p>Array of aggregated DNS objects.</p></div>\n </div>\n <div class=\"row isNested d-none hasChildData \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row js-collapse-trigger collapse-trigger \">\n <div class=\"col-4 column\">\n <p class=\"key\"><span class=\"toggle-arrow\"><svg width=\"6\" height=\"9\" viewBox=\"0 0 6 9\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M4.7294 4.45711L0.733399 7.82311L1.1294 8.29111L5.6654 4.45711L1.1294 0.641113L0.751398 1.12711L4.7294 4.45711Z\" fill=\"black\"/></svg></span> attributes</p>\n </div>\n <div class=\"col-2 column\"><p>object</p></div>\n <div class=\"col-6 column\"><p>Attributes for an aggregated DNS flow.</p></div>\n </div>\n <div class=\"row isNested d-none hasChildData \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row js-collapse-trigger collapse-trigger \">\n <div class=\"col-4 column\">\n <p class=\"key\"><span class=\"toggle-arrow\"><svg width=\"6\" height=\"9\" viewBox=\"0 0 6 9\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M4.7294 4.45711L0.733399 7.82311L1.1294 8.29111L5.6654 4.45711L1.1294 0.641113L0.751398 1.12711L4.7294 4.45711Z\" fill=\"black\"/></svg></span> group_bys</p>\n </div>\n <div class=\"col-2 column\"><p>[object]</p></div>\n <div class=\"col-6 column\"><p>The key, value pairs for each group by.</p></div>\n </div>\n <div class=\"row isNested d-none \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row \">\n <div class=\"col-4 column\">\n <p class=\"key\">key</p>\n </div>\n <div class=\"col-2 column\"><p>string</p></div>\n <div class=\"col-6 column\"><p>The group by key.</p></div>\n </div>\n \n </div>\n </div><div class=\"row isNested d-none hasChildData \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row js-collapse-trigger collapse-trigger \">\n <div class=\"col-4 column\">\n <p class=\"key\"><span class=\"toggle-arrow\"><svg width=\"6\" height=\"9\" viewBox=\"0 0 6 9\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M4.7294 4.45711L0.733399 7.82311L1.1294 8.29111L5.6654 4.45711L1.1294 0.641113L0.751398 1.12711L4.7294 4.45711Z\" fill=\"black\"/></svg></span> value</p>\n </div>\n <div class=\"col-2 column\"><p></p></div>\n <div class=\"col-6 column\"><p>The group by value.</p></div>\n </div>\n <div class=\"row isNested d-none \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row \">\n <div class=\"col-4 column\">\n <p class=\"key\">&lt;any-key&gt;</p>\n </div>\n <div class=\"col-2 column\"><p>[string]</p></div>\n <div class=\"col-6 column\"></div>\n </div>\n \n </div>\n </div>\n </div>\n </div>\n </div>\n </div><div class=\"row isNested d-none hasChildData \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row js-collapse-trigger collapse-trigger \">\n <div class=\"col-4 column\">\n <p class=\"key\"><span class=\"toggle-arrow\"><svg width=\"6\" height=\"9\" viewBox=\"0 0 6 9\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M4.7294 4.45711L0.733399 7.82311L1.1294 8.29111L5.6654 4.45711L1.1294 0.641113L0.751398 1.12711L4.7294 4.45711Z\" fill=\"black\"/></svg></span> metrics</p>\n </div>\n <div class=\"col-2 column\"><p>[object]</p></div>\n <div class=\"col-6 column\"><p>Metrics associated with an aggregated DNS flow.</p></div>\n </div>\n <div class=\"row isNested d-none \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row \">\n <div class=\"col-4 column\">\n <p class=\"key\">key</p>\n </div>\n <div class=\"col-2 column\"><p>enum</p></div>\n <div class=\"col-6 column\"><p>The metric key for DNS metrics. \nAllowed enum values: <code>dns_total_requests,dns_failures,dns_successful_responses,dns_failed_responses,dns_timeouts,dns_responses.nxdomain,dns_responses.servfail,dns_responses.other,dns_success_latency_percentile,dns_failure_latency_percentile</code></p></div>\n </div>\n \n </div>\n </div><div class=\"row isNested d-none \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row \">\n <div class=\"col-4 column\">\n <p class=\"key\">value</p>\n </div>\n <div class=\"col-2 column\"><p>int64</p></div>\n <div class=\"col-6 column\"><p>The metric value.</p></div>\n </div>\n \n </div>\n </div>\n </div>\n </div>\n </div>\n </div><div class=\"row isNested d-none \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row \">\n <div class=\"col-4 column\">\n <p class=\"key\">id</p>\n </div>\n <div class=\"col-2 column\"><p>string</p></div>\n <div class=\"col-6 column\"><p>A unique identifier for the aggregated DNS traffic based on the group by values.</p></div>\n </div>\n \n </div>\n </div><div class=\"row isNested d-none \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row \">\n <div class=\"col-4 column\">\n <p class=\"key\">type</p>\n </div>\n <div class=\"col-2 column\"><p>enum</p></div>\n <div class=\"col-6 column\"><p>Aggregated DNS resource type. \nAllowed enum values: <code>aggregated_dns</code></p><p>default: <code>aggregated_dns</code></p></div>\n </div>\n \n </div>\n </div>\n </div>\n </div></div>"
82+
},
83+
"400": {
84+
"json": {
85+
"errors": [
86+
"Bad Request"
87+
]
88+
},
89+
"html": "<div class=\"\"><div class=\"row \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row \">\n <div class=\"col-4 column\">\n <p class=\"key\">errors&nbsp;[<em>required</em>]</p>\n </div>\n <div class=\"col-2 column\"><p>[string]</p></div>\n <div class=\"col-6 column\"><p>A list of errors.</p></div>\n </div>\n \n </div>\n </div></div>"
90+
},
91+
"429": {
92+
"json": {
93+
"errors": [
94+
"Bad Request"
95+
]
96+
},
97+
"html": "<div class=\"\"><div class=\"row \">\n <div class=\"col-12 first-column\">\n <div class=\"row first-row \">\n <div class=\"col-4 column\">\n <p class=\"key\">errors&nbsp;[<em>required</em>]</p>\n </div>\n <div class=\"col-2 column\"><p>[string]</p></div>\n <div class=\"col-6 column\"><p>A list of errors.</p></div>\n </div>\n \n </div>\n </div></div>"
98+
}
99+
},
100+
"request": {
101+
"json_curl": {},
102+
"json": {},
103+
"html": ""
104+
}
53105
}
54106
}

data/api/v2/full_spec.yaml

Lines changed: 229 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12789,6 +12789,42 @@ components:
1278912789
description: The type of the resource. The value should always be device.
1279012790
type: string
1279112791
type: object
12792+
DnsMetricKey:
12793+
description: The metric key for DNS metrics.
12794+
enum:
12795+
- dns_total_requests
12796+
- dns_failures
12797+
- dns_successful_responses
12798+
- dns_failed_responses
12799+
- dns_timeouts
12800+
- dns_responses.nxdomain
12801+
- dns_responses.servfail
12802+
- dns_responses.other
12803+
- dns_success_latency_percentile
12804+
- dns_failure_latency_percentile
12805+
type: string
12806+
x-enum-descriptions:
12807+
- The total number of DNS requests made by the client.
12808+
- The total number of timeouts and errors in DNS requests.
12809+
- The total number of successful DNS responses.
12810+
- The total number of failed DNS responses.
12811+
- The total number of DNS timeouts.
12812+
- The total number of DNS responses with the NXDOMAIN error code.
12813+
- The total number of DNS responses with the SERVFAIL error code.
12814+
- The total number of DNS responses with other error codes.
12815+
- The latency percentile for successful DNS responses.
12816+
- The latency percentile for failed DNS responses.
12817+
x-enum-varnames:
12818+
- DNS_TOTAL_REQUESTS
12819+
- DNS_FAILURES
12820+
- DNS_SUCCESSFUL_RESPONSES
12821+
- DNS_FAILED_RESPONSES
12822+
- DNS_TIMEOUTS
12823+
- DNS_RESPONSES_NXDOMAIN
12824+
- DNS_RESPONSES_SERVFAIL
12825+
- DNS_RESPONSES_OTHER
12826+
- DNS_SUCCESS_LATENCY_PERCENTILE
12827+
- DNS_FAILURE_LATENCY_PERCENTILE
1279212828
DomainAllowlist:
1279312829
description: The email domain allowlist for an org.
1279412830
properties:
@@ -39059,6 +39095,131 @@ components:
3905939095
type: string
3906039096
x-enum-varnames:
3906139097
- AGGREGATED_CONNECTION
39098+
SingleAggregatedDnsResponseArray:
39099+
description: List of aggregated DNS flows.
39100+
example:
39101+
data:
39102+
- attributes:
39103+
group_bys:
39104+
- key: client_team
39105+
value: networks
39106+
- key: server_service
39107+
value: hucklebuck
39108+
metrics:
39109+
- key: dns_total_requests
39110+
value: 100
39111+
- key: dns_failures
39112+
value: 6
39113+
- key: dns_successful_responses
39114+
value: 95
39115+
- key: dns_failed_responses
39116+
value: 4
39117+
- key: dns_timeouts
39118+
value: 2
39119+
- key: dns_responses.nxdomain
39120+
value: 1
39121+
- key: dns_responses.servfail
39122+
value: 1
39123+
- key: dns_responses.other
39124+
value: 3
39125+
- key: dns_success_latency_percentile
39126+
value: 50
39127+
- key: dns_failure_latency_percentile
39128+
value: 75
39129+
id: client_team:networks, server_service:hucklebuck
39130+
type: aggregated_dns
39131+
properties:
39132+
data:
39133+
description: Array of aggregated DNS objects.
39134+
items:
39135+
$ref: '#/components/schemas/SingleAggregatedDnsResponseData'
39136+
type: array
39137+
type: object
39138+
SingleAggregatedDnsResponseData:
39139+
description: Object describing an aggregated DNS flow.
39140+
properties:
39141+
attributes:
39142+
$ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
39143+
id:
39144+
description: A unique identifier for the aggregated DNS traffic based on
39145+
the group by values.
39146+
example: client_service:example-service,network.dns_query:example.com
39147+
type: string
39148+
type:
39149+
$ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
39150+
example: aggregated_dns
39151+
type: object
39152+
SingleAggregatedDnsResponseDataAttributes:
39153+
description: Attributes for an aggregated DNS flow.
39154+
properties:
39155+
group_bys:
39156+
description: The key, value pairs for each group by.
39157+
example:
39158+
- key: client_service
39159+
value: example-service
39160+
- key: network.dns_query
39161+
value: example.com
39162+
items:
39163+
$ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
39164+
type: array
39165+
metrics:
39166+
description: Metrics associated with an aggregated DNS flow.
39167+
example:
39168+
- key: dns_total_requests
39169+
value: 100
39170+
- key: dns_failures
39171+
value: 7
39172+
- key: dns_successful_responses
39173+
value: 93
39174+
- key: dns_failed_responses
39175+
value: 5
39176+
- key: dns_timeouts
39177+
value: 2
39178+
- key: dns_responses.nxdomain
39179+
value: 1
39180+
- key: dns_responses.servfail
39181+
value: 1
39182+
- key: dns_responses.other
39183+
value: 3
39184+
- key: dns_success_latency_percentile
39185+
value: 50
39186+
- key: dns_failure_latency_percentile
39187+
value: 75
39188+
items:
39189+
$ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
39190+
type: array
39191+
type: object
39192+
SingleAggregatedDnsResponseDataAttributesGroupByItems:
39193+
description: Attributes associated with a group by
39194+
properties:
39195+
key:
39196+
description: The group by key.
39197+
type: string
39198+
value:
39199+
additionalProperties:
39200+
items:
39201+
type: string
39202+
type: array
39203+
description: The group by value.
39204+
type: object
39205+
SingleAggregatedDnsResponseDataAttributesMetricsItems:
39206+
description: Metrics associated with an aggregated DNS flow.
39207+
properties:
39208+
key:
39209+
$ref: '#/components/schemas/DnsMetricKey'
39210+
value:
39211+
description: The metric value.
39212+
format: int64
39213+
type: integer
39214+
type: object
39215+
SingleAggregatedDnsResponseDataType:
39216+
default: aggregated_dns
39217+
description: Aggregated DNS resource type.
39218+
enum:
39219+
- aggregated_dns
39220+
type: string
39221+
x-enum-varnames:
39222+
- AGGREGATED_DNS
3906239223
SlackIntegrationMetadata:
3906339224
description: Incident integration metadata for the Slack integration.
3906439225
properties:
@@ -57562,6 +57723,72 @@ paths:
5756257723
x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
5756357724

5756457725
contact [Datadog support](https://docs.datadoghq.com/help/).'
57726+
/api/v2/network/dns/aggregate:
57727+
get:
57728+
description: Get all aggregated DNS traffic.
57729+
operationId: GetAggregatedDns
57730+
parameters:
57731+
- description: Unix timestamp (number of seconds since epoch) of the start of
57732+
the query window. If not provided, the start of the query window is 15 minutes
57733+
before the `to` timestamp. If neither `from` nor `to` are provided, the
57734+
query window is `[now - 15m, now]`.
57735+
in: query
57736+
name: from
57737+
schema:
57738+
format: int64
57739+
type: integer
57740+
- description: Unix timestamp (number of seconds since epoch) of the end of
57741+
the query window. If not provided, the end of the query window is the current
57742+
time. If neither `from` nor `to` are provided, the query window is `[now
57743+
- 15m, now]`.
57744+
in: query
57745+
name: to
57746+
schema:
57747+
format: int64
57748+
type: integer
57749+
- description: Comma-separated list of fields to group DNS traffic by. The server
57750+
side defaults to `network.dns_query` if unspecified. `server_ungrouped`
57751+
may be used if groups are not desired. The maximum number of group_by(s)
57752+
is 10.
57753+
in: query
57754+
name: group_by
57755+
schema:
57756+
type: string
57757+
- description: Comma-separated list of tags to filter DNS traffic by.
57758+
in: query
57759+
name: tags
57760+
schema:
57761+
type: string
57762+
- description: The number of aggregated DNS entries to be returned. The maximum
57763+
value is 7500.
57764+
in: query
57765+
name: limit
57766+
schema:
57767+
default: 100
57768+
format: int32
57769+
maximum: 7500
57770+
minimum: 1
57771+
type: integer
57772+
responses:
57773+
'200':
57774+
content:
57775+
application/json:
57776+
schema:
57777+
$ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
57778+
description: OK
57779+
'400':
57780+
$ref: '#/components/responses/BadRequestResponse'
57781+
'429':
57782+
$ref: '#/components/responses/TooManyRequestsResponse'
57783+
summary: Get all aggregated DNS traffic
57784+
tags:
57785+
- Cloud Network Monitoring
57786+
x-menu-order: 2
57787+
x-undo:
57788+
type: safe
57789+
x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
57790+
57791+
contact [Datadog support](https://docs.datadoghq.com/help/).'
5756557792
/api/v2/on-call/escalation-policies:
5756657793
post:
5756757794
description: Create a new On-Call escalation policy
@@ -70287,7 +70514,8 @@ tags:
7028770514
documentation](https://docs.datadoghq.com/cloud_cost_management/).
7028870515
name: Cloud Cost Management
7028970516
- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
70290-
and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
70517+
and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
70518+
and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
7029170519
for more information.
7029270520
name: Cloud Network Monitoring
7029370521
- description: Manage your Datadog Cloudflare integration directly through the Datadog

0 commit comments

Comments
 (0)