Skip to content

Commit dbdf517

Browse files
author
ci.datadog-api-spec
committed
Regenerate client from commit 8a819e76 of spec repo
1 parent a0b2b2d commit dbdf517

14 files changed

+452
-5
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-02-19 19:09:52.950548",
8-
"spec_repo_commit": "f0e5fdcf"
7+
"regenerated": "2025-02-19 20:36:02.703381",
8+
"spec_repo_commit": "8a819e76"
99
},
1010
"v2": {
1111
"apigentools_version": "1.6.6",
12-
"regenerated": "2025-02-19 19:09:52.967553",
13-
"spec_repo_commit": "f0e5fdcf"
12+
"regenerated": "2025-02-19 20:36:02.717685",
13+
"spec_repo_commit": "8a819e76"
1414
}
1515
}
1616
}

‎.generator/schemas/v1/openapi.yaml

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17340,11 +17340,13 @@ components:
1734017340
enum:
1734117341
- number
1734217342
- bar
17343+
- trend
1734317344
example: number
1734417345
type: string
1734517346
x-enum-varnames:
1734617347
- NUMBER
1734717348
- BAR
17349+
- TREND
1734817350
TableWidgetDefinition:
1734917351
description: The table visualization is available on timeboards and screenboards.
1735017352
It displays columns of metrics grouped by tag key.
@@ -23033,6 +23035,8 @@ components:
2303323035
type: string
2303423036
cell_display_mode:
2303523037
$ref: '#/components/schemas/TableWidgetCellDisplayMode'
23038+
cell_display_mode_options:
23039+
$ref: '#/components/schemas/WidgetFormulaCellDisplayModeOptions'
2303623040
conditional_formats:
2303723041
description: List of conditional formats.
2303823042
items:
@@ -23049,6 +23053,37 @@ components:
2304923053
required:
2305023054
- formula
2305123055
type: object
23056+
WidgetFormulaCellDisplayModeOptions:
23057+
description: Cell display mode options for the widget formula. (only if `cell_display_mode`
23058+
is set to `trend`).
23059+
properties:
23060+
trend_type:
23061+
$ref: '#/components/schemas/WidgetFormulaCellDisplayModeOptionsTrendType'
23062+
y_scale:
23063+
$ref: '#/components/schemas/WidgetFormulaCellDisplayModeOptionsYScale'
23064+
type: object
23065+
WidgetFormulaCellDisplayModeOptionsTrendType:
23066+
description: Trend type for the cell display mode options.
23067+
enum:
23068+
- area
23069+
- line
23070+
- bars
23071+
example: area
23072+
type: string
23073+
x-enum-varnames:
23074+
- AREA
23075+
- LINE
23076+
- BARS
23077+
WidgetFormulaCellDisplayModeOptionsYScale:
23078+
description: Y scale for the cell display mode options.
23079+
enum:
23080+
- shared
23081+
- independent
23082+
example: shared
23083+
type: string
23084+
x-enum-varnames:
23085+
- SHARED
23086+
- INDEPENDENT
2305223087
WidgetFormulaLimit:
2305323088
description: Options for limiting results returned.
2305423089
properties:

‎docs/datadog_api_client.v1.model.rst

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6136,6 +6136,27 @@ datadog\_api\_client.v1.model.widget\_formula module
61366136
:members:
61376137
:show-inheritance:
61386138

6139+
datadog\_api\_client.v1.model.widget\_formula\_cell\_display\_mode\_options module
6140+
----------------------------------------------------------------------------------
6141+
6142+
.. automodule:: datadog_api_client.v1.model.widget_formula_cell_display_mode_options
6143+
:members:
6144+
:show-inheritance:
6145+
6146+
datadog\_api\_client.v1.model.widget\_formula\_cell\_display\_mode\_options\_trend\_type module
6147+
-----------------------------------------------------------------------------------------------
6148+
6149+
.. automodule:: datadog_api_client.v1.model.widget_formula_cell_display_mode_options_trend_type
6150+
:members:
6151+
:show-inheritance:
6152+
6153+
datadog\_api\_client.v1.model.widget\_formula\_cell\_display\_mode\_options\_y\_scale module
6154+
--------------------------------------------------------------------------------------------
6155+
6156+
.. automodule:: datadog_api_client.v1.model.widget_formula_cell_display_mode_options_y_scale
6157+
:members:
6158+
:show-inheritance:
6159+
61396160
datadog\_api\_client.v1.model.widget\_formula\_limit module
61406161
-----------------------------------------------------------
61416162

