Skip to content

Commit b5a600e

Browse files
dd-octo-sts[bot]ci.datadog-api-spec
andauthored
Regenerate client from commit 84753a8 of spec repo (#4074)
Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>
1 parent e40546a commit b5a600e

2 files changed

Lines changed: 42 additions & 0 deletions

File tree

‎.generator/schemas/v2/openapi.yaml‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -152020,6 +152020,13 @@ paths:
152020152020
Submit a DDSQL statement and return either a `running` state with an opaque `query_id`
152021152021
for the client to poll, or a `completed` state with the column-major result set inlined
152022152022
when the query finishes quickly enough to be served synchronously.
152023+
152024+
For a scoped application key, include `timeseries_query` in its scopes.
152025+
A query that does not read a data source, such as `SELECT 1`, requires no additional
152026+
data-source permissions. Queries that read data sources also require the user or
152027+
service account that owns the application key to have the corresponding data access
152028+
permissions through their roles. The `timeseries_query` permission does not grant
152029+
access to the underlying data sources.
152023152030
operationId: ExecuteDdsqlTabularQuery
152024152031
requestBody:
152025152032
content:
@@ -152122,16 +152129,30 @@ paths:
152122152129
schema:
152123152130
$ref: "#/components/schemas/JSONAPIErrorResponse"
152124152131
description: Internal Server Error
152132+
security:
152133+
- apiKeyAuth: []
152134+
appKeyAuth: []
152135+
- AuthZ:
152136+
- timeseries_query
152125152137
summary: Execute a tabular DDSQL query
152126152138
tags:
152127152139
- DDSQL
152140+
"x-permission":
152141+
operator: OR
152142+
permissions:
152143+
- timeseries_query
152128152144
/api/v2/ddsql/query/tabular/fetch:
152129152145
post:
152130152146
description: |-
152131152147
Poll a previously submitted DDSQL query for results. Pass the opaque `query_id` returned
152132152148
by a prior `ExecuteDdsqlTabularQuery` (or by a prior `FetchDdsqlTabularQuery` that
152133152149
returned `state: running`) and the server returns either a `running` state to poll again
152134152150
or a `completed` state with the column-major result set inlined.
152151+
152152+
For a scoped application key, include `timeseries_query` in its scopes.
152153+
Fetch results as the same user and organization that submitted the query.
152154+
The user or service account that owns the application key must have the data access
152155+
permissions required by the queried data sources through their roles.
152135152156
operationId: FetchDdsqlTabularQuery
152136152157
requestBody:
152137152158
content:
@@ -152230,9 +152251,18 @@ paths:
152230152251
schema:
152231152252
$ref: "#/components/schemas/JSONAPIErrorResponse"
152232152253
description: Internal Server Error
152254+
security:
152255+
- apiKeyAuth: []
152256+
appKeyAuth: []
152257+
- AuthZ:
152258+
- timeseries_query
152233152259
summary: Fetch the result of a DDSQL query
152234152260
tags:
152235152261
- DDSQL
152262+
"x-permission":
152263+
operator: OR
152264+
permissions:
152265+
- timeseries_query
152236152266
/api/v2/deletion/data/{product}:
152237152267
post:
152238152268
description: Creates a data deletion request by providing a query and a timeframe targeting the proper data.

‎src/datadog_api_client/v2/api/ddsql_api.py‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,13 @@ def execute_ddsql_tabular_query(
7575
for the client to poll, or a ``completed`` state with the column-major result set inlined
7676
when the query finishes quickly enough to be served synchronously.
7777
78+
For a scoped application key, include ``timeseries_query`` in its scopes.
79+
A query that does not read a data source, such as ``SELECT 1`` , requires no additional
80+
data-source permissions. Queries that read data sources also require the user or
81+
service account that owns the application key to have the corresponding data access
82+
permissions through their roles. The ``timeseries_query`` permission does not grant
83+
access to the underlying data sources.
84+
7885
:type body: DdsqlTabularQueryRequest
7986
:rtype: DdsqlTabularQueryResponse
8087
"""
@@ -94,6 +101,11 @@ def fetch_ddsql_tabular_query(
94101
returned ``state: running`` ) and the server returns either a ``running`` state to poll again
95102
or a ``completed`` state with the column-major result set inlined.
96103
104+
For a scoped application key, include ``timeseries_query`` in its scopes.
105+
Fetch results as the same user and organization that submitted the query.
106+
The user or service account that owns the application key must have the data access
107+
permissions required by the queried data sources through their roles.
108+
97109
:type body: DdsqlTabularQueryFetchRequest
98110
:rtype: DdsqlTabularQueryResponse
99111
"""

0 commit comments

Comments
 (0)