‎examples/v1/dashboards/CreateDashboard_1490099434.py

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
"""
2+
Create a new dashboard with query_table widget and cell_display_mode is trend
3+
"""
4+
5+
from datadog_api_client import ApiClient, Configuration
6+
from datadog_api_client.v1.api.dashboards_api import DashboardsApi
7+
from datadog_api_client.v1.model.dashboard import Dashboard
8+
from datadog_api_client.v1.model.dashboard_layout_type import DashboardLayoutType
9+
from datadog_api_client.v1.model.formula_and_function_metric_aggregation import FormulaAndFunctionMetricAggregation
10+
from datadog_api_client.v1.model.formula_and_function_metric_data_source import FormulaAndFunctionMetricDataSource
11+
from datadog_api_client.v1.model.formula_and_function_metric_query_definition import (
12+
FormulaAndFunctionMetricQueryDefinition,
13+
)
14+
from datadog_api_client.v1.model.formula_and_function_response_format import FormulaAndFunctionResponseFormat
15+
from datadog_api_client.v1.model.formula_type import FormulaType
16+
from datadog_api_client.v1.model.table_widget_cell_display_mode import TableWidgetCellDisplayMode
17+
from datadog_api_client.v1.model.table_widget_definition import TableWidgetDefinition
18+
from datadog_api_client.v1.model.table_widget_definition_type import TableWidgetDefinitionType
19+
from datadog_api_client.v1.model.table_widget_has_search_bar import TableWidgetHasSearchBar
20+
from datadog_api_client.v1.model.table_widget_request import TableWidgetRequest
21+
from datadog_api_client.v1.model.widget import Widget
22+
from datadog_api_client.v1.model.widget_formula import WidgetFormula
23+
from datadog_api_client.v1.model.widget_formula_cell_display_mode_options import WidgetFormulaCellDisplayModeOptions
24+
from datadog_api_client.v1.model.widget_formula_cell_display_mode_options_trend_type import (
25+
WidgetFormulaCellDisplayModeOptionsTrendType,
26+
)
27+
from datadog_api_client.v1.model.widget_formula_cell_display_mode_options_y_scale import (
28+
WidgetFormulaCellDisplayModeOptionsYScale,
29+
)
30+
from datadog_api_client.v1.model.widget_formula_sort import WidgetFormulaSort
31+
from datadog_api_client.v1.model.widget_layout import WidgetLayout
32+
from datadog_api_client.v1.model.widget_legacy_live_span import WidgetLegacyLiveSpan
33+
from datadog_api_client.v1.model.widget_sort import WidgetSort
34+
from datadog_api_client.v1.model.widget_sort_by import WidgetSortBy
35+
from datadog_api_client.v1.model.widget_text_align import WidgetTextAlign
36+
37+
body = Dashboard(
38+
title="Example-Dashboard",
39+
description="",
40+
widgets=[
41+
Widget(
42+
layout=WidgetLayout(
43+
x=0,
44+
y=0,
45+
width=54,
46+
height=32,
47+
),
48+
definition=TableWidgetDefinition(
49+
title="",
50+
title_size="16",
51+
title_align=WidgetTextAlign.LEFT,
52+
time=WidgetLegacyLiveSpan(),
53+
type=TableWidgetDefinitionType.QUERY_TABLE,
54+
requests=[
55+
TableWidgetRequest(
56+
queries=[
57+
FormulaAndFunctionMetricQueryDefinition(
58+
data_source=FormulaAndFunctionMetricDataSource.METRICS,
59+
name="query1",
60+
query="avg:system.cpu.user{*} by {host}",
61+
aggregator=FormulaAndFunctionMetricAggregation.AVG,
62+
),
63+
],
64+
formulas=[
65+
WidgetFormula(
66+
formula="query1",
67+
conditional_formats=[],
68+
cell_display_mode=TableWidgetCellDisplayMode.TREND,
69+
cell_display_mode_options=WidgetFormulaCellDisplayModeOptions(
70+
trend_type=WidgetFormulaCellDisplayModeOptionsTrendType.LINE,
71+
y_scale=WidgetFormulaCellDisplayModeOptionsYScale.SHARED,
72+
),
73+
),
74+
],
75+
sort=WidgetSortBy(
76+
count=500,
77+
order_by=[
78+
WidgetFormulaSort(
79+
type=FormulaType.FORMULA,
80+
index=0,
81+
order=WidgetSort.DESCENDING,
82+
),
83+
],
84+
),
85+
response_format=FormulaAndFunctionResponseFormat.SCALAR,
86+
),
87+
],
88+
has_search_bar=TableWidgetHasSearchBar.AUTO,
89+
),
90+
),
91+
],
92+
template_variables=[],
93+
layout_type=DashboardLayoutType.FREE,
94+
notify_list=[],
95+
)
96+
97+
configuration = Configuration()
98+
with ApiClient(configuration) as api_client:
99+
api_instance = DashboardsApi(api_client)
100+
response = api_instance.create_dashboard(body=body)
101+
102+
print(response)

‎src/datadog_api_client/v1/model/table_widget_cell_display_mode.py

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,16 +16,18 @@ class TableWidgetCellDisplayMode(ModelSimple):
1616
"""
1717
Define a display mode for the table cell.
1818
19-
:param value: Must be one of ["number", "bar"].
19+
:param value: Must be one of ["number", "bar", "trend"].
2020
:type value: str
2121
"""
2222

2323
allowed_values = {
2424
"number",
2525
"bar",
26+
"trend",
2627
}
2728
NUMBER: ClassVar["TableWidgetCellDisplayMode"]
2829
BAR: ClassVar["TableWidgetCellDisplayMode"]
30+
TREND: ClassVar["TableWidgetCellDisplayMode"]
2931

3032
@cached_property
3133
def openapi_types(_):
@@ -36,3 +38,4 @@ def openapi_types(_):
3638

3739
TableWidgetCellDisplayMode.NUMBER = TableWidgetCellDisplayMode("number")
3840
TableWidgetCellDisplayMode.BAR = TableWidgetCellDisplayMode("bar")
41+
TableWidgetCellDisplayMode.TREND = TableWidgetCellDisplayMode("trend")

‎src/datadog_api_client/v1/model/widget_formula.py

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@
1515

1616
if TYPE_CHECKING:
1717
from datadog_api_client.v1.model.table_widget_cell_display_mode import TableWidgetCellDisplayMode
18+
from datadog_api_client.v1.model.widget_formula_cell_display_mode_options import WidgetFormulaCellDisplayModeOptions
1819
from datadog_api_client.v1.model.widget_conditional_format import WidgetConditionalFormat
1920
from datadog_api_client.v1.model.widget_formula_limit import WidgetFormulaLimit
2021
from datadog_api_client.v1.model.widget_formula_style import WidgetFormulaStyle
@@ -24,13 +25,17 @@ class WidgetFormula(ModelNormal):
2425
@cached_property
2526
def openapi_types(_):
2627
from datadog_api_client.v1.model.table_widget_cell_display_mode import TableWidgetCellDisplayMode
28+
from datadog_api_client.v1.model.widget_formula_cell_display_mode_options import (
29+
WidgetFormulaCellDisplayModeOptions,
30+
)
2731
from datadog_api_client.v1.model.widget_conditional_format import WidgetConditionalFormat
2832
from datadog_api_client.v1.model.widget_formula_limit import WidgetFormulaLimit
2933
from datadog_api_client.v1.model.widget_formula_style import WidgetFormulaStyle
3034

3135
return {
3236
"alias": (str,),
3337
"cell_display_mode": (TableWidgetCellDisplayMode,),
38+
"cell_display_mode_options": (WidgetFormulaCellDisplayModeOptions,),
3439
"conditional_formats": ([WidgetConditionalFormat],),
3540
"formula": (str,),
3641
"limit": (WidgetFormulaLimit,),
@@ -40,6 +45,7 @@ def openapi_types(_):
4045
attribute_map = {
4146
"alias": "alias",
4247
"cell_display_mode": "cell_display_mode",
48+
"cell_display_mode_options": "cell_display_mode_options",
4349
"conditional_formats": "conditional_formats",
4450
"formula": "formula",
4551
"limit": "limit",
@@ -51,6 +57,7 @@ def __init__(
5157
formula: str,
5258
alias: Union[str, UnsetType] = unset,
5359
cell_display_mode: Union[TableWidgetCellDisplayMode, UnsetType] = unset,
60+
cell_display_mode_options: Union[WidgetFormulaCellDisplayModeOptions, UnsetType] = unset,
5461
conditional_formats: Union[List[WidgetConditionalFormat], UnsetType] = unset,
5562
limit: Union[WidgetFormulaLimit, UnsetType] = unset,
5663
style: Union[WidgetFormulaStyle, UnsetType] = unset,
@@ -65,6 +72,9 @@ def __init__(
6572
:param cell_display_mode: Define a display mode for the table cell.
6673
:type cell_display_mode: TableWidgetCellDisplayMode, optional
6774
75+
:param cell_display_mode_options: Cell display mode options for the widget formula. (only if ``cell_display_mode`` is set to ``trend`` ).
76+
:type cell_display_mode_options: WidgetFormulaCellDisplayModeOptions, optional
77+
6878
:param conditional_formats: List of conditional formats.
6979
:type conditional_formats: [WidgetConditionalFormat], optional
7080
@@ -81,6 +91,8 @@ def __init__(
8191
kwargs["alias"] = alias
8292
if cell_display_mode is not unset:
8393
kwargs["cell_display_mode"] = cell_display_mode
94+
if cell_display_mode_options is not unset:
95+
kwargs["cell_display_mode_options"] = cell_display_mode_options
8496
if conditional_formats is not unset:
8597
kwargs["conditional_formats"] = conditional_formats
8698
if limit is not unset:

‎src/datadog_api_client/v1/model/widget_formula_cell_display_mode_options.py

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
2+
# This product includes software developed at Datadog (https://www.datadoghq.com/).
3+
# Copyright 2019-Present Datadog, Inc.
4+
from __future__ import annotations
5+
6+
from typing import Union, TYPE_CHECKING
7+
8+
from datadog_api_client.model_utils import (
9+
ModelNormal,
10+
cached_property,
11+
unset,
12+
UnsetType,
13+
)
14+
15+
16+
if TYPE_CHECKING:
17+
from datadog_api_client.v1.model.widget_formula_cell_display_mode_options_trend_type import (
18+
WidgetFormulaCellDisplayModeOptionsTrendType,
19+
)
20+
from datadog_api_client.v1.model.widget_formula_cell_display_mode_options_y_scale import (
21+
WidgetFormulaCellDisplayModeOptionsYScale,
22+
)
23+
24+
25+
class WidgetFormulaCellDisplayModeOptions(ModelNormal):
26+
@cached_property
27+
def openapi_types(_):
28+
from datadog_api_client.v1.model.widget_formula_cell_display_mode_options_trend_type import (
29+
WidgetFormulaCellDisplayModeOptionsTrendType,
30+
)
31+
from datadog_api_client.v1.model.widget_formula_cell_display_mode_options_y_scale import (
32+
WidgetFormulaCellDisplayModeOptionsYScale,
33+
)
34+
35+
return {
36+
"trend_type": (WidgetFormulaCellDisplayModeOptionsTrendType,),
37+
"y_scale": (WidgetFormulaCellDisplayModeOptionsYScale,),
38+
}
39+
40+
attribute_map = {
41+
"trend_type": "trend_type",
42+
"y_scale": "y_scale",
43+
}
44+
45+
def __init__(
46+
self_,
47+
trend_type: Union[WidgetFormulaCellDisplayModeOptionsTrendType, UnsetType] = unset,
48+
y_scale: Union[WidgetFormulaCellDisplayModeOptionsYScale, UnsetType] = unset,
49+
**kwargs,
50+
):
51+
"""
52+
Cell display mode options for the widget formula. (only if ``cell_display_mode`` is set to ``trend`` ).
53+
54+
:param trend_type: Trend type for the cell display mode options.
55+
:type trend_type: WidgetFormulaCellDisplayModeOptionsTrendType, optional
56+
57+
:param y_scale: Y scale for the cell display mode options.
58+
:type y_scale: WidgetFormulaCellDisplayModeOptionsYScale, optional
59+
"""
60+
if trend_type is not unset:
61+
kwargs["trend_type"] = trend_type
62+
if y_scale is not unset:
63+
kwargs["y_scale"] = y_scale
64+
super().__init__(kwargs)

0 commit comments

Comments
 (0)