datadog_api_client 2.0.2 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (192) hide show
  1. checksums.yaml +4 -4
  2. data/.apigentools-info +6 -6
  3. data/.generator/poetry.lock +21 -14
  4. data/.generator/pyproject.toml +1 -1
  5. data/.generator/schemas/v1/openapi.yaml +840 -908
  6. data/.generator/schemas/v2/openapi.yaml +1304 -913
  7. data/.generator/src/generator/formatter.py +1 -1
  8. data/.generator/src/generator/templates/api_client.j2 +5 -1
  9. data/.generator/src/generator/templates/configuration.j2 +17 -0
  10. data/.github/workflows/test.yml +4 -1
  11. data/.github/workflows/test_integration.yml +5 -0
  12. data/.pre-commit-config.yaml +1 -1
  13. data/CHANGELOG.md +49 -0
  14. data/README.md +11 -0
  15. data/examples/v1/dashboards/CreateDashboard_1094917386.rb +37 -0
  16. data/examples/v1/dashboards/CreateDashboard_1307120899.rb +61 -0
  17. data/examples/v1/dashboards/CreateDashboard_1423904722.rb +38 -0
  18. data/examples/v1/dashboards/CreateDashboard_2652180930.rb +43 -0
  19. data/examples/v1/dashboards/CreateDashboard_2850365602.rb +55 -0
  20. data/examples/v1/dashboards/CreateDashboard_3117424216.rb +33 -0
  21. data/examples/v1/dashboards/CreateDashboard_3669695268.rb +50 -0
  22. data/examples/v1/dashboards/CreateDashboard_858397694.rb +41 -0
  23. data/examples/v1/monitors/ValidateExistingMonitor.rb +1 -0
  24. data/examples/v1/monitors/ValidateMonitor.rb +1 -0
  25. data/examples/v1/monitors/ValidateMonitor_4247196452.rb +38 -0
  26. data/examples/v1/synthetics/CreateGlobalVariable.rb +1 -0
  27. data/examples/v1/synthetics/CreateGlobalVariable_1068962881.rb +23 -0
  28. data/examples/v1/synthetics/CreateSyntheticsAPITest_1279271422.rb +10 -0
  29. data/examples/v1/synthetics/CreateSyntheticsBrowserTest_2932742688.rb +6 -0
  30. data/examples/v1/synthetics/EditGlobalVariable.rb +1 -0
  31. data/examples/v1/synthetics/UpdateBrowserTest.rb +1 -0
  32. data/examples/v1/usage-metering/GetDailyCustomReports.rb +0 -3
  33. data/examples/v1/usage-metering/GetMonthlyCustomReports.rb +0 -3
  34. data/examples/v1/usage-metering/GetSpecifiedDailyCustomReports.rb +0 -3
  35. data/examples/v1/usage-metering/GetSpecifiedMonthlyCustomReports.rb +0 -3
  36. data/examples/v1/usage-metering/GetUsageAttribution.rb +0 -3
  37. data/examples/v2/incidents/ListIncidentAttachments.rb +8 -0
  38. data/examples/v2/incidents/ListIncidentAttachments_2457735435.rb +11 -0
  39. data/examples/v2/incidents/UpdateIncidentAttachments.rb +38 -0
  40. data/examples/v2/incidents/UpdateIncidentAttachments_3881702075.rb +26 -0
  41. data/examples/v2/metrics/ListActiveMetricConfigurations.rb +5 -0
  42. data/examples/v2/metrics/ListTagConfigurations.rb +1 -1
  43. data/examples/v2/metrics/ListTagConfigurations_265033704.rb +8 -0
  44. data/examples/v2/metrics/{ListTagConfigurations_103226315.rb → ListTagConfigurations_2739018321.rb} +1 -1
  45. data/examples/v2/metrics/SubmitMetrics_1762007427.rb +23 -0
  46. data/examples/v2/roles/UpdateRole.rb +13 -0
  47. data/examples/v2/rum/CreateRUMApplication.rb +15 -0
  48. data/examples/v2/rum/DeleteRUMApplication.rb +8 -0
  49. data/examples/v2/rum/GetRUMApplication.rb +8 -0
  50. data/examples/v2/rum/GetRUMApplications.rb +5 -0
  51. data/examples/v2/rum/UpdateRUMApplication.rb +16 -0
  52. data/examples/v2/security-monitoring/CreateSecurityMonitoringRule.rb +3 -2
  53. data/examples/v2/security-monitoring/CreateSecurityMonitoringRule_461183901.rb +2 -2
  54. data/examples/v2/security-monitoring/CreateSecurityMonitoringRule_498211763.rb +2 -2
  55. data/examples/v2/security-monitoring/CreateSecurityMonitoringRule_914562040.rb +50 -0
  56. data/examples/v2/security-monitoring/GetSecurityMonitoringSignal.rb +5 -0
  57. data/examples/v2/security-monitoring/UpdateSecurityMonitoringRule.rb +2 -1
  58. data/examples/v2/usage-metering/GetEstimatedCostByOrg.rb +1 -4
  59. data/examples/v2/usage-metering/GetEstimatedCostByOrg_2734954020.rb +2 -4
  60. data/examples/v2/usage-metering/GetEstimatedCostByOrg_3186693804.rb +2 -4
  61. data/examples/v2/usage-metering/GetHistoricalCostByOrg.rb +8 -0
  62. data/examples/v2/usage-metering/GetHourlyUsage.rb +5 -0
  63. data/generate.sh +30 -0
  64. data/lib/datadog_api_client/api_client.rb +5 -1
  65. data/lib/datadog_api_client/configuration.rb +20 -6
  66. data/lib/datadog_api_client/inflector.rb +67 -1
  67. data/lib/datadog_api_client/v1/api/metrics_api.rb +1 -1
  68. data/lib/datadog_api_client/v1/api/service_level_objectives_api.rb +3 -1
  69. data/lib/datadog_api_client/v1/api/usage_metering_api.rb +42 -62
  70. data/lib/datadog_api_client/v1/models/dashboard_template_variable.rb +14 -2
  71. data/lib/datadog_api_client/v1/models/dashboard_template_variable_preset_value.rb +28 -5
  72. data/lib/datadog_api_client/v1/models/formula_and_function_event_query_definition.rb +14 -4
  73. data/lib/datadog_api_client/v1/models/formula_and_function_events_data_source.rb +1 -0
  74. data/lib/datadog_api_client/v1/models/hourly_usage_attribution_usage_type.rb +2 -0
  75. data/lib/datadog_api_client/v1/models/list_stream_query.rb +14 -4
  76. data/lib/datadog_api_client/v1/models/list_stream_source.rb +1 -0
  77. data/lib/datadog_api_client/v1/models/metric_content_encoding.rb +1 -0
  78. data/lib/datadog_api_client/v1/models/monitor_options.rb +28 -1
  79. data/lib/datadog_api_client/v1/models/monitor_summary_widget_definition.rb +13 -1
  80. data/lib/datadog_api_client/v1/models/monthly_usage_attribution_supported_metrics.rb +4 -0
  81. data/lib/datadog_api_client/v1/models/monthly_usage_attribution_values.rb +41 -1
  82. data/lib/datadog_api_client/v1/models/on_missing_data_option.rb +33 -0
  83. data/lib/datadog_api_client/v1/models/search_service_level_objective.rb +111 -0
  84. data/lib/datadog_api_client/v1/models/search_service_level_objective_attributes.rb +286 -0
  85. data/lib/datadog_api_client/v1/models/search_service_level_objective_data.rb +134 -0
  86. data/lib/datadog_api_client/v1/models/search_slo_query.rb +137 -0
  87. data/lib/datadog_api_client/v1/models/search_slo_response_data_attributes.rb +8 -8
  88. data/lib/datadog_api_client/v1/models/search_slo_response_links.rb +2 -0
  89. data/lib/datadog_api_client/v1/models/search_slo_threshold.rb +184 -0
  90. data/lib/datadog_api_client/v1/models/search_slo_timeframe.rb +28 -0
  91. data/lib/datadog_api_client/v1/models/slo_creator.rb +131 -0
  92. data/lib/datadog_api_client/v1/models/slo_list_widget_definition.rb +185 -0
  93. data/lib/datadog_api_client/v1/models/slo_list_widget_definition_type.rb +26 -0
  94. data/lib/datadog_api_client/v1/models/slo_list_widget_query.rb +149 -0
  95. data/lib/datadog_api_client/v1/models/slo_list_widget_request.rb +143 -0
  96. data/lib/datadog_api_client/v1/models/slo_list_widget_request_type.rb +26 -0
  97. data/lib/datadog_api_client/v1/models/slo_overall_statuses.rb +174 -0
  98. data/lib/datadog_api_client/v1/models/slo_raw_error_budget_remaining.rb +121 -0
  99. data/lib/datadog_api_client/v1/models/synthetics_assertion_operator.rb +1 -0
  100. data/lib/datadog_api_client/v1/models/synthetics_basic_auth.rb +2 -1
  101. data/lib/datadog_api_client/v1/models/synthetics_basic_auth_digest.rb +155 -0
  102. data/lib/datadog_api_client/v1/models/synthetics_basic_auth_digest_type.rb +26 -0
  103. data/lib/datadog_api_client/v1/models/synthetics_global_variable_parse_test_options.rb +11 -12
  104. data/lib/datadog_api_client/v1/models/synthetics_global_variable_parse_test_options_type.rb +1 -0
  105. data/lib/datadog_api_client/v1/models/synthetics_test_options.rb +31 -1
  106. data/lib/datadog_api_client/v1/models/synthetics_test_process_status.rb +0 -1
  107. data/lib/datadog_api_client/v1/models/synthetics_test_request.rb +15 -1
  108. data/lib/datadog_api_client/v1/models/topology_map_widget_definition.rb +193 -0
  109. data/lib/datadog_api_client/v1/models/topology_map_widget_definition_type.rb +26 -0
  110. data/lib/datadog_api_client/v1/models/topology_query.rb +144 -0
  111. data/lib/datadog_api_client/v1/models/topology_query_data_source.rb +27 -0
  112. data/lib/datadog_api_client/v1/models/topology_request.rb +121 -0
  113. data/lib/datadog_api_client/v1/models/topology_request_type.rb +26 -0
  114. data/lib/datadog_api_client/v1/models/usage_attribution_sort.rb +4 -0
  115. data/lib/datadog_api_client/v1/models/usage_attribution_supported_metrics.rb +4 -0
  116. data/lib/datadog_api_client/v1/models/usage_attribution_values.rb +41 -1
  117. data/lib/datadog_api_client/v1/models/usage_billable_summary_hour.rb +11 -1
  118. data/lib/datadog_api_client/v1/models/usage_cloud_security_posture_management_hour.rb +12 -1
  119. data/lib/datadog_api_client/v1/models/usage_fargate_hour.rb +11 -1
  120. data/lib/datadog_api_client/v1/models/usage_summary_date.rb +21 -1
  121. data/lib/datadog_api_client/v1/models/usage_summary_date_org.rb +31 -1
  122. data/lib/datadog_api_client/v1/models/usage_summary_response.rb +21 -1
  123. data/lib/datadog_api_client/v1/models/widget_definition.rb +3 -1
  124. data/lib/datadog_api_client/v1/models/widget_monitor_summary_sort.rb +2 -0
  125. data/lib/datadog_api_client/v2/api/events_api.rb +1 -1
  126. data/lib/datadog_api_client/v2/api/incident_services_api.rb +2 -2
  127. data/lib/datadog_api_client/v2/api/incident_teams_api.rb +2 -2
  128. data/lib/datadog_api_client/v2/api/incidents_api.rb +155 -0
  129. data/lib/datadog_api_client/v2/api/logs_api.rb +1 -1
  130. data/lib/datadog_api_client/v2/api/metrics_api.rb +77 -9
  131. data/lib/datadog_api_client/v2/api/rum_api.rb +329 -0
  132. data/lib/datadog_api_client/v2/api/security_monitoring_api.rb +68 -3
  133. data/lib/datadog_api_client/v2/api/usage_metering_api.rb +83 -17
  134. data/lib/datadog_api_client/v2/models/content_encoding.rb +1 -0
  135. data/lib/datadog_api_client/v2/models/incident_attachment_attachment_type.rb +27 -0
  136. data/lib/datadog_api_client/v2/models/incident_attachment_attributes.rb +63 -0
  137. data/lib/datadog_api_client/v2/models/incident_attachment_data.rb +187 -0
  138. data/lib/datadog_api_client/v2/models/incident_attachment_link_attachment_type.rb +26 -0
  139. data/lib/datadog_api_client/v2/models/incident_attachment_link_attributes.rb +145 -0
  140. data/lib/datadog_api_client/v2/models/incident_attachment_link_attributes_attachment_object.rb +143 -0
  141. data/lib/datadog_api_client/v2/models/incident_attachment_postmortem_attachment_type.rb +26 -0
  142. data/lib/datadog_api_client/v2/models/incident_attachment_postmortem_attributes.rb +145 -0
  143. data/lib/datadog_api_client/v2/models/incident_attachment_related_object.rb +26 -0
  144. data/lib/datadog_api_client/v2/models/incident_attachment_relationships.rb +111 -0
  145. data/lib/datadog_api_client/v2/models/incident_attachment_type.rb +26 -0
  146. data/lib/datadog_api_client/v2/models/incident_attachment_update_attributes.rb +63 -0
  147. data/lib/datadog_api_client/v2/models/incident_attachment_update_data.rb +144 -0
  148. data/lib/datadog_api_client/v2/models/incident_attachment_update_request.rb +127 -0
  149. data/lib/datadog_api_client/v2/models/incident_attachment_update_response.rb +137 -0
  150. data/lib/datadog_api_client/v2/models/incident_attachments_postmortem_attributes_attachment_object.rb +143 -0
  151. data/lib/datadog_api_client/v2/models/incident_attachments_response.rb +136 -0
  152. data/lib/datadog_api_client/v2/models/incident_attachments_response_included_item.rb +62 -0
  153. data/lib/datadog_api_client/v2/models/incident_related_object.rb +1 -0
  154. data/lib/datadog_api_client/v2/models/incident_response_attributes.rb +1 -11
  155. data/lib/datadog_api_client/v2/models/incident_response_included_item.rb +2 -1
  156. data/lib/datadog_api_client/v2/models/incident_response_relationships.rb +14 -14
  157. data/lib/datadog_api_client/v2/models/metric_active_configuration_type.rb +26 -0
  158. data/lib/datadog_api_client/v2/models/metric_content_encoding.rb +2 -0
  159. data/lib/datadog_api_client/v2/models/metric_suggested_tags_and_aggregations.rb +133 -0
  160. data/lib/datadog_api_client/v2/models/metric_suggested_tags_and_aggregations_response.rb +111 -0
  161. data/lib/datadog_api_client/v2/models/metric_suggested_tags_attributes.rb +125 -0
  162. data/lib/datadog_api_client/v2/models/relationship_to_incident_attachment.rb +124 -0
  163. data/lib/datadog_api_client/v2/models/relationship_to_incident_attachment_data.rb +145 -0
  164. data/lib/datadog_api_client/v2/models/role_update_data.rb +11 -1
  165. data/lib/datadog_api_client/v2/models/rum_application.rb +166 -0
  166. data/lib/datadog_api_client/v2/models/rum_application_attributes.rb +279 -0
  167. data/lib/datadog_api_client/v2/models/rum_application_create.rb +145 -0
  168. data/lib/datadog_api_client/v2/models/rum_application_create_attributes.rb +132 -0
  169. data/lib/datadog_api_client/v2/models/rum_application_create_request.rb +122 -0
  170. data/lib/datadog_api_client/v2/models/rum_application_create_type.rb +26 -0
  171. data/lib/datadog_api_client/v2/models/rum_application_response.rb +111 -0
  172. data/lib/datadog_api_client/v2/models/rum_application_type.rb +26 -0
  173. data/lib/datadog_api_client/v2/models/rum_application_update.rb +155 -0
  174. data/lib/datadog_api_client/v2/models/rum_application_update_attributes.rb +121 -0
  175. data/lib/datadog_api_client/v2/models/rum_application_update_request.rb +122 -0
  176. data/lib/datadog_api_client/v2/models/rum_application_update_type.rb +26 -0
  177. data/lib/datadog_api_client/v2/models/rum_applications_response.rb +113 -0
  178. data/lib/datadog_api_client/v2/models/security_monitoring_rule_create_payload.rb +36 -248
  179. data/lib/datadog_api_client/v2/models/security_monitoring_rule_query.rb +36 -151
  180. data/lib/datadog_api_client/v2/models/security_monitoring_rule_query_aggregation.rb +1 -0
  181. data/lib/datadog_api_client/v2/models/security_monitoring_rule_response.rb +37 -253
  182. data/lib/datadog_api_client/v2/models/security_monitoring_signal_rule_create_payload.rb +275 -0
  183. data/lib/datadog_api_client/v2/models/security_monitoring_signal_rule_query.rb +187 -0
  184. data/lib/datadog_api_client/v2/models/security_monitoring_signal_rule_response.rb +279 -0
  185. data/lib/datadog_api_client/v2/models/security_monitoring_signal_rule_type.rb +26 -0
  186. data/lib/datadog_api_client/v2/models/security_monitoring_standard_rule_create_payload.rb +275 -0
  187. data/lib/datadog_api_client/v2/models/{security_monitoring_rule_query_create.rb → security_monitoring_standard_rule_query.rb} +3 -3
  188. data/lib/datadog_api_client/v2/models/security_monitoring_standard_rule_response.rb +279 -0
  189. data/lib/datadog_api_client/version.rb +1 -1
  190. metadata +97 -6
  191. data/Makefile +0 -7
  192. data/examples/v2/metrics/ListTagConfigurations_1799362914.rb +0 -8
@@ -1250,10 +1250,25 @@ components:
1250
1250
  nullable: true
1251
1251
  type: array
1252
1252
  default:
1253
- description: The default value for the template variable on dashboard load.
1253
+ deprecated: true
1254
+ description: (deprecated) The default value for the template variable on
1255
+ dashboard load. Cannot be used in conjunction with `defaults`.
1254
1256
  example: my-host
1255
1257
  nullable: true
1256
1258
  type: string
1259
+ defaults:
1260
+ description: One or many default values for template variables on load.
1261
+ If more than one default is specified, they will be unioned together with
1262
+ `OR`. Cannot be used in conjunction with `default`.
1263
+ example:
1264
+ - my-host-1
1265
+ - my-host-2
1266
+ items:
1267
+ description: One of many default values for the template variable on dashboard
1268
+ load.
1269
+ minLength: 1
1270
+ type: string
1271
+ type: array
1257
1272
  name:
1258
1273
  description: The name of the variable.
1259
1274
  example: host1
@@ -1286,8 +1301,21 @@ components:
1286
1301
  description: The name of the variable.
1287
1302
  type: string
1288
1303
  value:
1289
- description: The value of the template variable within the saved view.
1304
+ deprecated: true
1305
+ description: (deprecated) The value of the template variable within the
1306
+ saved view. Cannot be used in conjunction with `values`.
1290
1307
  type: string
1308
+ values:
1309
+ description: One or many template variable values within the saved view,
1310
+ which will be unioned together using `OR` if more than one is specified.
1311
+ Cannot be used in conjunction with `value`.
1312
+ items:
1313
+ description: One or many values of the template variable within the saved
1314
+ view.
1315
+ minLength: 1
1316
+ type: string
1317
+ minItems: 1
1318
+ type: array
1291
1319
  type: object
1292
1320
  DeletedMonitor:
1293
1321
  description: Response from the delete monitor call.
@@ -2412,6 +2440,10 @@ components:
2412
2440
  type: string
2413
2441
  search:
2414
2442
  $ref: '#/components/schemas/FormulaAndFunctionEventQueryDefinitionSearch'
2443
+ storage:
2444
+ description: Option for storage location. Feature in Private Beta.
2445
+ example: indexes
2446
+ type: string
2415
2447
  required:
2416
2448
  - data_source
2417
2449
  - compute
@@ -2485,6 +2517,7 @@ components:
2485
2517
  - profiles
2486
2518
  - audit
2487
2519
  - events
2520
+ - ci_tests
2488
2521
  example: logs
2489
2522
  type: string
2490
2523
  x-enum-varnames:
@@ -2496,6 +2529,7 @@ components:
2496
2529
  - PROFILES
2497
2530
  - AUDIT
2498
2531
  - EVENTS
2532
+ - CI_TESTS
2499
2533
  FormulaAndFunctionMetricAggregation:
2500
2534
  description: The aggregation methods available for metrics queries.
2501
2535
  enum:
@@ -3625,6 +3659,7 @@ components:
3625
3659
  description: Supported products for hourly usage attribution requests.
3626
3660
  enum:
3627
3661
  - api_usage
3662
+ - apm_fargate_usage
3628
3663
  - apm_host_usage
3629
3664
  - appsec_usage
3630
3665
  - browser_usage
@@ -3637,6 +3672,7 @@ components:
3637
3672
  - dbm_hosts_usage
3638
3673
  - dbm_queries_usage
3639
3674
  - estimated_indexed_logs_usage
3675
+ - estimated_ingested_logs_usage
3640
3676
  - estimated_indexed_spans_usage
3641
3677
  - estimated_ingested_spans_usage
3642
3678
  - fargate_usage
@@ -3651,6 +3687,7 @@ components:
3651
3687
  type: string
3652
3688
  x-enum-varnames:
3653
3689
  - API_USAGE
3690
+ - APM_FARGATE_USAGE
3654
3691
  - APM_HOST_USAGE
3655
3692
  - APPSEC_USAGE
3656
3693
  - BROWSER_USAGE
@@ -3663,6 +3700,7 @@ components:
3663
3700
  - DBM_HOSTS_USAGE
3664
3701
  - DBM_QUERIES_USAGE
3665
3702
  - ESTIMATED_INDEXED_LOGS_USAGE
3703
+ - ESTIMATED_INGESTED_LOGS_USAGE
3666
3704
  - ESTIMATED_INDEXED_SPANS_USAGE
3667
3705
  - ESTIMATED_INGESTED_SPANS_USAGE
3668
3706
  - FARGATE_USAGE
@@ -3991,6 +4029,10 @@ components:
3991
4029
  description: Widget query.
3992
4030
  example: '@service:app'
3993
4031
  type: string
4032
+ storage:
4033
+ description: Option for storage location. Feature in Private Beta.
4034
+ example: indexes
4035
+ type: string
3994
4036
  required:
3995
4037
  - query_string
3996
4038
  - data_source
@@ -4011,6 +4053,7 @@ components:
4011
4053
  - audit_stream
4012
4054
  - rum_issue_stream
4013
4055
  - apm_issue_stream
4056
+ - logs_pattern_stream
4014
4057
  example: apm_issue_stream
4015
4058
  type: string
4016
4059
  x-enum-varnames:
@@ -4018,6 +4061,7 @@ components:
4018
4061
  - AUDIT_STREAM
4019
4062
  - RUM_ISSUE_STREAM
4020
4063
  - APM_ISSUE_STREAM
4064
+ - LOGS_PATTERN_STREAM
4021
4065
  ListStreamWidgetDefinition:
4022
4066
  description: 'The list stream visualization displays a table of recent events
4023
4067
  in your application that
@@ -5511,12 +5555,16 @@ components:
5511
5555
  x-enum-varnames:
5512
5556
  - USER_AGENT_PARSER
5513
5557
  MetricContentEncoding:
5558
+ default: deflate
5514
5559
  description: HTTP header used to compress the media-type.
5515
5560
  enum:
5516
5561
  - deflate
5562
+ - gzip
5563
+ example: deflate
5517
5564
  type: string
5518
5565
  x-enum-varnames:
5519
5566
  - DEFLATE
5567
+ - GZIP
5520
5568
  MetricMetadata:
5521
5569
  description: Object with all metric related metadata.
5522
5570
  properties:
@@ -5636,6 +5684,9 @@ components:
5636
5684
  type: string
5637
5685
  pointlist:
5638
5686
  description: List of points of the time series.
5687
+ example:
5688
+ - - 1575317847.0
5689
+ - 0.5
5639
5690
  items:
5640
5691
  $ref: '#/components/schemas/Point'
5641
5692
  readOnly: true
@@ -6131,6 +6182,17 @@ components:
6131
6182
  format: int64
6132
6183
  nullable: true
6133
6184
  type: integer
6185
+ group_retention_duration:
6186
+ description: 'The time span after which groups with missing data are dropped
6187
+ from the monitor state.
6188
+
6189
+ The minimum value is one hour, and the maximum value is 72 hours.
6190
+
6191
+ Example values are: "60m", "1h", and "2d".
6192
+
6193
+ This option is only available for APM Trace Analytics, Audit Trail, CI,
6194
+ Error Tracking, Event, Logs, and RUM monitors.'
6195
+ type: string
6134
6196
  groupby_simple_monitor:
6135
6197
  description: Whether the log alert monitor triggers a single alert or multiple
6136
6198
  alerts when any group breaches a threshold.
@@ -6221,6 +6283,8 @@ components:
6221
6283
  description: A Boolean indicating whether this monitor notifies when data
6222
6284
  stops reporting.
6223
6285
  type: boolean
6286
+ on_missing_data:
6287
+ $ref: '#/components/schemas/OnMissingDataOption'
6224
6288
  renotify_interval:
6225
6289
  default: null
6226
6290
  description: "The number of minutes after the last notification before a
@@ -6593,6 +6657,10 @@ components:
6593
6657
  description: Whether to show the time that has elapsed since the monitor/group
6594
6658
  triggered.
6595
6659
  type: boolean
6660
+ show_priority:
6661
+ default: false
6662
+ description: Whether to show the priorities column.
6663
+ type: boolean
6596
6664
  sort:
6597
6665
  $ref: '#/components/schemas/WidgetMonitorSummarySort'
6598
6666
  start:
@@ -6845,6 +6913,8 @@ components:
6845
6913
  enum:
6846
6914
  - api_usage
6847
6915
  - api_percentage
6916
+ - apm_fargate_usage
6917
+ - apm_fargate_percentage
6848
6918
  - apm_host_usage
6849
6919
  - apm_host_percentage
6850
6920
  - appsec_usage
@@ -6869,6 +6939,8 @@ components:
6869
6939
  - dbm_queries_usage
6870
6940
  - estimated_indexed_logs_usage
6871
6941
  - estimated_indexed_logs_percentage
6942
+ - estimated_ingested_logs_usage
6943
+ - estimated_ingested_logs_percentage
6872
6944
  - estimated_indexed_spans_usage
6873
6945
  - estimated_indexed_spans_percentage
6874
6946
  - estimated_ingested_spans_usage
@@ -6896,6 +6968,8 @@ components:
6896
6968
  x-enum-varnames:
6897
6969
  - API_USAGE
6898
6970
  - API_PERCENTAGE
6971
+ - APM_FARGATE_USAGE
6972
+ - APM_FARGATE_PERCENTAGE
6899
6973
  - APM_HOST_USAGE
6900
6974
  - APM_HOST_PERCENTAGE
6901
6975
  - APPSEC_USAGE
@@ -6920,6 +6994,8 @@ components:
6920
6994
  - DBM_QUERIES_USAGE
6921
6995
  - ESTIMATED_INDEXED_LOGS_USAGE
6922
6996
  - ESTIMATED_INDEXED_LOGS_PERCENTAGE
6997
+ - ESTIMATED_INGESTED_LOGS_USAGE
6998
+ - ESTIMATED_INGESTED_LOGS_PERCENTAGE
6923
6999
  - ESTIMATED_INDEXED_SPANS_USAGE
6924
7000
  - ESTIMATED_INDEXED_SPANS_PERCENTAGE
6925
7001
  - ESTIMATED_INGESTED_SPANS_USAGE
@@ -6954,6 +7030,14 @@ components:
6954
7030
  description: The synthetic API test usage by tag(s).
6955
7031
  format: double
6956
7032
  type: number
7033
+ apm_fargate_percentage:
7034
+ description: The percentage of APM ECS Fargate task usage by tag(s).
7035
+ format: double
7036
+ type: number
7037
+ apm_fargate_usage:
7038
+ description: The APM ECS Fargate task usage by tag(s).
7039
+ format: double
7040
+ type: number
6957
7041
  apm_host_percentage:
6958
7042
  description: The percentage of APM host usage by tag(s).
6959
7043
  format: double
@@ -7015,6 +7099,16 @@ components:
7015
7099
  in private beta.
7016
7100
  format: double
7017
7101
  type: number
7102
+ estimated_ingested_logs_percentage:
7103
+ description: The percentage of estimated live ingested logs usage by tag(s).
7104
+ This field is in private beta.
7105
+ format: double
7106
+ type: number
7107
+ estimated_ingested_logs_usage:
7108
+ description: The estimated live ingested logs usage by tag(s). This field
7109
+ is in private beta.
7110
+ format: double
7111
+ type: number
7018
7112
  estimated_ingested_spans_percentage:
7019
7113
  description: The percentage of estimated ingested spans usage by tag(s).
7020
7114
  This field is in private beta.
@@ -7922,6 +8016,32 @@ components:
7922
8016
  format: int64
7923
8017
  type: integer
7924
8018
  type: object
8019
+ OnMissingDataOption:
8020
+ description: 'Controls how groups or monitors are treated if an evaluation does
8021
+ not return any data points.
8022
+
8023
+ The default option results in different behavior depending on the monitor
8024
+ query type.
8025
+
8026
+ For monitors using Count queries, an empty monitor evaluation is treated as
8027
+ 0 and is compared to the threshold conditions.
8028
+
8029
+ For monitors using any query type other than Count, for example Gauge, Measure,
8030
+ or Rate, the monitor shows the last known status.
8031
+
8032
+ This option is only available for APM Trace Analytics, Audit Trail, CI, Error
8033
+ Tracking, Event, Logs, and RUM monitors.'
8034
+ enum:
8035
+ - default
8036
+ - show_no_data
8037
+ - show_and_notify_no_data
8038
+ - resolve
8039
+ type: string
8040
+ x-enum-varnames:
8041
+ - DEFAULT
8042
+ - SHOW_NO_DATA
8043
+ - SHOW_AND_NOTIFY_NO_DATA
8044
+ - RESOLVE
7925
8045
  OrgDowngradedResponse:
7926
8046
  description: Status of downgrade
7927
8047
  properties:
@@ -8626,6 +8746,21 @@ components:
8626
8746
  example: UTC
8627
8747
  type: string
8628
8748
  type: object
8749
+ SLOCreator:
8750
+ description: The creator of the SLO
8751
+ nullable: true
8752
+ properties:
8753
+ email:
8754
+ description: Email of the creator.
8755
+ type: string
8756
+ id:
8757
+ description: User ID of the creator.
8758
+ format: int64
8759
+ type: integer
8760
+ name:
8761
+ description: Name of the creator.
8762
+ type: string
8763
+ type: object
8629
8764
  SLODeleteResponse:
8630
8765
  description: A response list of all service level objective deleted.
8631
8766
  properties:
@@ -9136,6 +9271,124 @@ components:
9136
9271
  format: int64
9137
9272
  type: integer
9138
9273
  type: object
9274
+ SLOListWidgetDefinition:
9275
+ description: Use the SLO List widget to track your SLOs (Service Level Objectives)
9276
+ on dashboards.
9277
+ properties:
9278
+ requests:
9279
+ description: Array of one request object to display in the widget.
9280
+ items:
9281
+ $ref: '#/components/schemas/SLOListWidgetRequest'
9282
+ maxItems: 1
9283
+ minItems: 1
9284
+ type: array
9285
+ title:
9286
+ description: Title of the widget.
9287
+ type: string
9288
+ title_align:
9289
+ $ref: '#/components/schemas/WidgetTextAlign'
9290
+ title_size:
9291
+ description: Size of the title.
9292
+ type: string
9293
+ type:
9294
+ $ref: '#/components/schemas/SLOListWidgetDefinitionType'
9295
+ required:
9296
+ - type
9297
+ - requests
9298
+ type: object
9299
+ SLOListWidgetDefinitionType:
9300
+ default: slo_list
9301
+ description: Type of the SLO List widget.
9302
+ enum:
9303
+ - slo_list
9304
+ example: slo_list
9305
+ type: string
9306
+ x-enum-varnames:
9307
+ - SLO_LIST
9308
+ SLOListWidgetQuery:
9309
+ description: Updated SLO List widget.
9310
+ properties:
9311
+ limit:
9312
+ default: 100
9313
+ description: Maximum number of results to display in the table.
9314
+ format: int64
9315
+ maximum: 100
9316
+ minimum: 1
9317
+ type: integer
9318
+ query_string:
9319
+ description: Widget query.
9320
+ example: env:prod AND service:my-app
9321
+ type: string
9322
+ required:
9323
+ - query_string
9324
+ type: object
9325
+ SLOListWidgetRequest:
9326
+ description: Updated SLO List widget.
9327
+ properties:
9328
+ query:
9329
+ $ref: '#/components/schemas/SLOListWidgetQuery'
9330
+ request_type:
9331
+ $ref: '#/components/schemas/SLOListWidgetRequestType'
9332
+ required:
9333
+ - query
9334
+ - request_type
9335
+ type: object
9336
+ SLOListWidgetRequestType:
9337
+ description: Widget request type.
9338
+ enum:
9339
+ - slo_list
9340
+ type: string
9341
+ x-enum-varnames:
9342
+ - SLO_LIST
9343
+ SLOOverallStatuses:
9344
+ description: Overall status of the SLO by timeframes.
9345
+ properties:
9346
+ error:
9347
+ description: Error message if SLO status or error budget could not be calculated.
9348
+ nullable: true
9349
+ type: string
9350
+ indexed_at:
9351
+ description: 'timestamp (UNIX time in seconds) of when the SLO status and
9352
+ error budget
9353
+
9354
+ were calculated.'
9355
+ example: 1662496260
9356
+ format: int64
9357
+ type: integer
9358
+ raw_error_budget_remaining:
9359
+ $ref: '#/components/schemas/SLORawErrorBudgetRemaining'
9360
+ span_precision:
9361
+ description: The amount of decimal places the SLI value is accurate to.
9362
+ example: 2
9363
+ format: int64
9364
+ type: integer
9365
+ status:
9366
+ description: The status of the SLO.
9367
+ example: 100
9368
+ format: double
9369
+ nullable: true
9370
+ type: number
9371
+ target:
9372
+ description: The target of the SLO.
9373
+ example: 99
9374
+ format: double
9375
+ type: number
9376
+ timeframe:
9377
+ $ref: '#/components/schemas/SLOTimeframe'
9378
+ type: object
9379
+ SLORawErrorBudgetRemaining:
9380
+ description: Error budget remaining for an SLO.
9381
+ properties:
9382
+ unit:
9383
+ description: Error budget remaining unit.
9384
+ example: requests
9385
+ type: string
9386
+ value:
9387
+ description: Error budget remaining value.
9388
+ example: 60
9389
+ format: double
9390
+ type: number
9391
+ type: object
9139
9392
  SLOResponse:
9140
9393
  description: A service level objective response containing a single service
9141
9394
  level objective.
@@ -9573,6 +9826,38 @@ components:
9573
9826
  - formula
9574
9827
  - dimension
9575
9828
  type: object
9829
+ SearchSLOQuery:
9830
+ description: 'A metric-based SLO. **Required if type is `metric`**. Note that
9831
+ Datadog only allows the sum by aggregator
9832
+
9833
+ to be used because this will sum up all request counts instead of averaging
9834
+ them, or taking the max or
9835
+
9836
+ min of all of those requests.'
9837
+ nullable: true
9838
+ properties:
9839
+ denominator:
9840
+ description: A Datadog metric query for total (valid) events.
9841
+ example: sum:my.custom.metric{*}.as_count()
9842
+ type: string
9843
+ metrics:
9844
+ description: 'Metric names used in the query''s numerator and denominator.
9845
+
9846
+ This field will return null and will be implemented in the next version
9847
+ of this endpoint.'
9848
+ example:
9849
+ - my.custom.metric
9850
+ - my.other.custom.metric
9851
+ items:
9852
+ description: Metric name.
9853
+ type: string
9854
+ nullable: true
9855
+ type: array
9856
+ numerator:
9857
+ description: A Datadog metric query for good events.
9858
+ example: sum:my.custom.metric{type:good}.as_count()
9859
+ type: string
9860
+ type: object
9576
9861
  SearchSLOResponse:
9577
9862
  description: A search SLO response containing results from the search query.
9578
9863
  properties:
@@ -9598,10 +9883,10 @@ components:
9598
9883
  properties:
9599
9884
  facets:
9600
9885
  $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacets'
9601
- slo:
9886
+ slos:
9602
9887
  description: SLOs
9603
9888
  items:
9604
- $ref: '#/components/schemas/ServiceLevelObjective'
9889
+ $ref: '#/components/schemas/SearchServiceLevelObjective'
9605
9890
  type: array
9606
9891
  type: object
9607
9892
  SearchSLOResponseDataAttributesFacets:
@@ -9679,12 +9964,14 @@ components:
9679
9964
  type: string
9680
9965
  last:
9681
9966
  description: Link to first page.
9967
+ nullable: true
9682
9968
  type: string
9683
9969
  next:
9684
9970
  description: Link to the next page.
9685
9971
  type: string
9686
9972
  prev:
9687
9973
  description: Link to previous page.
9974
+ nullable: true
9688
9975
  type: string
9689
9976
  self:
9690
9977
  description: Link to current page.
@@ -9731,6 +10018,202 @@ components:
9731
10018
  description: Type of pagination.
9732
10019
  type: string
9733
10020
  type: object
10021
+ SearchSLOThreshold:
10022
+ description: SLO thresholds (target and optionally warning) for a single time
10023
+ window.
10024
+ properties:
10025
+ target:
10026
+ description: 'The target value for the service level indicator within the
10027
+ corresponding
10028
+
10029
+ timeframe.'
10030
+ example: 99.9
10031
+ format: double
10032
+ type: number
10033
+ target_display:
10034
+ description: 'A string representation of the target that indicates its precision.
10035
+
10036
+ It uses trailing zeros to show significant decimal places (for example
10037
+ `98.00`).
10038
+
10039
+
10040
+ Always included in service level objective responses. Ignored in
10041
+
10042
+ create/update requests.'
10043
+ example: '99.9'
10044
+ type: string
10045
+ timeframe:
10046
+ $ref: '#/components/schemas/SearchSLOTimeframe'
10047
+ warning:
10048
+ description: The warning value for the service level objective.
10049
+ example: 90.0
10050
+ format: double
10051
+ nullable: true
10052
+ type: number
10053
+ warning_display:
10054
+ description: 'A string representation of the warning target (see the description
10055
+ of
10056
+
10057
+ the `target_display` field for details).
10058
+
10059
+
10060
+ Included in service level objective responses if a warning target exists.
10061
+
10062
+ Ignored in create/update requests.'
10063
+ example: '90.0'
10064
+ nullable: true
10065
+ type: string
10066
+ required:
10067
+ - timeframe
10068
+ - target
10069
+ type: object
10070
+ SearchSLOTimeframe:
10071
+ description: The SLO time window options.
10072
+ enum:
10073
+ - 7d
10074
+ - 30d
10075
+ - 90d
10076
+ example: 30d
10077
+ type: string
10078
+ x-enum-varnames:
10079
+ - SEVEN_DAYS
10080
+ - THIRTY_DAYS
10081
+ - NINETY_DAYS
10082
+ SearchServiceLevelObjective:
10083
+ description: A service level objective data container.
10084
+ properties:
10085
+ data:
10086
+ $ref: '#/components/schemas/SearchServiceLevelObjectiveData'
10087
+ type: object
10088
+ SearchServiceLevelObjectiveAttributes:
10089
+ description: 'A service level objective object includes a service level indicator,
10090
+ thresholds
10091
+
10092
+ for one or more timeframes, and metadata (`name`, `description`, and `tags`).'
10093
+ properties:
10094
+ all_tags:
10095
+ description: 'A list of tags associated with this service level objective.
10096
+
10097
+ Always included in service level objective responses (but may be empty).'
10098
+ example:
10099
+ - env:prod
10100
+ - app:core
10101
+ items:
10102
+ type: string
10103
+ type: array
10104
+ created_at:
10105
+ description: 'Creation timestamp (UNIX time in seconds)
10106
+
10107
+
10108
+ Always included in service level objective responses.'
10109
+ format: int64
10110
+ readOnly: true
10111
+ type: integer
10112
+ creator:
10113
+ $ref: '#/components/schemas/SLOCreator'
10114
+ description:
10115
+ description: 'A user-defined description of the service level objective.
10116
+
10117
+
10118
+ Always included in service level objective responses (but may be `null`).
10119
+
10120
+ Optional in create/update requests.'
10121
+ nullable: true
10122
+ type: string
10123
+ env_tags:
10124
+ description: Tags with the `env` tag key.
10125
+ items:
10126
+ type: string
10127
+ type: array
10128
+ groups:
10129
+ description: 'A list of (up to 100) monitor groups that narrow the scope
10130
+ of a monitor service level objective.
10131
+
10132
+ Included in service level objective responses if it is not empty.'
10133
+ example:
10134
+ - env:prod
10135
+ - role:mysql
10136
+ items:
10137
+ description: A group name, for instance `env:prod`.
10138
+ type: string
10139
+ nullable: true
10140
+ type: array
10141
+ modified_at:
10142
+ description: 'Modification timestamp (UNIX time in seconds)
10143
+
10144
+
10145
+ Always included in service level objective responses.'
10146
+ format: int64
10147
+ readOnly: true
10148
+ type: integer
10149
+ monitor_ids:
10150
+ description: 'A list of monitor ids that defines the scope of a monitor
10151
+ service level
10152
+
10153
+ objective.'
10154
+ items:
10155
+ description: A monitor ID.
10156
+ format: int64
10157
+ type: integer
10158
+ nullable: true
10159
+ type: array
10160
+ name:
10161
+ description: The name of the service level objective object.
10162
+ example: Custom Metric SLO
10163
+ type: string
10164
+ overall_status:
10165
+ description: calculated status and error budget remaining.
10166
+ items:
10167
+ $ref: '#/components/schemas/SLOOverallStatuses'
10168
+ type: array
10169
+ query:
10170
+ $ref: '#/components/schemas/SearchSLOQuery'
10171
+ service_tags:
10172
+ description: Tags with the `service` tag key.
10173
+ items:
10174
+ type: string
10175
+ type: array
10176
+ slo_type:
10177
+ $ref: '#/components/schemas/SLOType'
10178
+ team_tags:
10179
+ description: Tags with the `team` tag key.
10180
+ items:
10181
+ type: string
10182
+ type: array
10183
+ thresholds:
10184
+ description: 'The thresholds (timeframes and associated targets) for this
10185
+ service level
10186
+
10187
+ objective object.'
10188
+ example:
10189
+ - target: 95
10190
+ target_display: '95'
10191
+ timeframe: 7d
10192
+ - target: 95
10193
+ target_display: '95'
10194
+ timeframe: 30d
10195
+ warning: 97
10196
+ warning_display: '97'
10197
+ items:
10198
+ $ref: '#/components/schemas/SearchSLOThreshold'
10199
+ type: array
10200
+ type: object
10201
+ SearchServiceLevelObjectiveData:
10202
+ description: A service level objective ID and attributes.
10203
+ properties:
10204
+ attributes:
10205
+ $ref: '#/components/schemas/SearchServiceLevelObjectiveAttributes'
10206
+ id:
10207
+ description: 'A unique identifier for the service level objective object.
10208
+
10209
+
10210
+ Always included in service level objective responses.'
10211
+ readOnly: true
10212
+ type: string
10213
+ type:
10214
+ description: The type of the object, must be `slo`.
10215
+ type: string
10216
+ type: object
9734
10217
  Series:
9735
10218
  description: 'A metric to submit to Datadog.
9736
10219
 
@@ -10788,6 +11271,7 @@ components:
10788
11271
  - validates
10789
11272
  - isInMoreThan
10790
11273
  - isInLessThan
11274
+ - doesNotExist
10791
11275
  example: contains
10792
11276
  type: string
10793
11277
  x-enum-varnames:
@@ -10804,6 +11288,7 @@ components:
10804
11288
  - VALIDATES
10805
11289
  - IS_IN_MORE_DAYS_THAN
10806
11290
  - IS_IN_LESS_DAYS_THAN
11291
+ - DOES_NOT_EXIST
10807
11292
  SyntheticsAssertionTarget:
10808
11293
  description: An assertion which uses a simple target.
10809
11294
  properties:
@@ -10868,7 +11353,34 @@ components:
10868
11353
  - $ref: '#/components/schemas/SyntheticsBasicAuthWeb'
10869
11354
  - $ref: '#/components/schemas/SyntheticsBasicAuthSigv4'
10870
11355
  - $ref: '#/components/schemas/SyntheticsBasicAuthNTLM'
11356
+ - $ref: '#/components/schemas/SyntheticsBasicAuthDigest'
11357
+ type: object
11358
+ SyntheticsBasicAuthDigest:
11359
+ description: Object to handle digest authentication when performing the test.
11360
+ properties:
11361
+ password:
11362
+ description: Password to use for the digest authentication.
11363
+ example: PaSSw0RD!
11364
+ type: string
11365
+ type:
11366
+ $ref: '#/components/schemas/SyntheticsBasicAuthDigestType'
11367
+ username:
11368
+ description: Username to use for the digest authentication.
11369
+ example: my_username
11370
+ type: string
11371
+ required:
11372
+ - password
11373
+ - username
10871
11374
  type: object
11375
+ SyntheticsBasicAuthDigestType:
11376
+ default: digest
11377
+ description: The type of basic authentication to use when performing the test.
11378
+ enum:
11379
+ - digest
11380
+ example: digest
11381
+ type: string
11382
+ x-enum-varnames:
11383
+ - DIGEST
10872
11384
  SyntheticsBasicAuthNTLM:
10873
11385
  description: Object to handle `NTLM` authentication when performing the test.
10874
11386
  properties:
@@ -11384,7 +11896,6 @@ components:
11384
11896
  example: 12345
11385
11897
  format: int64
11386
11898
  type: integer
11387
- x-secret: true
11388
11899
  isEnabled:
11389
11900
  description: Determines whether RUM data is collected during test runs.
11390
11901
  example: true
@@ -11805,13 +12316,17 @@ components:
11805
12316
  the value.
11806
12317
  example: content-type
11807
12318
  type: string
12319
+ localVariableName:
12320
+ description: When type is `local_variable`, name of the local variable to
12321
+ use to extract the value.
12322
+ example: LOCAL_VARIABLE
12323
+ type: string
11808
12324
  parser:
11809
12325
  $ref: '#/components/schemas/SyntheticsVariableParser'
11810
12326
  type:
11811
12327
  $ref: '#/components/schemas/SyntheticsGlobalVariableParseTestOptionsType'
11812
12328
  required:
11813
12329
  - type
11814
- - parser
11815
12330
  type: object
11816
12331
  SyntheticsGlobalVariableParseTestOptionsType:
11817
12332
  description: Property of the Synthetics Test Response to use for a Synthetics
@@ -11819,11 +12334,13 @@ components:
11819
12334
  enum:
11820
12335
  - http_body
11821
12336
  - http_header
12337
+ - local_variable
11822
12338
  example: http_body
11823
12339
  type: string
11824
12340
  x-enum-varnames:
11825
12341
  - HTTP_BODY
11826
12342
  - HTTP_HEADER
12343
+ - LOCAL_VARIABLE
11827
12344
  SyntheticsGlobalVariableParserType:
11828
12345
  description: Type of parser for a Synthetics global variable from a synthetics
11829
12346
  test.
@@ -12471,9 +12988,20 @@ components:
12471
12988
  disableCors:
12472
12989
  description: Whether or not to disable CORS mechanism.
12473
12990
  type: boolean
12991
+ disableCsp:
12992
+ description: Disable Content Security Policy for browser tests.
12993
+ type: boolean
12474
12994
  follow_redirects:
12475
12995
  description: For API HTTP test, whether or not the test should follow redirects.
12476
12996
  type: boolean
12997
+ ignoreServerCertificateError:
12998
+ description: Ignore server certificate error.
12999
+ type: boolean
13000
+ initialNavigationTimeout:
13001
+ description: Timeout before declaring the initial step as failed (in seconds)
13002
+ for browser tests.
13003
+ format: int64
13004
+ type: integer
12477
13005
  min_failure_duration:
12478
13006
  description: Minimum amount of time in failure required to trigger an alert.
12479
13007
  format: int64
@@ -12562,14 +13090,12 @@ components:
12562
13090
  enum:
12563
13091
  - not_scheduled
12564
13092
  - scheduled
12565
- - started
12566
13093
  - finished
12567
13094
  - finished_with_error
12568
13095
  type: string
12569
13096
  x-enum-varnames:
12570
13097
  - NOT_SCHEDULED
12571
13098
  - SCHEDULED
12572
- - STARTED
12573
13099
  - FINISHED
12574
13100
  - FINISHED_WITH_ERROR
12575
13101
  SyntheticsTestRequest:
@@ -12586,6 +13112,16 @@ components:
12586
13112
  type: string
12587
13113
  certificate:
12588
13114
  $ref: '#/components/schemas/SyntheticsTestRequestCertificate'
13115
+ certificateDomains:
13116
+ default: []
13117
+ description: By default, the client certificate is applied on the domain
13118
+ of the starting URL for browser tests. If you want your client certificate
13119
+ to be applied on other domains instead, add them in `certificateDomains`.
13120
+ items:
13121
+ description: Domain to apply the client certificate.
13122
+ example: ''
13123
+ type: string
13124
+ type: array
12589
13125
  dnsServer:
12590
13126
  description: DNS server to use for DNS tests.
12591
13127
  type: string
@@ -13257,6 +13793,91 @@ components:
13257
13793
  style:
13258
13794
  $ref: '#/components/schemas/WidgetRequestStyle'
13259
13795
  type: object
13796
+ TopologyMapWidgetDefinition:
13797
+ description: This widget displays a topology of nodes and edges for different
13798
+ data sources. It replaces the service map widget.
13799
+ properties:
13800
+ custom_links:
13801
+ description: List of custom links.
13802
+ items:
13803
+ $ref: '#/components/schemas/WidgetCustomLink'
13804
+ type: array
13805
+ requests:
13806
+ description: One or more Topology requests.
13807
+ items:
13808
+ $ref: '#/components/schemas/TopologyRequest'
13809
+ minItems: 1
13810
+ type: array
13811
+ title:
13812
+ description: Title of your widget.
13813
+ type: string
13814
+ title_align:
13815
+ $ref: '#/components/schemas/WidgetTextAlign'
13816
+ title_size:
13817
+ description: Size of the title.
13818
+ type: string
13819
+ type:
13820
+ $ref: '#/components/schemas/TopologyMapWidgetDefinitionType'
13821
+ required:
13822
+ - type
13823
+ - requests
13824
+ type: object
13825
+ TopologyMapWidgetDefinitionType:
13826
+ default: topology_map
13827
+ description: Type of the topology map widget.
13828
+ enum:
13829
+ - topology_map
13830
+ example: topology_map
13831
+ type: string
13832
+ x-enum-varnames:
13833
+ - TOPOLOGY_MAP
13834
+ TopologyQuery:
13835
+ description: Query to service-based topology data sources like the service map
13836
+ or data streams.
13837
+ properties:
13838
+ data_source:
13839
+ $ref: '#/components/schemas/TopologyQueryDataSource'
13840
+ filters:
13841
+ description: Your environment and primary tag (or * if enabled for your
13842
+ account).
13843
+ example:
13844
+ - env:prod
13845
+ - az:us-east
13846
+ items:
13847
+ description: Environment or primary tag, generally in a key:value format
13848
+ type: string
13849
+ minItems: 1
13850
+ type: array
13851
+ service:
13852
+ description: Name of the service
13853
+ example: myService
13854
+ type: string
13855
+ type: object
13856
+ TopologyQueryDataSource:
13857
+ description: Name of the data source
13858
+ enum:
13859
+ - data_streams
13860
+ - service_map
13861
+ type: string
13862
+ x-enum-varnames:
13863
+ - DATA_STREAMS
13864
+ - SERVICE_MAP
13865
+ TopologyRequest:
13866
+ description: Request that will return nodes and edges to be used by topology
13867
+ map.
13868
+ properties:
13869
+ query:
13870
+ $ref: '#/components/schemas/TopologyQuery'
13871
+ request_type:
13872
+ $ref: '#/components/schemas/TopologyRequestType'
13873
+ type: object
13874
+ TopologyRequestType:
13875
+ description: Widget request type.
13876
+ enum:
13877
+ - topology
13878
+ type: string
13879
+ x-enum-varnames:
13880
+ - TOPOLOGY
13260
13881
  TreeMapColorBy:
13261
13882
  default: user
13262
13883
  deprecated: true
@@ -13516,10 +14137,14 @@ components:
13516
14137
  - lambda_invocations_percentage
13517
14138
  - estimated_indexed_logs_usage
13518
14139
  - estimated_indexed_logs_percentage
14140
+ - estimated_ingested_logs_usage
14141
+ - estimated_ingested_logs_percentage
13519
14142
  - estimated_indexed_spans_usage
13520
14143
  - estimated_indexed_spans_percentage
13521
14144
  - estimated_ingested_spans_usage
13522
14145
  - estimated_ingested_spans_percentage
14146
+ - apm_fargate_usage
14147
+ - apm_fargate_percentage
13523
14148
  type: string
13524
14149
  x-enum-varnames:
13525
14150
  - API_PERCENTAGE
@@ -13546,10 +14171,14 @@ components:
13546
14171
  - LAMBDA_INVOCATIONS_PERCENTAGE
13547
14172
  - ESTIMATED_INDEXED_LOGS_USAGE
13548
14173
  - ESTIMATED_INDEXED_LOGS_PERCENTAGE
14174
+ - ESTIMATED_INGESTED_LOGS_USAGE
14175
+ - ESTIMATED_INGESTED_LOGS_PERCENTAGE
13549
14176
  - ESTIMATED_INDEXED_SPANS_USAGE
13550
14177
  - ESTIMATED_INDEXED_SPANS_PERCENTAGE
13551
14178
  - ESTIMATED_INGESTED_SPANS_USAGE
13552
14179
  - ESTIMATED_INGESTED_SPANS_PERCENTAGE
14180
+ - APM_FARGATE_USAGE
14181
+ - APM_FARGATE_PERCENTAGE
13553
14182
  UsageAttributionSupportedMetrics:
13554
14183
  description: Supported fields for usage attribution requests (valid requests
13555
14184
  contain one or more metrics, or `*` for all).
@@ -13586,12 +14215,16 @@ components:
13586
14215
  - dbm_queries_percentage
13587
14216
  - estimated_indexed_logs_usage
13588
14217
  - estimated_indexed_logs_percentage
14218
+ - estimated_ingested_logs_usage
14219
+ - estimated_ingested_logs_percentage
13589
14220
  - appsec_usage
13590
14221
  - appsec_percentage
13591
14222
  - estimated_indexed_spans_usage
13592
14223
  - estimated_indexed_spans_percentage
13593
14224
  - estimated_ingested_spans_usage
13594
14225
  - estimated_ingested_spans_percentage
14226
+ - apm_fargate_usage
14227
+ - apm_fargate_percentage
13595
14228
  - '*'
13596
14229
  type: string
13597
14230
  x-enum-varnames:
@@ -13627,12 +14260,16 @@ components:
13627
14260
  - DBM_QUERIES_PERCENTAGE
13628
14261
  - ESTIMATED_INDEXED_LOGS_USAGE
13629
14262
  - ESTIMATED_INDEXED_LOGS_PERCENTAGE
14263
+ - ESTIMATED_INGESTED_LOGS_USAGE
14264
+ - ESTIMATED_INGESTED_LOGS_PERCENTAGE
13630
14265
  - APPSEC_USAGE
13631
14266
  - APPSEC_PERCENTAGE
13632
14267
  - ESTIMATED_INDEXED_SPANS_USAGE
13633
14268
  - ESTIMATED_INDEXED_SPANS_PERCENTAGE
13634
14269
  - ESTIMATED_INGESTED_SPANS_USAGE
13635
14270
  - ESTIMATED_INGESTED_SPANS_PERCENTAGE
14271
+ - APM_FARGATE_USAGE
14272
+ - APM_FARGATE_PERCENTAGE
13636
14273
  - ALL
13637
14274
  UsageAttributionTagNames:
13638
14275
  additionalProperties:
@@ -13673,6 +14310,14 @@ components:
13673
14310
  description: The synthetic API test usage by tag(s).
13674
14311
  format: double
13675
14312
  type: number
14313
+ apm_fargate_percentage:
14314
+ description: The percentage of APM ECS Fargate task usage by tag(s).
14315
+ format: double
14316
+ type: number
14317
+ apm_fargate_usage:
14318
+ description: The APM ECS Fargate task usage by tag(s).
14319
+ format: double
14320
+ type: number
13676
14321
  apm_host_percentage:
13677
14322
  description: The percentage of APM host usage by tag(s).
13678
14323
  format: double
@@ -13786,6 +14431,16 @@ components:
13786
14431
  is in private beta.
13787
14432
  format: double
13788
14433
  type: number
14434
+ estimated_ingested_logs_percentage:
14435
+ description: The percentage of estimated live ingested logs usage by tag(s).
14436
+ Note this field is in private beta.
14437
+ format: double
14438
+ type: number
14439
+ estimated_ingested_logs_usage:
14440
+ description: The estimated live ingested logs usage by tag(s). Note this
14441
+ field is in private beta.
14442
+ format: double
14443
+ type: number
13789
14444
  estimated_ingested_spans_percentage:
13790
14445
  description: The percentage of estimated ingested spans usage by tag(s).
13791
14446
  Note this field is in private beta.
@@ -13937,6 +14592,9 @@ components:
13937
14592
  description: Shows usage aggregation for a billing period.
13938
14593
  format: double
13939
14594
  type: number
14595
+ region:
14596
+ description: The region of the organization.
14597
+ type: string
13940
14598
  start_date:
13941
14599
  description: Shows the first date of usage.
13942
14600
  format: date-time
@@ -14195,6 +14853,12 @@ components:
14195
14853
  format: double
14196
14854
  nullable: true
14197
14855
  type: number
14856
+ aws_host_count:
14857
+ description: The number of Cloud Security Posture Management AWS hosts during
14858
+ a given hour.
14859
+ format: double
14860
+ nullable: true
14861
+ type: number
14198
14862
  azure_host_count:
14199
14863
  description: The number of Cloud Security Posture Management Azure hosts
14200
14864
  during a given hour.
@@ -14338,6 +15002,11 @@ components:
14338
15002
  UsageFargateHour:
14339
15003
  description: Number of Fargate tasks run and hourly usage.
14340
15004
  properties:
15005
+ apm_fargate_count:
15006
+ description: The high-water mark of APM ECS Fargate tasks during the given
15007
+ hour.
15008
+ format: int64
15009
+ type: integer
14341
15010
  avg_profiled_fargate_tasks:
14342
15011
  description: The average profiled task count for Fargate Profiling.
14343
15012
  format: int64
@@ -15140,6 +15809,11 @@ components:
15140
15809
  over all hours in the current date all organizations.
15141
15810
  format: int64
15142
15811
  type: integer
15812
+ apm_fargate_count_avg:
15813
+ description: Shows the average of all APM ECS Fargate tasks over all hours
15814
+ in the current date for all organizations.
15815
+ format: int64
15816
+ type: integer
15143
15817
  apm_host_top99p:
15144
15818
  description: Shows the 99th percentile of all distinct APM hosts over all
15145
15819
  hours in the current date for all organizations.
@@ -15229,6 +15903,11 @@ components:
15229
15903
  Azure app services hosts over all hours in the current date for all organizations.
15230
15904
  format: int64
15231
15905
  type: integer
15906
+ cspm_aws_host_top99p:
15907
+ description: Shows the 99th percentile of all Cloud Security Posture Management
15908
+ AWS hosts over all hours in the current date for all organizations.
15909
+ format: int64
15910
+ type: integer
15232
15911
  cspm_azure_host_top99p:
15233
15912
  description: Shows the 99th percentile of all Cloud Security Posture Management
15234
15913
  Azure hosts over all hours in the current date for all organizations.
@@ -15465,6 +16144,11 @@ components:
15465
16144
  over all hours in the current date for the given org.
15466
16145
  format: int64
15467
16146
  type: integer
16147
+ apm_fargate_count_avg:
16148
+ description: Shows the average of all APM ECS Fargate tasks over all hours
16149
+ in the current months for the given org.
16150
+ format: int64
16151
+ type: integer
15468
16152
  apm_host_top99p:
15469
16153
  description: Shows the 99th percentile of all distinct APM hosts over all
15470
16154
  hours in the current date for the given org.
@@ -15555,6 +16239,11 @@ components:
15555
16239
  org.
15556
16240
  format: int64
15557
16241
  type: integer
16242
+ cspm_aws_host_top99p:
16243
+ description: Shows the 99th percentile of all Cloud Security Posture Management
16244
+ AWS hosts over all hours in the current date for the given org.
16245
+ format: int64
16246
+ type: integer
15558
16247
  cspm_azure_host_top99p:
15559
16248
  description: Shows the 99th percentile of all Cloud Security Posture Management
15560
16249
  Azure hosts over all hours in the current date for the given org.
@@ -15719,6 +16408,9 @@ components:
15719
16408
  public_id:
15720
16409
  description: The organization public id.
15721
16410
  type: string
16411
+ region:
16412
+ description: The region of the organization.
16413
+ type: string
15722
16414
  rum_browser_and_mobile_session_count:
15723
16415
  description: Shows the sum of all mobile sessions and all browser lite and
15724
16416
  legacy sessions over all hours in the current date for the given org.
@@ -15790,6 +16482,11 @@ components:
15790
16482
  over all hours in the current months all organizations.
15791
16483
  format: int64
15792
16484
  type: integer
16485
+ apm_fargate_count_avg_sum:
16486
+ description: Shows the average of all APM ECS Fargate tasks over all hours
16487
+ in the current months for all organizations.
16488
+ format: int64
16489
+ type: integer
15793
16490
  apm_host_top99p_sum:
15794
16491
  description: Shows the 99th percentile of all distinct APM hosts over all
15795
16492
  hours in the current months for all organizations.
@@ -15886,6 +16583,11 @@ components:
15886
16583
  organizations.
15887
16584
  format: int64
15888
16585
  type: integer
16586
+ cspm_aws_host_top99p_sum:
16587
+ description: Shows the 99th percentile of all Cloud Security Posture Management
16588
+ AWS hosts over all hours in the current months for all organizations.
16589
+ format: int64
16590
+ type: integer
15889
16591
  cspm_azure_host_top99p_sum:
15890
16592
  description: Shows the 99th percentile of all Cloud Security Posture Management
15891
16593
  Azure hosts over all hours in the current months for all organizations.
@@ -16739,6 +17441,7 @@ components:
16739
17441
  - $ref: '#/components/schemas/QueryValueWidgetDefinition'
16740
17442
  - $ref: '#/components/schemas/ScatterPlotWidgetDefinition'
16741
17443
  - $ref: '#/components/schemas/SLOWidgetDefinition'
17444
+ - $ref: '#/components/schemas/SLOListWidgetDefinition'
16742
17445
  - $ref: '#/components/schemas/ServiceMapWidgetDefinition'
16743
17446
  - $ref: '#/components/schemas/ServiceSummaryWidgetDefinition'
16744
17447
  - $ref: '#/components/schemas/SunburstWidgetDefinition'
@@ -16748,6 +17451,7 @@ components:
16748
17451
  - $ref: '#/components/schemas/TreeMapWidgetDefinition'
16749
17452
  - $ref: '#/components/schemas/ListStreamWidgetDefinition'
16750
17453
  - $ref: '#/components/schemas/FunnelWidgetDefinition'
17454
+ - $ref: '#/components/schemas/TopologyMapWidgetDefinition'
16751
17455
  type: object
16752
17456
  WidgetDisplayType:
16753
17457
  description: Type of display to use for the request.
@@ -17072,6 +17776,8 @@ components:
17072
17776
  - tags,desc
17073
17777
  - triggered,asc
17074
17778
  - triggered,desc
17779
+ - priority,asc
17780
+ - priority,desc
17075
17781
  example: name,asc
17076
17782
  type: string
17077
17783
  x-enum-varnames:
@@ -17090,6 +17796,8 @@ components:
17090
17796
  - TAGS_DESCENDING
17091
17797
  - TRIGGERED_ASCENDING
17092
17798
  - TRIGGERED_DESCENDING
17799
+ - PRIORITY_ASCENDING
17800
+ - PRIORITY_DESCENDING
17093
17801
  WidgetNodeType:
17094
17802
  description: Which type of node to use in the map.
17095
17803
  enum:
@@ -17416,9 +18124,6 @@ paths:
17416
18124
  summary: List IP Ranges
17417
18125
  tags:
17418
18126
  - IP Ranges
17419
- x-menu-order: 1
17420
- x-undo:
17421
- type: safe
17422
18127
  /api/v1/api_key:
17423
18128
  get:
17424
18129
  description: Get all API keys available for your account.
@@ -17441,9 +18146,6 @@ paths:
17441
18146
  summary: Get all API keys
17442
18147
  tags:
17443
18148
  - Key Management
17444
- x-menu-order: 1
17445
- x-undo:
17446
- type: safe
17447
18149
  post:
17448
18150
  description: Creates an API key with a given name.
17449
18151
  operationId: CreateAPIKey
@@ -17478,13 +18180,6 @@ paths:
17478
18180
  tags:
17479
18181
  - Key Management
17480
18182
  x-codegen-request-body-name: body
17481
- x-menu-order: 2
17482
- x-undo:
17483
- operationId: DeleteAPIKey
17484
- parameters:
17485
- - name: key
17486
- source: <RESPONSE_PATH>
17487
- type: unsafe
17488
18183
  /api/v1/api_key/{key}:
17489
18184
  delete:
17490
18185
  description: Delete a given API key.
@@ -17526,9 +18221,6 @@ paths:
17526
18221
  summary: Delete an API key
17527
18222
  tags:
17528
18223
  - Key Management
17529
- x-menu-order: 5
17530
- x-undo:
17531
- type: idempotent
17532
18224
  get:
17533
18225
  description: Get a given API key.
17534
18226
  operationId: GetAPIKey
@@ -17563,9 +18255,6 @@ paths:
17563
18255
  summary: Get API key
17564
18256
  tags:
17565
18257
  - Key Management
17566
- x-menu-order: 3
17567
- x-undo:
17568
- type: safe
17569
18258
  put:
17570
18259
  description: Edit an API key name.
17571
18260
  operationId: UpdateAPIKey
@@ -17613,9 +18302,6 @@ paths:
17613
18302
  tags:
17614
18303
  - Key Management
17615
18304
  x-codegen-request-body-name: body
17616
- x-menu-order: 4
17617
- x-undo:
17618
- type: idempotent
17619
18305
  /api/v1/application_key:
17620
18306
  get:
17621
18307
  description: Get all application keys available for your Datadog account.
@@ -17638,9 +18324,6 @@ paths:
17638
18324
  summary: Get all application keys
17639
18325
  tags:
17640
18326
  - Key Management
17641
- x-menu-order: 6
17642
- x-undo:
17643
- type: safe
17644
18327
  post:
17645
18328
  description: Create an application key with a given name.
17646
18329
  operationId: CreateApplicationKey
@@ -17681,13 +18364,6 @@ paths:
17681
18364
  tags:
17682
18365
  - Key Management
17683
18366
  x-codegen-request-body-name: body
17684
- x-menu-order: 7
17685
- x-undo:
17686
- operationId: DeleteApplicationKey
17687
- parameters:
17688
- - name: key
17689
- source: <RESPONSE_PATH>
17690
- type: unsafe
17691
18367
  /api/v1/application_key/{key}:
17692
18368
  delete:
17693
18369
  description: Delete a given application key.
@@ -17723,9 +18399,6 @@ paths:
17723
18399
  summary: Delete an application key
17724
18400
  tags:
17725
18401
  - Key Management
17726
- x-menu-order: 10
17727
- x-undo:
17728
- type: idempotent
17729
18402
  get:
17730
18403
  description: Get a given application key.
17731
18404
  operationId: GetApplicationKey
@@ -17760,9 +18433,6 @@ paths:
17760
18433
  summary: Get an application key
17761
18434
  tags:
17762
18435
  - Key Management
17763
- x-menu-order: 8
17764
- x-undo:
17765
- type: safe
17766
18436
  put:
17767
18437
  description: Edit an application key name.
17768
18438
  operationId: UpdateApplicationKey
@@ -17816,9 +18486,6 @@ paths:
17816
18486
  tags:
17817
18487
  - Key Management
17818
18488
  x-codegen-request-body-name: body
17819
- x-menu-order: 9
17820
- x-undo:
17821
- type: idempotent
17822
18489
  /api/v1/check_run:
17823
18490
  post:
17824
18491
  description: 'Submit a list of Service Checks.
@@ -17876,13 +18543,15 @@ paths:
17876
18543
  tags:
17877
18544
  - Service Checks
17878
18545
  x-codegen-request-body-name: body
17879
- x-menu-order: 1
17880
- x-undo:
17881
- type: safe
17882
18546
  /api/v1/daily_custom_reports:
17883
18547
  get:
17884
18548
  deprecated: true
17885
- description: Get daily custom reports.
18549
+ description: 'Get daily custom reports.
18550
+
18551
+ **Note:** This endpoint will be fully deprecated on December 1, 2022.
18552
+
18553
+ Refer to [Migrating from v1 to v2 of the Usage Attribution API](https://docs.datadoghq.com/account_management/guide/usage-attribution-migration/)
18554
+ for the associated migration guide.'
17886
18555
  operationId: GetDailyCustomReports
17887
18556
  parameters:
17888
18557
  - description: The number of files to return in the response. `[default=60]`.
@@ -17939,16 +18608,15 @@ paths:
17939
18608
  summary: Get the list of available daily custom reports
17940
18609
  tags:
17941
18610
  - Usage Metering
17942
- x-menu-order: 40
17943
- x-undo:
17944
- type: safe
17945
- x-unstable: '**Note**: This endpoint is in public beta.
17946
-
17947
- If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
17948
18611
  /api/v1/daily_custom_reports/{report_id}:
17949
18612
  get:
17950
18613
  deprecated: true
17951
- description: Get specified daily custom reports.
18614
+ description: 'Get specified daily custom reports.
18615
+
18616
+ **Note:** This endpoint will be fully deprecated on December 1, 2022.
18617
+
18618
+ Refer to [Migrating from v1 to v2 of the Usage Attribution API](https://docs.datadoghq.com/account_management/guide/usage-attribution-migration/)
18619
+ for the associated migration guide.'
17952
18620
  operationId: GetSpecifiedDailyCustomReports
17953
18621
  parameters:
17954
18622
  - description: Date of the report in the format `YYYY-MM-DD`.
@@ -17990,12 +18658,6 @@ paths:
17990
18658
  summary: Get specified daily custom reports
17991
18659
  tags:
17992
18660
  - Usage Metering
17993
- x-menu-order: 41
17994
- x-undo:
17995
- type: safe
17996
- x-unstable: '**Note**: This endpoint is in public beta.
17997
-
17998
- If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
17999
18661
  /api/v1/dashboard:
18000
18662
  delete:
18001
18663
  description: Delete dashboards using the specified IDs. If there are any failures,
@@ -18048,9 +18710,6 @@ paths:
18048
18710
  tags:
18049
18711
  - Dashboards
18050
18712
  x-codegen-request-body-name: body
18051
- x-menu-order: 4
18052
- x-undo:
18053
- type: idempotent
18054
18713
  get:
18055
18714
  description: 'Get all dashboards.
18056
18715
 
@@ -18099,9 +18758,6 @@ paths:
18099
18758
  summary: Get all dashboards
18100
18759
  tags:
18101
18760
  - Dashboards
18102
- x-menu-order: 2
18103
- x-undo:
18104
- type: safe
18105
18761
  patch:
18106
18762
  description: Restore dashboards using the specified IDs. If there are any failures,
18107
18763
  no dashboards will be restored (partial success is not allowed).
@@ -18153,9 +18809,6 @@ paths:
18153
18809
  tags:
18154
18810
  - Dashboards
18155
18811
  x-codegen-request-body-name: body
18156
- x-menu-order: 5
18157
- x-undo:
18158
- type: idempotent
18159
18812
  post:
18160
18813
  description: 'Create a dashboard using the specified options. When defining
18161
18814
  queries in your widgets, take note of which queries should have the `as_count()`
@@ -18201,24 +18854,6 @@ paths:
18201
18854
  tags:
18202
18855
  - Dashboards
18203
18856
  x-codegen-request-body-name: body
18204
- x-given:
18205
- dashboard:
18206
- parameters:
18207
- - file: dashboard_payload.json
18208
- name: body
18209
- step: there is a valid "dashboard" in the system
18210
- screenboard_dashboard:
18211
- parameters:
18212
- - file: screenboard_dashboard_payload.json
18213
- name: body
18214
- step: there is a valid "screenboard_dashboard" in the system
18215
- x-menu-order: 1
18216
- x-undo:
18217
- operationId: DeleteDashboard
18218
- parameters:
18219
- - name: dashboard_id
18220
- source: id
18221
- type: unsafe
18222
18857
  /api/v1/dashboard/lists/manual:
18223
18858
  get:
18224
18859
  description: Fetch all of your existing dashboard list definitions.
@@ -18246,9 +18881,6 @@ paths:
18246
18881
  summary: Get all dashboard lists
18247
18882
  tags:
18248
18883
  - Dashboard Lists
18249
- x-menu-order: 1
18250
- x-undo:
18251
- type: safe
18252
18884
  post:
18253
18885
  description: Create an empty dashboard list.
18254
18886
  operationId: CreateDashboardList
@@ -18289,19 +18921,6 @@ paths:
18289
18921
  tags:
18290
18922
  - Dashboard Lists
18291
18923
  x-codegen-request-body-name: body
18292
- x-given:
18293
- dashboard_list:
18294
- parameters:
18295
- - name: body
18296
- value: "{\n \"name\": \"{{ unique }}\"\n}"
18297
- step: there is a valid "dashboard_list" in the system
18298
- x-menu-order: 2
18299
- x-undo:
18300
- operationId: DeleteDashboardList
18301
- parameters:
18302
- - name: list_id
18303
- source: id
18304
- type: unsafe
18305
18924
  /api/v1/dashboard/lists/manual/{list_id}:
18306
18925
  delete:
18307
18926
  description: Delete a dashboard list.
@@ -18343,9 +18962,6 @@ paths:
18343
18962
  summary: Delete a dashboard list
18344
18963
  tags:
18345
18964
  - Dashboard Lists
18346
- x-menu-order: 5
18347
- x-undo:
18348
- type: idempotent
18349
18965
  get:
18350
18966
  description: Fetch an existing dashboard list's definition.
18351
18967
  operationId: GetDashboardList
@@ -18386,9 +19002,6 @@ paths:
18386
19002
  summary: Get a dashboard list
18387
19003
  tags:
18388
19004
  - Dashboard Lists
18389
- x-menu-order: 3
18390
- x-undo:
18391
- type: safe
18392
19005
  put:
18393
19006
  description: Update the name of a dashboard list.
18394
19007
  operationId: UpdateDashboardList
@@ -18443,9 +19056,6 @@ paths:
18443
19056
  tags:
18444
19057
  - Dashboard Lists
18445
19058
  x-codegen-request-body-name: body
18446
- x-menu-order: 4
18447
- x-undo:
18448
- type: idempotent
18449
19059
  /api/v1/dashboard/{dashboard_id}:
18450
19060
  delete:
18451
19061
  description: Delete a dashboard using the specified ID.
@@ -18486,15 +19096,6 @@ paths:
18486
19096
  summary: Delete a dashboard
18487
19097
  tags:
18488
19098
  - Dashboards
18489
- x-given:
18490
- deleted_dashboard:
18491
- parameters:
18492
- - name: dashboard_id
18493
- source: dashboard.id
18494
- step: the "dashboard" was deleted
18495
- x-menu-order: 3
18496
- x-undo:
18497
- type: idempotent
18498
19099
  get:
18499
19100
  description: Get a dashboard using the specified ID.
18500
19101
  operationId: GetDashboard
@@ -18534,9 +19135,6 @@ paths:
18534
19135
  summary: Get a dashboard
18535
19136
  tags:
18536
19137
  - Dashboards
18537
- x-menu-order: 7
18538
- x-undo:
18539
- type: safe
18540
19138
  put:
18541
19139
  description: Update a dashboard using the specified ID.
18542
19140
  operationId: UpdateDashboard
@@ -18590,9 +19188,6 @@ paths:
18590
19188
  tags:
18591
19189
  - Dashboards
18592
19190
  x-codegen-request-body-name: body
18593
- x-menu-order: 6
18594
- x-undo:
18595
- type: idempotent
18596
19191
  /api/v1/distribution_points:
18597
19192
  post:
18598
19193
  description: "The distribution points end-point allows you to post distribution
@@ -18658,9 +19253,6 @@ paths:
18658
19253
  tags:
18659
19254
  - Metrics
18660
19255
  x-codegen-request-body-name: body
18661
- x-menu-order: 1
18662
- x-undo:
18663
- type: safe
18664
19256
  /api/v1/downtime:
18665
19257
  get:
18666
19258
  description: Get all scheduled downtimes.
@@ -18697,9 +19289,6 @@ paths:
18697
19289
  summary: Get all downtimes
18698
19290
  tags:
18699
19291
  - Downtimes
18700
- x-menu-order: 1
18701
- x-undo:
18702
- type: safe
18703
19292
  post:
18704
19293
  description: Schedule a downtime.
18705
19294
  operationId: CreateDowntime
@@ -18740,23 +19329,6 @@ paths:
18740
19329
  tags:
18741
19330
  - Downtimes
18742
19331
  x-codegen-request-body-name: body
18743
- x-given:
18744
- downtime:
18745
- parameters:
18746
- - name: body
18747
- value: "{\n \"message\": \"{{ unique }}\",\n \"start\": {{ timestamp(\"now\")
18748
- }},\n \"timezone\": \"Etc/UTC\",\n \"scope\": [\"test:{{ unique_lower_alnum
18749
- }}\"],\n \"recurrence\": {\n \"type\": \"weeks\",\n \"period\":
18750
- 1,\n \"week_days\": [\"Mon\", \"Tue\", \"Wed\", \"Thu\", \"Fri\"],\n
18751
- \ \"until_date\": {{ timestamp(\"now + 21d\")}}\n }\n}"
18752
- step: there is a valid "downtime" in the system
18753
- x-menu-order: 2
18754
- x-undo:
18755
- operationId: CancelDowntime
18756
- parameters:
18757
- - name: downtime_id
18758
- source: id
18759
- type: unsafe
18760
19332
  /api/v1/downtime/cancel/by_scope:
18761
19333
  post:
18762
19334
  description: Delete all downtimes that match the scope of `X`.
@@ -18804,9 +19376,6 @@ paths:
18804
19376
  tags:
18805
19377
  - Downtimes
18806
19378
  x-codegen-request-body-name: body
18807
- x-menu-order: 3
18808
- x-undo:
18809
- type: idempotent
18810
19379
  /api/v1/downtime/{downtime_id}:
18811
19380
  delete:
18812
19381
  description: Cancel a downtime.
@@ -18845,9 +19414,6 @@ paths:
18845
19414
  summary: Cancel a downtime
18846
19415
  tags:
18847
19416
  - Downtimes
18848
- x-menu-order: 4
18849
- x-undo:
18850
- type: idempotent
18851
19417
  get:
18852
19418
  description: Get downtime detail by `downtime_id`.
18853
19419
  operationId: GetDowntime
@@ -18889,9 +19455,6 @@ paths:
18889
19455
  summary: Get a downtime
18890
19456
  tags:
18891
19457
  - Downtimes
18892
- x-menu-order: 5
18893
- x-undo:
18894
- type: safe
18895
19458
  put:
18896
19459
  description: Update a single downtime by `downtime_id`.
18897
19460
  operationId: UpdateDowntime
@@ -18948,9 +19511,6 @@ paths:
18948
19511
  tags:
18949
19512
  - Downtimes
18950
19513
  x-codegen-request-body-name: body
18951
- x-menu-order: 6
18952
- x-undo:
18953
- type: idempotent
18954
19514
  /api/v1/events:
18955
19515
  get:
18956
19516
  description: "The event stream can be queried and filtered by time, priority,
@@ -19061,9 +19621,6 @@ paths:
19061
19621
  summary: Get a list of events
19062
19622
  tags:
19063
19623
  - Events
19064
- x-menu-order: 1
19065
- x-undo:
19066
- type: safe
19067
19624
  post:
19068
19625
  description: 'This endpoint allows you to post events to the stream.
19069
19626
 
@@ -19097,9 +19654,6 @@ paths:
19097
19654
  tags:
19098
19655
  - Events
19099
19656
  x-codegen-request-body-name: body
19100
- x-menu-order: 1
19101
- x-undo:
19102
- type: safe
19103
19657
  /api/v1/events/{event_id}:
19104
19658
  get:
19105
19659
  description: "This endpoint allows you to query for event details.\n\n**Note**:
@@ -19143,9 +19697,6 @@ paths:
19143
19697
  summary: Get an event
19144
19698
  tags:
19145
19699
  - Events
19146
- x-menu-order: 2
19147
- x-undo:
19148
- type: safe
19149
19700
  /api/v1/graph/snapshot:
19150
19701
  get:
19151
19702
  description: 'Take graph snapshots.
@@ -19240,9 +19791,6 @@ paths:
19240
19791
  summary: Take graph snapshots
19241
19792
  tags:
19242
19793
  - Snapshots
19243
- x-menu-order: 1
19244
- x-undo:
19245
- type: safe
19246
19794
  /api/v1/host/{host_name}/mute:
19247
19795
  post:
19248
19796
  description: Mute a host.
@@ -19286,9 +19834,6 @@ paths:
19286
19834
  tags:
19287
19835
  - Hosts
19288
19836
  x-codegen-request-body-name: body
19289
- x-menu-order: 3
19290
- x-undo:
19291
- type: safe
19292
19837
  /api/v1/host/{host_name}/unmute:
19293
19838
  post:
19294
19839
  description: Unmutes a host. This endpoint takes no JSON arguments.
@@ -19325,9 +19870,6 @@ paths:
19325
19870
  tags:
19326
19871
  - Hosts
19327
19872
  x-codegen-request-body-name: body
19328
- x-menu-order: 4
19329
- x-undo:
19330
- type: safe
19331
19873
  /api/v1/hosts:
19332
19874
  get:
19333
19875
  description: 'This endpoint allows searching for hosts by name, alias, or tag.
@@ -19421,9 +19963,6 @@ paths:
19421
19963
  summary: Get all hosts for your organization
19422
19964
  tags:
19423
19965
  - Hosts
19424
- x-menu-order: 1
19425
- x-undo:
19426
- type: safe
19427
19966
  /api/v1/hosts/totals:
19428
19967
  get:
19429
19968
  description: 'This endpoint returns the total number of active and up hosts
@@ -19469,9 +20008,6 @@ paths:
19469
20008
  summary: Get the total number of active hosts
19470
20009
  tags:
19471
20010
  - Hosts
19472
- x-menu-order: 2
19473
- x-undo:
19474
- type: safe
19475
20011
  /api/v1/integration/aws:
19476
20012
  delete:
19477
20013
  description: Delete a Datadog-AWS integration matching the specified `account_id`
@@ -19515,9 +20051,6 @@ paths:
19515
20051
  tags:
19516
20052
  - AWS Integration
19517
20053
  x-codegen-request-body-name: body
19518
- x-menu-order: 7
19519
- x-undo:
19520
- type: idempotent
19521
20054
  get:
19522
20055
  description: List all Datadog-AWS integrations available in your Datadog organization.
19523
20056
  operationId: ListAWSAccounts
@@ -19564,9 +20097,6 @@ paths:
19564
20097
  summary: List all AWS integrations
19565
20098
  tags:
19566
20099
  - AWS Integration
19567
- x-menu-order: 6
19568
- x-undo:
19569
- type: safe
19570
20100
  post:
19571
20101
  description: 'Create a Datadog-Amazon Web Services integration.
19572
20102
 
@@ -19614,11 +20144,6 @@ paths:
19614
20144
  tags:
19615
20145
  - AWS Integration
19616
20146
  x-codegen-request-body-name: body
19617
- x-menu-order: 8
19618
- x-undo:
19619
- operationId: DeleteAWSAccount
19620
- parameters: []
19621
- type: unsafe
19622
20147
  put:
19623
20148
  description: Update a Datadog-Amazon Web Services integration.
19624
20149
  operationId: UpdateAWSAccount
@@ -19683,9 +20208,6 @@ paths:
19683
20208
  tags:
19684
20209
  - AWS Integration
19685
20210
  x-codegen-request-body-name: body
19686
- x-menu-order: 9
19687
- x-undo:
19688
- type: safe
19689
20211
  /api/v1/integration/aws/available_namespace_rules:
19690
20212
  get:
19691
20213
  description: List all namespace rules for a given Datadog-AWS integration. This
@@ -19715,9 +20237,6 @@ paths:
19715
20237
  summary: List namespace rules
19716
20238
  tags:
19717
20239
  - AWS Integration
19718
- x-menu-order: 5
19719
- x-undo:
19720
- type: safe
19721
20240
  /api/v1/integration/aws/filtering:
19722
20241
  delete:
19723
20242
  description: Delete a tag filtering entry.
@@ -19756,9 +20275,6 @@ paths:
19756
20275
  tags:
19757
20276
  - AWS Integration
19758
20277
  x-codegen-request-body-name: body
19759
- x-menu-order: 3
19760
- x-undo:
19761
- type: idempotent
19762
20278
  get:
19763
20279
  description: Get all AWS tag filters.
19764
20280
  operationId: ListAWSTagFilters
@@ -19793,9 +20309,6 @@ paths:
19793
20309
  summary: Get all AWS tag filters
19794
20310
  tags:
19795
20311
  - AWS Integration
19796
- x-menu-order: 1
19797
- x-undo:
19798
- type: safe
19799
20312
  post:
19800
20313
  description: Set an AWS tag filter.
19801
20314
  operationId: CreateAWSTagFilter
@@ -19836,11 +20349,6 @@ paths:
19836
20349
  tags:
19837
20350
  - AWS Integration
19838
20351
  x-codegen-request-body-name: body
19839
- x-menu-order: 2
19840
- x-undo:
19841
- operationId: DeleteAWSTagFilter
19842
- parameters: []
19843
- type: unsafe
19844
20352
  /api/v1/integration/aws/generate_new_external_id:
19845
20353
  put:
19846
20354
  description: Generate a new AWS external ID for a given AWS account ID and role
@@ -19882,9 +20390,6 @@ paths:
19882
20390
  tags:
19883
20391
  - AWS Integration
19884
20392
  x-codegen-request-body-name: body
19885
- x-menu-order: 4
19886
- x-undo:
19887
- type: idempotent
19888
20393
  /api/v1/integration/aws/logs:
19889
20394
  delete:
19890
20395
  description: Delete a Datadog-AWS logs configuration by removing the specific
@@ -19922,9 +20427,6 @@ paths:
19922
20427
  tags:
19923
20428
  - AWS Logs Integration
19924
20429
  x-codegen-request-body-name: body
19925
- x-menu-order: 3
19926
- x-undo:
19927
- type: idempotent
19928
20430
  get:
19929
20431
  description: List all Datadog-AWS Logs integrations configured in your Datadog
19930
20432
  account.
@@ -19965,9 +20467,6 @@ paths:
19965
20467
  summary: List all AWS Logs integrations
19966
20468
  tags:
19967
20469
  - AWS Logs Integration
19968
- x-menu-order: 1
19969
- x-undo:
19970
- type: safe
19971
20470
  post:
19972
20471
  description: Attach the Lambda ARN of the Lambda created for the Datadog-AWS
19973
20472
  log collection to your AWS account ID to enable log collection.
@@ -20004,11 +20503,6 @@ paths:
20004
20503
  tags:
20005
20504
  - AWS Logs Integration
20006
20505
  x-codegen-request-body-name: body
20007
- x-menu-order: 2
20008
- x-undo:
20009
- operationId: DeleteAWSLambdaARN
20010
- parameters: []
20011
- type: unsafe
20012
20506
  /api/v1/integration/aws/logs/check_async:
20013
20507
  post:
20014
20508
  description: 'Test if permissions are present to add a log-forwarding triggers
@@ -20065,9 +20559,6 @@ paths:
20065
20559
  tags:
20066
20560
  - AWS Logs Integration
20067
20561
  x-codegen-request-body-name: body
20068
- x-menu-order: 7
20069
- x-undo:
20070
- type: safe
20071
20562
  /api/v1/integration/aws/logs/services:
20072
20563
  get:
20073
20564
  description: Get the list of current AWS services that Datadog offers automatic
@@ -20107,9 +20598,6 @@ paths:
20107
20598
  summary: Get list of AWS log ready services
20108
20599
  tags:
20109
20600
  - AWS Logs Integration
20110
- x-menu-order: 4
20111
- x-undo:
20112
- type: safe
20113
20601
  post:
20114
20602
  description: Enable automatic log collection for a list of services. This should
20115
20603
  be run after running `CreateAWSLambdaARN` to save the configuration.
@@ -20146,10 +20634,6 @@ paths:
20146
20634
  tags:
20147
20635
  - AWS Logs Integration
20148
20636
  x-codegen-request-body-name: body
20149
- x-menu-order: 5
20150
- x-undo:
20151
- operationId: TODO
20152
- type: unsafe
20153
20637
  /api/v1/integration/aws/logs/services_async:
20154
20638
  post:
20155
20639
  description: "Test if permissions are present to add log-forwarding triggers
@@ -20192,9 +20676,6 @@ paths:
20192
20676
  tags:
20193
20677
  - AWS Logs Integration
20194
20678
  x-codegen-request-body-name: body
20195
- x-menu-order: 6
20196
- x-undo:
20197
- type: safe
20198
20679
  /api/v1/integration/azure:
20199
20680
  delete:
20200
20681
  description: Delete a given Datadog-Azure integration from your Datadog account.
@@ -20232,9 +20713,6 @@ paths:
20232
20713
  tags:
20233
20714
  - Azure Integration
20234
20715
  x-codegen-request-body-name: body
20235
- x-menu-order: 3
20236
- x-undo:
20237
- type: idempotent
20238
20716
  get:
20239
20717
  description: List all Datadog-Azure integrations configured in your Datadog
20240
20718
  account.
@@ -20263,9 +20741,6 @@ paths:
20263
20741
  summary: List all Azure integrations
20264
20742
  tags:
20265
20743
  - Azure Integration
20266
- x-menu-order: 1
20267
- x-undo:
20268
- type: safe
20269
20744
  post:
20270
20745
  description: 'Create a Datadog-Azure integration.
20271
20746
 
@@ -20315,11 +20790,6 @@ paths:
20315
20790
  tags:
20316
20791
  - Azure Integration
20317
20792
  x-codegen-request-body-name: body
20318
- x-menu-order: 2
20319
- x-undo:
20320
- operationId: DeleteAzureIntegration
20321
- parameters: []
20322
- type: unsafe
20323
20793
  put:
20324
20794
  description: 'Update a Datadog-Azure integration. Requires an existing `tenant_name`
20325
20795
  and `client_id`.
@@ -20363,9 +20833,6 @@ paths:
20363
20833
  tags:
20364
20834
  - Azure Integration
20365
20835
  x-codegen-request-body-name: body
20366
- x-menu-order: 4
20367
- x-undo:
20368
- type: idempotent
20369
20836
  /api/v1/integration/azure/host_filters:
20370
20837
  post:
20371
20838
  description: Update the defined list of host filters for a given Datadog-Azure
@@ -20404,9 +20871,6 @@ paths:
20404
20871
  tags:
20405
20872
  - Azure Integration
20406
20873
  x-codegen-request-body-name: body
20407
- x-menu-order: 5
20408
- x-undo:
20409
- type: safe
20410
20874
  /api/v1/integration/gcp:
20411
20875
  delete:
20412
20876
  description: Delete a given Datadog-GCP integration.
@@ -20444,9 +20908,6 @@ paths:
20444
20908
  tags:
20445
20909
  - GCP Integration
20446
20910
  x-codegen-request-body-name: body
20447
- x-menu-order: 3
20448
- x-undo:
20449
- type: idempotent
20450
20911
  get:
20451
20912
  description: List all Datadog-GCP integrations configured in your Datadog account.
20452
20913
  operationId: ListGCPIntegration
@@ -20474,9 +20935,6 @@ paths:
20474
20935
  summary: List all GCP integrations
20475
20936
  tags:
20476
20937
  - GCP Integration
20477
- x-menu-order: 1
20478
- x-undo:
20479
- type: safe
20480
20938
  post:
20481
20939
  description: Create a Datadog-GCP integration.
20482
20940
  operationId: CreateGCPIntegration
@@ -20513,11 +20971,6 @@ paths:
20513
20971
  tags:
20514
20972
  - GCP Integration
20515
20973
  x-codegen-request-body-name: body
20516
- x-menu-order: 2
20517
- x-undo:
20518
- operationId: DeleteGCPIntegration
20519
- parameters: []
20520
- type: unsafe
20521
20974
  put:
20522
20975
  description: 'Update a Datadog-GCP integrations host_filters and/or auto-mute.
20523
20976
 
@@ -20561,9 +21014,6 @@ paths:
20561
21014
  tags:
20562
21015
  - GCP Integration
20563
21016
  x-codegen-request-body-name: body
20564
- x-menu-order: 4
20565
- x-undo:
20566
- type: idempotent
20567
21017
  /api/v1/integration/pagerduty/configuration/services:
20568
21018
  post:
20569
21019
  description: Create a new service object in the PagerDuty integration.
@@ -20600,13 +21050,6 @@ paths:
20600
21050
  tags:
20601
21051
  - PagerDuty Integration
20602
21052
  x-codegen-request-body-name: body
20603
- x-menu-order: 1
20604
- x-undo:
20605
- operationId: DeletePagerDutyIntegrationService
20606
- parameters:
20607
- - name: service_name
20608
- source: service_name
20609
- type: unsafe
20610
21053
  /api/v1/integration/pagerduty/configuration/services/{service_name}:
20611
21054
  delete:
20612
21055
  description: Delete a single service object in the Datadog-PagerDuty integration.
@@ -20638,9 +21081,6 @@ paths:
20638
21081
  summary: Delete a single service object
20639
21082
  tags:
20640
21083
  - PagerDuty Integration
20641
- x-menu-order: 4
20642
- x-undo:
20643
- type: idempotent
20644
21084
  get:
20645
21085
  description: Get service name in the Datadog-PagerDuty integration.
20646
21086
  operationId: GetPagerDutyIntegrationService
@@ -20675,9 +21115,6 @@ paths:
20675
21115
  summary: Get a single service object
20676
21116
  tags:
20677
21117
  - PagerDuty Integration
20678
- x-menu-order: 2
20679
- x-undo:
20680
- type: safe
20681
21118
  put:
20682
21119
  description: Update a single service object in the Datadog-PagerDuty integration.
20683
21120
  operationId: UpdatePagerDutyIntegrationService
@@ -20722,9 +21159,6 @@ paths:
20722
21159
  tags:
20723
21160
  - PagerDuty Integration
20724
21161
  x-codegen-request-body-name: body
20725
- x-menu-order: 3
20726
- x-undo:
20727
- type: idempotent
20728
21162
  /api/v1/integration/slack/configuration/accounts/{account_name}/channels:
20729
21163
  get:
20730
21164
  description: Get a list of all channels configured for your Datadog-Slack integration.
@@ -20761,9 +21195,6 @@ paths:
20761
21195
  summary: Get all channels in a Slack integration
20762
21196
  tags:
20763
21197
  - Slack Integration
20764
- x-menu-order: 1
20765
- x-undo:
20766
- type: safe
20767
21198
  post:
20768
21199
  description: Add a channel to your Datadog-Slack integration.
20769
21200
  operationId: CreateSlackIntegrationChannel
@@ -20807,9 +21238,6 @@ paths:
20807
21238
  tags:
20808
21239
  - Slack Integration
20809
21240
  x-codegen-request-body-name: body
20810
- x-menu-order: 2
20811
- x-undo:
20812
- type: unsafe
20813
21241
  /api/v1/integration/slack/configuration/accounts/{account_name}/channels/{channel_name}:
20814
21242
  delete:
20815
21243
  description: Remove a channel from your Datadog-Slack integration.
@@ -20843,9 +21271,6 @@ paths:
20843
21271
  summary: Remove a Slack integration channel
20844
21272
  tags:
20845
21273
  - Slack Integration
20846
- x-menu-order: 5
20847
- x-undo:
20848
- type: idempotent
20849
21274
  get:
20850
21275
  description: Get a channel configured for your Datadog-Slack integration.
20851
21276
  operationId: GetSlackIntegrationChannel
@@ -20882,9 +21307,6 @@ paths:
20882
21307
  summary: Get a Slack integration channel
20883
21308
  tags:
20884
21309
  - Slack Integration
20885
- x-menu-order: 3
20886
- x-undo:
20887
- type: safe
20888
21310
  patch:
20889
21311
  description: Update a channel used in your Datadog-Slack integration.
20890
21312
  operationId: UpdateSlackIntegrationChannel
@@ -20929,9 +21351,6 @@ paths:
20929
21351
  tags:
20930
21352
  - Slack Integration
20931
21353
  x-codegen-request-body-name: body
20932
- x-menu-order: 4
20933
- x-undo:
20934
- type: idempotent
20935
21354
  /api/v1/integration/webhooks/configuration/custom-variables:
20936
21355
  post:
20937
21356
  description: Creates an endpoint with the name `<CUSTOM_VARIABLE_NAME>`.
@@ -20968,20 +21387,6 @@ paths:
20968
21387
  tags:
20969
21388
  - Webhooks Integration
20970
21389
  x-codegen-request-body-name: body
20971
- x-given:
20972
- webhook_custom_variable:
20973
- parameters:
20974
- - name: body
20975
- value: "{\n \"name\": \"{{ unique_upper_alnum }}\",\n \"value\": \"variable-value\",\n
20976
- \ \"is_secret\": false\n}"
20977
- step: there is a valid "webhook_custom_variable" in the system
20978
- x-menu-order: 5
20979
- x-undo:
20980
- operationId: DeleteWebhooksIntegrationCustomVariable
20981
- parameters:
20982
- - name: custom_variable_name
20983
- source: name
20984
- type: unsafe
20985
21390
  /api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}:
20986
21391
  delete:
20987
21392
  description: Deletes the endpoint with the name `<CUSTOM_VARIABLE_NAME>`.
@@ -21013,9 +21418,6 @@ paths:
21013
21418
  summary: Delete a custom variable
21014
21419
  tags:
21015
21420
  - Webhooks Integration
21016
- x-menu-order: 8
21017
- x-undo:
21018
- type: idempotent
21019
21421
  get:
21020
21422
  description: 'Shows the content of the custom variable with the name `<CUSTOM_VARIABLE_NAME>`.
21021
21423
 
@@ -21061,9 +21463,6 @@ paths:
21061
21463
  summary: Get a custom variable
21062
21464
  tags:
21063
21465
  - Webhooks Integration
21064
- x-menu-order: 6
21065
- x-undo:
21066
- type: safe
21067
21466
  put:
21068
21467
  description: Updates the endpoint with the name `<CUSTOM_VARIABLE_NAME>`.
21069
21468
  operationId: UpdateWebhooksIntegrationCustomVariable
@@ -21112,9 +21511,6 @@ paths:
21112
21511
  tags:
21113
21512
  - Webhooks Integration
21114
21513
  x-codegen-request-body-name: body
21115
- x-menu-order: 7
21116
- x-undo:
21117
- type: safe
21118
21514
  /api/v1/integration/webhooks/configuration/webhooks:
21119
21515
  post:
21120
21516
  description: Creates an endpoint with the name `<WEBHOOK_NAME>`.
@@ -21151,19 +21547,6 @@ paths:
21151
21547
  tags:
21152
21548
  - Webhooks Integration
21153
21549
  x-codegen-request-body-name: body
21154
- x-given:
21155
- webhook:
21156
- parameters:
21157
- - name: body
21158
- value: "{\n \"name\": \"{{ unique }}\",\n \"url\": \"http://example.com/webhook\"\n}"
21159
- step: there is a valid "webhook" in the system
21160
- x-menu-order: 1
21161
- x-undo:
21162
- operationId: DeleteWebhooksIntegration
21163
- parameters:
21164
- - name: webhook_name
21165
- source: name
21166
- type: unsafe
21167
21550
  /api/v1/integration/webhooks/configuration/webhooks/{webhook_name}:
21168
21551
  delete:
21169
21552
  description: Deletes the endpoint with the name `<WEBHOOK NAME>`.
@@ -21195,9 +21578,6 @@ paths:
21195
21578
  summary: Delete a webhook
21196
21579
  tags:
21197
21580
  - Webhooks Integration
21198
- x-menu-order: 4
21199
- x-undo:
21200
- type: idempotent
21201
21581
  get:
21202
21582
  description: Gets the content of the webhook with the name `<WEBHOOK_NAME>`.
21203
21583
  operationId: GetWebhooksIntegration
@@ -21238,9 +21618,6 @@ paths:
21238
21618
  summary: Get a webhook integration
21239
21619
  tags:
21240
21620
  - Webhooks Integration
21241
- x-menu-order: 2
21242
- x-undo:
21243
- type: safe
21244
21621
  put:
21245
21622
  description: Updates the endpoint with the name `<WEBHOOK_NAME>`.
21246
21623
  operationId: UpdateWebhooksIntegration
@@ -21289,9 +21666,6 @@ paths:
21289
21666
  tags:
21290
21667
  - Webhooks Integration
21291
21668
  x-codegen-request-body-name: body
21292
- x-menu-order: 3
21293
- x-undo:
21294
- type: safe
21295
21669
  /api/v1/logs-queries/list:
21296
21670
  post:
21297
21671
  description: 'List endpoint returns logs that match a log search query.
@@ -21342,9 +21716,6 @@ paths:
21342
21716
  tags:
21343
21717
  - Logs
21344
21718
  x-codegen-request-body-name: body
21345
- x-menu-order: 1
21346
- x-undo:
21347
- type: safe
21348
21719
  /api/v1/logs/config/index-order:
21349
21720
  get:
21350
21721
  description: Get the current order of your log indexes. This endpoint takes
@@ -21372,9 +21743,6 @@ paths:
21372
21743
  summary: Get indexes order
21373
21744
  tags:
21374
21745
  - Logs Indexes
21375
- x-menu-order: 5
21376
- x-undo:
21377
- type: safe
21378
21746
  put:
21379
21747
  description: 'This endpoint updates the index order of your organization.
21380
21748
 
@@ -21413,9 +21781,6 @@ paths:
21413
21781
  tags:
21414
21782
  - Logs Indexes
21415
21783
  x-codegen-request-body-name: body
21416
- x-menu-order: 6
21417
- x-undo:
21418
- type: idempotent
21419
21784
  /api/v1/logs/config/indexes:
21420
21785
  get:
21421
21786
  description: 'The Index object describes the configuration of a log index.
@@ -21444,9 +21809,6 @@ paths:
21444
21809
  summary: Get all indexes
21445
21810
  tags:
21446
21811
  - Logs Indexes
21447
- x-menu-order: 1
21448
- x-undo:
21449
- type: safe
21450
21812
  post:
21451
21813
  description: Creates a new index. Returns the Index object passed in the request
21452
21814
  body when the request is successful.
@@ -21483,11 +21845,6 @@ paths:
21483
21845
  tags:
21484
21846
  - Logs Indexes
21485
21847
  x-codegen-request-body-name: body
21486
- x-menu-order: 2
21487
- x-undo:
21488
- operationId: TODO
21489
- parameters: []
21490
- type: unsafe
21491
21848
  /api/v1/logs/config/indexes/{name}:
21492
21849
  get:
21493
21850
  description: Get one log index from your organization. This endpoint takes no
@@ -21524,9 +21881,6 @@ paths:
21524
21881
  summary: Get an index
21525
21882
  tags:
21526
21883
  - Logs Indexes
21527
- x-menu-order: 3
21528
- x-undo:
21529
- type: safe
21530
21884
  put:
21531
21885
  description: "Update an index as identified by its name.\nReturns the Index
21532
21886
  object passed in the request body when the request is successful.\n\nUsing
@@ -21576,9 +21930,6 @@ paths:
21576
21930
  tags:
21577
21931
  - Logs Indexes
21578
21932
  x-codegen-request-body-name: body
21579
- x-menu-order: 4
21580
- x-undo:
21581
- type: idempotent
21582
21933
  /api/v1/logs/config/pipeline-order:
21583
21934
  get:
21584
21935
  description: 'Get the current order of your pipelines.
@@ -21607,9 +21958,6 @@ paths:
21607
21958
  summary: Get pipeline order
21608
21959
  tags:
21609
21960
  - Logs Pipelines
21610
- x-menu-order: 1
21611
- x-undo:
21612
- type: safe
21613
21961
  put:
21614
21962
  description: 'Update the order of your pipelines. Since logs are processed sequentially,
21615
21963
  reordering a pipeline may change
@@ -21661,9 +22009,6 @@ paths:
21661
22009
  tags:
21662
22010
  - Logs Pipelines
21663
22011
  x-codegen-request-body-name: body
21664
- x-menu-order: 2
21665
- x-undo:
21666
- type: idempotent
21667
22012
  /api/v1/logs/config/pipelines:
21668
22013
  get:
21669
22014
  description: 'Get all pipelines from your organization.
@@ -21692,9 +22037,6 @@ paths:
21692
22037
  summary: Get all pipelines
21693
22038
  tags:
21694
22039
  - Logs Pipelines
21695
- x-menu-order: 3
21696
- x-undo:
21697
- type: safe
21698
22040
  post:
21699
22041
  description: Create a pipeline in your organization.
21700
22042
  operationId: CreateLogsPipeline
@@ -21730,13 +22072,6 @@ paths:
21730
22072
  tags:
21731
22073
  - Logs Pipelines
21732
22074
  x-codegen-request-body-name: body
21733
- x-menu-order: 4
21734
- x-undo:
21735
- operationId: DeleteLogsPipeline
21736
- parameters:
21737
- - name: pipeline_id
21738
- source: id
21739
- type: unsafe
21740
22075
  /api/v1/logs/config/pipelines/{pipeline_id}:
21741
22076
  delete:
21742
22077
  description: 'Delete a given pipeline from your organization.
@@ -21770,9 +22105,6 @@ paths:
21770
22105
  summary: Delete a pipeline
21771
22106
  tags:
21772
22107
  - Logs Pipelines
21773
- x-menu-order: 6
21774
- x-undo:
21775
- type: idempotent
21776
22108
  get:
21777
22109
  description: 'Get a specific pipeline from your organization.
21778
22110
 
@@ -21813,9 +22145,6 @@ paths:
21813
22145
  summary: Get a pipeline
21814
22146
  tags:
21815
22147
  - Logs Pipelines
21816
- x-menu-order: 5
21817
- x-undo:
21818
- type: safe
21819
22148
  put:
21820
22149
  description: "Update a given pipeline configuration to change it\u2019s processors
21821
22150
  or their order.\n\n**Note**: Using this method updates your pipeline configuration
@@ -21861,9 +22190,6 @@ paths:
21861
22190
  tags:
21862
22191
  - Logs Pipelines
21863
22192
  x-codegen-request-body-name: body
21864
- x-menu-order: 7
21865
- x-undo:
21866
- type: idempotent
21867
22193
  /api/v1/metrics:
21868
22194
  get:
21869
22195
  description: Get the list of actively reporting metrics from a given time until
@@ -21924,9 +22250,6 @@ paths:
21924
22250
  summary: Get active metrics list
21925
22251
  tags:
21926
22252
  - Metrics
21927
- x-menu-order: 1
21928
- x-undo:
21929
- type: safe
21930
22253
  /api/v1/metrics/{metric_name}:
21931
22254
  get:
21932
22255
  description: Get metadata about a specific metric.
@@ -21967,9 +22290,6 @@ paths:
21967
22290
  summary: Get metric metadata
21968
22291
  tags:
21969
22292
  - Metrics
21970
- x-menu-order: 2
21971
- x-undo:
21972
- type: safe
21973
22293
  put:
21974
22294
  description: Edit metadata of a specific metric. Find out more about [supported
21975
22295
  types](https://docs.datadoghq.com/developers/metrics).
@@ -22019,9 +22339,6 @@ paths:
22019
22339
  tags:
22020
22340
  - Metrics
22021
22341
  x-codegen-request-body-name: body
22022
- x-menu-order: 3
22023
- x-undo:
22024
- type: idempotent
22025
22342
  /api/v1/monitor:
22026
22343
  get:
22027
22344
  description: Get details about the specified monitor from your organization.
@@ -22132,9 +22449,6 @@ paths:
22132
22449
  summary: Get all monitor details
22133
22450
  tags:
22134
22451
  - Monitors
22135
- x-menu-order: 2
22136
- x-undo:
22137
- type: safe
22138
22452
  post:
22139
22453
  description: 'Create a monitor using the specified options.
22140
22454
 
@@ -22557,19 +22871,6 @@ paths:
22557
22871
  tags:
22558
22872
  - Monitors
22559
22873
  x-codegen-request-body-name: body
22560
- x-given:
22561
- monitor:
22562
- parameters:
22563
- - file: monitor_payload.json
22564
- name: body
22565
- step: there is a valid "monitor" in the system
22566
- x-menu-order: 1
22567
- x-undo:
22568
- operationId: DeleteMonitor
22569
- parameters:
22570
- - name: monitor_id
22571
- source: id
22572
- type: unsafe
22573
22874
  /api/v1/monitor/can_delete:
22574
22875
  get:
22575
22876
  description: Check if the given monitors can be deleted.
@@ -22622,9 +22923,6 @@ paths:
22622
22923
  summary: Check if a monitor can be deleted
22623
22924
  tags:
22624
22925
  - Monitors
22625
- x-menu-order: 6
22626
- x-undo:
22627
- type: safe
22628
22926
  /api/v1/monitor/groups/search:
22629
22927
  get:
22630
22928
  description: Search and filter your monitor groups details.
@@ -22711,9 +23009,6 @@ paths:
22711
23009
  summary: Monitors group search
22712
23010
  tags:
22713
23011
  - Monitors
22714
- x-menu-order: 2
22715
- x-undo:
22716
- type: safe
22717
23012
  /api/v1/monitor/search:
22718
23013
  get:
22719
23014
  description: Search and filter your monitors details.
@@ -22800,9 +23095,6 @@ paths:
22800
23095
  summary: Monitors search
22801
23096
  tags:
22802
23097
  - Monitors
22803
- x-menu-order: 1
22804
- x-undo:
22805
- type: safe
22806
23098
  /api/v1/monitor/validate:
22807
23099
  post:
22808
23100
  description: Validate the monitor provided in the request.
@@ -22845,9 +23137,6 @@ paths:
22845
23137
  tags:
22846
23138
  - Monitors
22847
23139
  x-codegen-request-body-name: body
22848
- x-menu-order: 7
22849
- x-undo:
22850
- type: idempotent
22851
23140
  /api/v1/monitor/{monitor_id}:
22852
23141
  delete:
22853
23142
  description: Delete the specified monitor
@@ -22910,9 +23199,6 @@ paths:
22910
23199
  summary: Delete a monitor
22911
23200
  tags:
22912
23201
  - Monitors
22913
- x-menu-order: 5
22914
- x-undo:
22915
- type: idempotent
22916
23202
  get:
22917
23203
  description: Get details about the specified monitor from your organization.
22918
23204
  operationId: GetMonitor
@@ -22967,9 +23253,6 @@ paths:
22967
23253
  summary: Get a monitor's details
22968
23254
  tags:
22969
23255
  - Monitors
22970
- x-menu-order: 4
22971
- x-undo:
22972
- type: safe
22973
23256
  put:
22974
23257
  description: Edit the specified monitor.
22975
23258
  operationId: UpdateMonitor
@@ -23031,9 +23314,6 @@ paths:
23031
23314
  tags:
23032
23315
  - Monitors
23033
23316
  x-codegen-request-body-name: body
23034
- x-menu-order: 3
23035
- x-undo:
23036
- type: idempotent
23037
23317
  /api/v1/monitor/{monitor_id}/downtimes:
23038
23318
  get:
23039
23319
  description: Get all active downtimes for the specified monitor.
@@ -23078,9 +23358,6 @@ paths:
23078
23358
  tags:
23079
23359
  - Downtimes
23080
23360
  x-codegen-request-body-name: body
23081
- x-menu-order: 7
23082
- x-undo:
23083
- type: safe
23084
23361
  /api/v1/monitor/{monitor_id}/validate:
23085
23362
  post:
23086
23363
  description: Validate the monitor provided in the request.
@@ -23132,13 +23409,15 @@ paths:
23132
23409
  tags:
23133
23410
  - Monitors
23134
23411
  x-codegen-request-body-name: body
23135
- x-menu-order: 8
23136
- x-undo:
23137
- type: idempotent
23138
23412
  /api/v1/monthly_custom_reports:
23139
23413
  get:
23140
23414
  deprecated: true
23141
- description: Get monthly custom reports.
23415
+ description: 'Get monthly custom reports.
23416
+
23417
+ **Note:** This endpoint will be fully deprecated on December 1, 2022.
23418
+
23419
+ Refer to [Migrating from v1 to v2 of the Usage Attribution API](https://docs.datadoghq.com/account_management/guide/usage-attribution-migration/)
23420
+ for the associated migration guide.'
23142
23421
  operationId: GetMonthlyCustomReports
23143
23422
  parameters:
23144
23423
  - description: The number of files to return in the response `[default=60].`
@@ -23195,16 +23474,15 @@ paths:
23195
23474
  summary: Get the list of available monthly custom reports
23196
23475
  tags:
23197
23476
  - Usage Metering
23198
- x-menu-order: 42
23199
- x-undo:
23200
- type: safe
23201
- x-unstable: '**Note**: This endpoint is in public beta.
23202
-
23203
- If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
23204
23477
  /api/v1/monthly_custom_reports/{report_id}:
23205
23478
  get:
23206
23479
  deprecated: true
23207
- description: Get specified monthly custom reports.
23480
+ description: 'Get specified monthly custom reports.
23481
+
23482
+ **Note:** This endpoint will be fully deprecated on December 1, 2022.
23483
+
23484
+ Refer to [Migrating from v1 to v2 of the Usage Attribution API](https://docs.datadoghq.com/account_management/guide/usage-attribution-migration/)
23485
+ for the associated migration guide.'
23208
23486
  operationId: GetSpecifiedMonthlyCustomReports
23209
23487
  parameters:
23210
23488
  - description: Date of the report in the format `YYYY-MM-DD`.
@@ -23252,12 +23530,6 @@ paths:
23252
23530
  summary: Get specified monthly custom reports
23253
23531
  tags:
23254
23532
  - Usage Metering
23255
- x-menu-order: 43
23256
- x-undo:
23257
- type: safe
23258
- x-unstable: '**Note**: This endpoint is in public beta.
23259
-
23260
- If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
23261
23533
  /api/v1/notebooks:
23262
23534
  get:
23263
23535
  description: 'Get all notebooks. This can also be used to search for notebooks
@@ -23380,8 +23652,6 @@ paths:
23380
23652
  summary: Get all notebooks
23381
23653
  tags:
23382
23654
  - Notebooks
23383
- x-undo:
23384
- type: safe
23385
23655
  post:
23386
23656
  description: Create a notebook using the specified options.
23387
23657
  operationId: CreateNotebook
@@ -23454,18 +23724,6 @@ paths:
23454
23724
  tags:
23455
23725
  - Notebooks
23456
23726
  x-codegen-request-body-name: body
23457
- x-given:
23458
- notebook:
23459
- parameters:
23460
- - file: notebook_payload.json
23461
- name: body
23462
- step: there is a valid "notebook" in the system
23463
- x-undo:
23464
- operationId: DeleteNotebook
23465
- parameters:
23466
- - name: notebook_id
23467
- source: data.id
23468
- type: unsafe
23469
23727
  /api/v1/notebooks/{notebook_id}:
23470
23728
  delete:
23471
23729
  description: Delete a notebook using the specified ID.
@@ -23504,8 +23762,6 @@ paths:
23504
23762
  summary: Delete a notebook
23505
23763
  tags:
23506
23764
  - Notebooks
23507
- x-undo:
23508
- type: idempotent
23509
23765
  get:
23510
23766
  description: Get a notebook using the specified notebook ID.
23511
23767
  operationId: GetNotebook
@@ -23547,8 +23803,6 @@ paths:
23547
23803
  summary: Get a notebook
23548
23804
  tags:
23549
23805
  - Notebooks
23550
- x-undo:
23551
- type: safe
23552
23806
  put:
23553
23807
  description: Update a notebook using the specified ID.
23554
23808
  operationId: UpdateNotebook
@@ -23642,8 +23896,6 @@ paths:
23642
23896
  tags:
23643
23897
  - Notebooks
23644
23898
  x-codegen-request-body-name: body
23645
- x-undo:
23646
- type: idempotent
23647
23899
  /api/v1/org:
23648
23900
  get:
23649
23901
  description: This endpoint returns data on your top-level organization.
@@ -23666,9 +23918,6 @@ paths:
23666
23918
  summary: List your managed organizations
23667
23919
  tags:
23668
23920
  - Organizations
23669
- x-menu-order: 2
23670
- x-undo:
23671
- type: safe
23672
23921
  post:
23673
23922
  description: 'Create a child organization.
23674
23923
 
@@ -23720,11 +23969,6 @@ paths:
23720
23969
  tags:
23721
23970
  - Organizations
23722
23971
  x-codegen-request-body-name: body
23723
- x-menu-order: 1
23724
- x-undo:
23725
- operationId: TODO
23726
- parameters: []
23727
- type: unsafe
23728
23972
  /api/v1/org/{public_id}:
23729
23973
  get:
23730
23974
  description: Get organization information.
@@ -23761,9 +24005,6 @@ paths:
23761
24005
  summary: Get organization information
23762
24006
  tags:
23763
24007
  - Organizations
23764
- x-menu-order: 3
23765
- x-undo:
23766
- type: safe
23767
24008
  put:
23768
24009
  description: Update your organization.
23769
24010
  operationId: UpdateOrg
@@ -23806,9 +24047,6 @@ paths:
23806
24047
  tags:
23807
24048
  - Organizations
23808
24049
  x-codegen-request-body-name: body
23809
- x-menu-order: 4
23810
- x-undo:
23811
- type: idempotent
23812
24050
  /api/v1/org/{public_id}/downgrade:
23813
24051
  post:
23814
24052
  description: Only available for MSP customers. Removes a child organization
@@ -23847,9 +24085,6 @@ paths:
23847
24085
  summary: Spin-off Child Organization
23848
24086
  tags:
23849
24087
  - Organizations
23850
- x-menu-order: 6
23851
- x-undo:
23852
- type: unsafe
23853
24088
  /api/v1/org/{public_id}/idp_metadata:
23854
24089
  post:
23855
24090
  description: 'There are a couple of options for updating the Identity Provider
@@ -23908,9 +24143,6 @@ paths:
23908
24143
  tags:
23909
24144
  - Organizations
23910
24145
  x-codegen-request-body-name: body
23911
- x-menu-order: 5
23912
- x-undo:
23913
- type: safe
23914
24146
  /api/v1/query:
23915
24147
  get:
23916
24148
  description: Query timeseries points.
@@ -23965,9 +24197,6 @@ paths:
23965
24197
  summary: Query timeseries points
23966
24198
  tags:
23967
24199
  - Metrics
23968
- x-menu-order: 5
23969
- x-undo:
23970
- type: safe
23971
24200
  /api/v1/search:
23972
24201
  get:
23973
24202
  description: Search for metrics from the last 24 hours in Datadog.
@@ -24008,9 +24237,6 @@ paths:
24008
24237
  summary: Search metrics
24009
24238
  tags:
24010
24239
  - Metrics
24011
- x-menu-order: 4
24012
- x-undo:
24013
- type: safe
24014
24240
  /api/v1/security_analytics/signals/{signal_id}/add_to_incident:
24015
24241
  patch:
24016
24242
  description: Add a security signal to an incident. This makes it possible to
@@ -24057,8 +24283,6 @@ paths:
24057
24283
  tags:
24058
24284
  - Security Monitoring
24059
24285
  x-codegen-request-body-name: body
24060
- x-undo:
24061
- type: idempotent
24062
24286
  /api/v1/security_analytics/signals/{signal_id}/assignee:
24063
24287
  patch:
24064
24288
  description: Modify the triage assignee of a security signal.
@@ -24103,8 +24327,6 @@ paths:
24103
24327
  tags:
24104
24328
  - Security Monitoring
24105
24329
  x-codegen-request-body-name: body
24106
- x-undo:
24107
- type: idempotent
24108
24330
  /api/v1/security_analytics/signals/{signal_id}/state:
24109
24331
  patch:
24110
24332
  description: Change the triage state of a security signal.
@@ -24149,8 +24371,6 @@ paths:
24149
24371
  tags:
24150
24372
  - Security Monitoring
24151
24373
  x-codegen-request-body-name: body
24152
- x-undo:
24153
- type: idempotent
24154
24374
  /api/v1/series:
24155
24375
  post:
24156
24376
  description: "The metrics end-point allows you to post time-series data that
@@ -24223,15 +24443,6 @@ paths:
24223
24443
  tags:
24224
24444
  - Metrics
24225
24445
  x-codegen-request-body-name: body
24226
- x-given:
24227
- metric:
24228
- parameters:
24229
- - file: metric_payload.json
24230
- name: body
24231
- step: there is a valid "metric" in the system
24232
- x-menu-order: 1
24233
- x-undo:
24234
- type: safe
24235
24446
  /api/v1/slo:
24236
24447
  get:
24237
24448
  description: Get a list of service level objective objects for your organization.
@@ -24311,9 +24522,6 @@ paths:
24311
24522
  summary: Get all SLOs
24312
24523
  tags:
24313
24524
  - Service Level Objectives
24314
- x-menu-order: 2
24315
- x-undo:
24316
- type: safe
24317
24525
  post:
24318
24526
  description: Create a service level objective object.
24319
24527
  operationId: CreateSLO
@@ -24349,23 +24557,6 @@ paths:
24349
24557
  tags:
24350
24558
  - Service Level Objectives
24351
24559
  x-codegen-request-body-name: body
24352
- x-given:
24353
- slo:
24354
- parameters:
24355
- - name: body
24356
- value: "{\n \"type\": \"metric\",\n \"name\": \"{{ unique }}\",\n \"thresholds\":
24357
- [{\n \"timeframe\": \"7d\",\n \"target\": 95.0,\n \"warning\":
24358
- 98.0\n }],\n \"query\": {\n \"numerator\": \"sum:httpservice.hits{code:2xx}.as_count()\",\n
24359
- \ \"denominator\": \"sum:httpservice.hits{!code:3xx}.as_count()\"\n
24360
- \ }\n}"
24361
- step: there is a valid "slo" in the system
24362
- x-menu-order: 1
24363
- x-undo:
24364
- operationId: DeleteSLO
24365
- parameters:
24366
- - name: slo_id
24367
- source: data[0].id
24368
- type: unsafe
24369
24560
  /api/v1/slo/bulk_delete:
24370
24561
  post:
24371
24562
  description: 'Delete (or partially delete) multiple service level objective
@@ -24411,9 +24602,6 @@ paths:
24411
24602
  tags:
24412
24603
  - Service Level Objectives
24413
24604
  x-codegen-request-body-name: body
24414
- x-menu-order: 8
24415
- x-undo:
24416
- type: idempotent
24417
24605
  /api/v1/slo/can_delete:
24418
24606
  get:
24419
24607
  description: 'Check if an SLO can be safely deleted. For example,
@@ -24459,9 +24647,6 @@ paths:
24459
24647
  summary: Check if SLOs can be safely deleted
24460
24648
  tags:
24461
24649
  - Service Level Objectives
24462
- x-menu-order: 7
24463
- x-undo:
24464
- type: safe
24465
24650
  /api/v1/slo/correction:
24466
24651
  get:
24467
24652
  description: Get all Service Level Objective corrections.
@@ -24484,9 +24669,6 @@ paths:
24484
24669
  summary: Get all SLO corrections
24485
24670
  tags:
24486
24671
  - Service Level Objective Corrections
24487
- x-menu-order: 2
24488
- x-undo:
24489
- type: safe
24490
24672
  post:
24491
24673
  description: Create an SLO Correction.
24492
24674
  operationId: CreateSLOCorrection
@@ -24528,23 +24710,6 @@ paths:
24528
24710
  tags:
24529
24711
  - Service Level Objective Corrections
24530
24712
  x-codegen-request-body-name: body
24531
- x-given:
24532
- correction:
24533
- parameters:
24534
- - name: body
24535
- value: "{\n \"data\": {\n \"attributes\": {\n \"slo_id\": \"{{
24536
- slo.data[0].id }}\",\n \"start\": {{ timestamp(\"now\") }},\n \"end\":
24537
- {{ timestamp(\"now + 1h\") }},\n \"category\": \"Other\",\n \"timezone\":
24538
- \"UTC\",\n \"description\": \"Test Correction\"\n },\n \"type\":
24539
- \"correction\"\n }\n}"
24540
- step: there is a valid "correction" for "slo"
24541
- x-menu-order: 1
24542
- x-undo:
24543
- operationId: DeleteSLOCorrection
24544
- parameters:
24545
- - name: slo_correction_id
24546
- source: data.id
24547
- type: unsafe
24548
24713
  /api/v1/slo/correction/{slo_correction_id}:
24549
24714
  delete:
24550
24715
  description: Permanently delete the specified SLO correction object.
@@ -24576,9 +24741,6 @@ paths:
24576
24741
  summary: Delete an SLO correction
24577
24742
  tags:
24578
24743
  - Service Level Objective Corrections
24579
- x-menu-order: 5
24580
- x-undo:
24581
- type: idempotent
24582
24744
  get:
24583
24745
  description: Get an SLO correction.
24584
24746
  operationId: GetSLOCorrection
@@ -24613,9 +24775,6 @@ paths:
24613
24775
  summary: Get an SLO correction for an SLO
24614
24776
  tags:
24615
24777
  - Service Level Objective Corrections
24616
- x-menu-order: 3
24617
- x-undo:
24618
- type: safe
24619
24778
  patch:
24620
24779
  description: Update the specified SLO correction object.
24621
24780
  operationId: UpdateSLOCorrection
@@ -24664,15 +24823,16 @@ paths:
24664
24823
  tags:
24665
24824
  - Service Level Objective Corrections
24666
24825
  x-codegen-request-body-name: body
24667
- x-menu-order: 4
24668
- x-undo:
24669
- type: idempotent
24670
24826
  /api/v1/slo/search:
24671
24827
  get:
24672
24828
  description: Get a list of service level objective objects for your organization.
24673
24829
  operationId: SearchSLO
24674
24830
  parameters:
24675
- - description: The query string to filter results based on SLO names.
24831
+ - description: 'The query string to filter results based on SLO names.
24832
+
24833
+ Some examples of queries include `service:<service-name>`
24834
+
24835
+ and `<slo-name>`.'
24676
24836
  in: query
24677
24837
  name: query
24678
24838
  required: false
@@ -24693,6 +24853,12 @@ paths:
24693
24853
  schema:
24694
24854
  format: int64
24695
24855
  type: integer
24856
+ - description: Whether or not to return facet information in the response `[default=false]`.
24857
+ in: query
24858
+ name: include_facets
24859
+ required: false
24860
+ schema:
24861
+ type: boolean
24696
24862
  responses:
24697
24863
  '200':
24698
24864
  content:
@@ -24722,6 +24888,7 @@ paths:
24722
24888
  description: The regional site for Datadog customers.
24723
24889
  enum:
24724
24890
  - datadoghq.com
24891
+ - datadoghq.eu
24725
24892
  - us3.datadoghq.com
24726
24893
  - us5.datadoghq.com
24727
24894
  - ddog-gov.com
@@ -24747,12 +24914,7 @@ paths:
24747
24914
  summary: Search for SLOs
24748
24915
  tags:
24749
24916
  - Service Level Objectives
24750
- x-menu-order: 1
24751
- x-undo:
24752
- type: safe
24753
- x-unstable: '**Note**: Note: This endpoint is in public beta for US regions.
24754
-
24755
- It is not currently supported in the EU region.
24917
+ x-unstable: '**Note**: This endpoint is in public beta.
24756
24918
 
24757
24919
  If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
24758
24920
  /api/v1/slo/{slo_id}:
@@ -24808,9 +24970,6 @@ paths:
24808
24970
  summary: Delete an SLO
24809
24971
  tags:
24810
24972
  - Service Level Objectives
24811
- x-menu-order: 5
24812
- x-undo:
24813
- type: idempotent
24814
24973
  get:
24815
24974
  description: Get a service level objective object.
24816
24975
  operationId: GetSLO
@@ -24852,9 +25011,6 @@ paths:
24852
25011
  summary: Get an SLO's details
24853
25012
  tags:
24854
25013
  - Service Level Objectives
24855
- x-menu-order: 4
24856
- x-undo:
24857
- type: safe
24858
25014
  put:
24859
25015
  description: Update the specified service level objective object.
24860
25016
  operationId: UpdateSLO
@@ -24903,9 +25059,6 @@ paths:
24903
25059
  tags:
24904
25060
  - Service Level Objectives
24905
25061
  x-codegen-request-body-name: body
24906
- x-menu-order: 3
24907
- x-undo:
24908
- type: idempotent
24909
25062
  /api/v1/slo/{slo_id}/corrections:
24910
25063
  get:
24911
25064
  description: Get corrections applied to an SLO
@@ -24947,9 +25100,6 @@ paths:
24947
25100
  summary: Get Corrections For an SLO
24948
25101
  tags:
24949
25102
  - Service Level Objectives
24950
- x-menu-order: 6
24951
- x-undo:
24952
- type: safe
24953
25103
  /api/v1/slo/{slo_id}/history:
24954
25104
  get:
24955
25105
  description: "Get a specific SLO\u2019s history, regardless of its SLO type.\n\nThe
@@ -25031,9 +25181,6 @@ paths:
25031
25181
  summary: Get an SLO's history
25032
25182
  tags:
25033
25183
  - Service Level Objectives
25034
- x-menu-order: 6
25035
- x-undo:
25036
- type: safe
25037
25184
  x-unstable: '**Note**: This endpoint is in public beta.
25038
25185
 
25039
25186
  If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
@@ -25071,9 +25218,6 @@ paths:
25071
25218
  summary: Get details of batch
25072
25219
  tags:
25073
25220
  - Synthetics
25074
- x-menu-order: 15
25075
- x-undo:
25076
- type: safe
25077
25221
  /api/v1/synthetics/locations:
25078
25222
  get:
25079
25223
  description: 'Get the list of public and private locations available for Synthetic
@@ -25097,9 +25241,6 @@ paths:
25097
25241
  summary: Get all locations (public and private)
25098
25242
  tags:
25099
25243
  - Synthetics
25100
- x-menu-order: 25
25101
- x-undo:
25102
- type: safe
25103
25244
  /api/v1/synthetics/private-locations:
25104
25245
  post:
25105
25246
  description: Create a new Synthetics private location.
@@ -25141,13 +25282,6 @@ paths:
25141
25282
  tags:
25142
25283
  - Synthetics
25143
25284
  x-codegen-request-body-name: body
25144
- x-menu-order: 22
25145
- x-undo:
25146
- operationId: DeletePrivateLocation
25147
- parameters:
25148
- - name: location_id
25149
- source: private_location.id
25150
- type: unsafe
25151
25285
  /api/v1/synthetics/private-locations/{location_id}:
25152
25286
  delete:
25153
25287
  description: Delete a Synthetics private location.
@@ -25180,9 +25314,6 @@ paths:
25180
25314
  summary: Delete a private location
25181
25315
  tags:
25182
25316
  - Synthetics
25183
- x-menu-order: 26
25184
- x-undo:
25185
- type: idempotent
25186
25317
  get:
25187
25318
  description: Get a Synthetics private location.
25188
25319
  operationId: GetPrivateLocation
@@ -25218,9 +25349,6 @@ paths:
25218
25349
  summary: Get a private location
25219
25350
  tags:
25220
25351
  - Synthetics
25221
- x-menu-order: 23
25222
- x-undo:
25223
- type: safe
25224
25352
  put:
25225
25353
  description: Edit a Synthetics private location.
25226
25354
  operationId: UpdatePrivateLocation
@@ -25264,9 +25392,6 @@ paths:
25264
25392
  tags:
25265
25393
  - Synthetics
25266
25394
  x-codegen-request-body-name: body
25267
- x-menu-order: 24
25268
- x-undo:
25269
- type: idempotent
25270
25395
  /api/v1/synthetics/tests:
25271
25396
  get:
25272
25397
  description: Get the list of all Synthetic tests.
@@ -25300,9 +25425,6 @@ paths:
25300
25425
  summary: Get the list of all tests
25301
25426
  tags:
25302
25427
  - Synthetics
25303
- x-menu-order: 10
25304
- x-undo:
25305
- type: safe
25306
25428
  /api/v1/synthetics/tests/api:
25307
25429
  post:
25308
25430
  description: Create a Synthetic API test.
@@ -25471,24 +25593,6 @@ paths:
25471
25593
  tags:
25472
25594
  - Synthetics
25473
25595
  x-codegen-request-body-name: body
25474
- x-given:
25475
- synthetics_api_test:
25476
- parameters:
25477
- - file: synthetics_api_http_test_payload.json
25478
- name: body
25479
- step: there is a valid "synthetics_api_test" in the system
25480
- synthetics_api_test_with_wrong_dns:
25481
- parameters:
25482
- - file: synthetics_api_test_with_wrong_dns.json
25483
- name: body
25484
- step: there is a "synthetics_api_test_with_wrong_dns" in the system
25485
- x-menu-order: 1
25486
- x-undo:
25487
- operationId: DeleteTests
25488
- parameters:
25489
- - name: body
25490
- template: '{"public_ids": ["{{ public_id }}"]}'
25491
- type: unsafe
25492
25596
  /api/v1/synthetics/tests/api/{public_id}:
25493
25597
  get:
25494
25598
  description: 'Get the detailed configuration associated with
@@ -25533,9 +25637,6 @@ paths:
25533
25637
  summary: Get an API test
25534
25638
  tags:
25535
25639
  - Synthetics
25536
- x-menu-order: 8
25537
- x-undo:
25538
- type: safe
25539
25640
  put:
25540
25641
  description: Edit the configuration of a Synthetic API test.
25541
25642
  operationId: UpdateAPITest
@@ -25595,9 +25696,6 @@ paths:
25595
25696
  tags:
25596
25697
  - Synthetics
25597
25698
  x-codegen-request-body-name: body
25598
- x-menu-order: 3
25599
- x-undo:
25600
- type: idempotent
25601
25699
  /api/v1/synthetics/tests/browser:
25602
25700
  post:
25603
25701
  description: Create a Synthetic browser test.
@@ -25647,13 +25745,6 @@ paths:
25647
25745
  tags:
25648
25746
  - Synthetics
25649
25747
  x-codegen-request-body-name: body
25650
- x-menu-order: 2
25651
- x-undo:
25652
- operationId: DeleteTests
25653
- parameters:
25654
- - name: body
25655
- template: '{"public_ids": ["{{ public_id }}"]}'
25656
- type: unsafe
25657
25748
  /api/v1/synthetics/tests/browser/{public_id}:
25658
25749
  get:
25659
25750
  description: 'Get the detailed configuration (including steps) associated with
@@ -25698,9 +25789,6 @@ paths:
25698
25789
  summary: Get a browser test
25699
25790
  tags:
25700
25791
  - Synthetics
25701
- x-menu-order: 9
25702
- x-undo:
25703
- type: safe
25704
25792
  put:
25705
25793
  description: Edit the configuration of a Synthetic browser test.
25706
25794
  operationId: UpdateBrowserTest
@@ -25760,9 +25848,6 @@ paths:
25760
25848
  tags:
25761
25849
  - Synthetics
25762
25850
  x-codegen-request-body-name: body
25763
- x-menu-order: 4
25764
- x-undo:
25765
- type: idempotent
25766
25851
  /api/v1/synthetics/tests/browser/{public_id}/results:
25767
25852
  get:
25768
25853
  description: Get the last 50 test results summaries for a given Synthetics Browser
@@ -25831,9 +25916,6 @@ paths:
25831
25916
  tags:
25832
25917
  - Synthetics
25833
25918
  x-codegen-request-body-name: body
25834
- x-menu-order: 14
25835
- x-undo:
25836
- type: safe
25837
25919
  /api/v1/synthetics/tests/browser/{public_id}/results/{result_id}:
25838
25920
  get:
25839
25921
  description: Get a specific full result from a given (browser) Synthetic test.
@@ -25884,9 +25966,6 @@ paths:
25884
25966
  summary: Get a browser test result
25885
25967
  tags:
25886
25968
  - Synthetics
25887
- x-menu-order: 12
25888
- x-undo:
25889
- type: safe
25890
25969
  /api/v1/synthetics/tests/delete:
25891
25970
  post:
25892
25971
  description: Delete multiple Synthetic tests by ID.
@@ -25941,9 +26020,6 @@ paths:
25941
26020
  tags:
25942
26021
  - Synthetics
25943
26022
  x-codegen-request-body-name: body
25944
- x-menu-order: 16
25945
- x-undo:
25946
- type: idempotent
25947
26023
  /api/v1/synthetics/tests/trigger:
25948
26024
  post:
25949
26025
  description: Trigger a set of Synthetics tests.
@@ -25979,16 +26055,6 @@ paths:
25979
26055
  tags:
25980
26056
  - Synthetics
25981
26057
  x-codegen-request-body-name: body
25982
- x-given:
25983
- synthetics_api_test_with_wrong_dns_result:
25984
- parameters:
25985
- - name: body
25986
- value: '{"tests": [{"public_id": "{{ synthetics_api_test_with_wrong_dns.public_id
25987
- }}"}]}'
25988
- step: the "synthetics_api_test_with_wrong_dns" is triggered
25989
- x-menu-order: 7
25990
- x-undo:
25991
- type: safe
25992
26058
  /api/v1/synthetics/tests/trigger/ci:
25993
26059
  post:
25994
26060
  description: Trigger a set of Synthetics tests for continuous integration.
@@ -26024,9 +26090,6 @@ paths:
26024
26090
  tags:
26025
26091
  - Synthetics
26026
26092
  x-codegen-request-body-name: body
26027
- x-menu-order: 6
26028
- x-undo:
26029
- type: idempotent
26030
26093
  /api/v1/synthetics/tests/{public_id}:
26031
26094
  get:
26032
26095
  description: Get the detailed configuration associated with a Synthetics test.
@@ -26069,9 +26132,6 @@ paths:
26069
26132
  summary: Get a test configuration
26070
26133
  tags:
26071
26134
  - Synthetics
26072
- x-menu-order: 27
26073
- x-undo:
26074
- type: safe
26075
26135
  /api/v1/synthetics/tests/{public_id}/results:
26076
26136
  get:
26077
26137
  description: Get the last 50 test results summaries for a given Synthetics API
@@ -26138,9 +26198,6 @@ paths:
26138
26198
  tags:
26139
26199
  - Synthetics
26140
26200
  x-codegen-request-body-name: body
26141
- x-menu-order: 13
26142
- x-undo:
26143
- type: safe
26144
26201
  /api/v1/synthetics/tests/{public_id}/results/{result_id}:
26145
26202
  get:
26146
26203
  description: Get a specific full result from a given (API) Synthetic test.
@@ -26189,9 +26246,6 @@ paths:
26189
26246
  summary: Get an API test result
26190
26247
  tags:
26191
26248
  - Synthetics
26192
- x-menu-order: 11
26193
- x-undo:
26194
- type: safe
26195
26249
  /api/v1/synthetics/tests/{public_id}/status:
26196
26250
  put:
26197
26251
  description: Pause or start a Synthetics test by changing the status.
@@ -26248,9 +26302,6 @@ paths:
26248
26302
  tags:
26249
26303
  - Synthetics
26250
26304
  x-codegen-request-body-name: body
26251
- x-menu-order: 5
26252
- x-undo:
26253
- type: idempotent
26254
26305
  /api/v1/synthetics/variables:
26255
26306
  get:
26256
26307
  description: Get the list of all Synthetics global variables.
@@ -26278,9 +26329,6 @@ paths:
26278
26329
  summary: Get all global variables
26279
26330
  tags:
26280
26331
  - Synthetics
26281
- x-menu-order: 17
26282
- x-undo:
26283
- type: safe
26284
26332
  post:
26285
26333
  description: Create a Synthetics global variable.
26286
26334
  operationId: CreateGlobalVariable
@@ -26321,13 +26369,6 @@ paths:
26321
26369
  tags:
26322
26370
  - Synthetics
26323
26371
  x-codegen-request-body-name: body
26324
- x-menu-order: 18
26325
- x-undo:
26326
- operationId: DeleteGlobalVariable
26327
- parameters:
26328
- - name: variable_id
26329
- source: id
26330
- type: unsafe
26331
26372
  /api/v1/synthetics/variables/{variable_id}:
26332
26373
  delete:
26333
26374
  description: Delete a Synthetics global variable.
@@ -26370,9 +26411,6 @@ paths:
26370
26411
  summary: Delete a global variable
26371
26412
  tags:
26372
26413
  - Synthetics
26373
- x-menu-order: 21
26374
- x-undo:
26375
- type: idempotent
26376
26414
  get:
26377
26415
  description: Get the detailed configuration of a global variable.
26378
26416
  operationId: GetGlobalVariable
@@ -26412,9 +26450,6 @@ paths:
26412
26450
  summary: Get a global variable
26413
26451
  tags:
26414
26452
  - Synthetics
26415
- x-menu-order: 19
26416
- x-undo:
26417
- type: safe
26418
26453
  put:
26419
26454
  description: Edit a Synthetics global variable.
26420
26455
  operationId: EditGlobalVariable
@@ -26462,9 +26497,6 @@ paths:
26462
26497
  tags:
26463
26498
  - Synthetics
26464
26499
  x-codegen-request-body-name: body
26465
- x-menu-order: 20
26466
- x-undo:
26467
- type: idempotent
26468
26500
  /api/v1/tags/hosts:
26469
26501
  get:
26470
26502
  description: Return a mapping of tags to hosts for your whole infrastructure.
@@ -26505,9 +26537,6 @@ paths:
26505
26537
  summary: Get Tags
26506
26538
  tags:
26507
26539
  - Tags
26508
- x-menu-order: 1
26509
- x-undo:
26510
- type: safe
26511
26540
  /api/v1/tags/hosts/{host_name}:
26512
26541
  delete:
26513
26542
  description: 'This endpoint allows you to remove all user-assigned tags
@@ -26550,9 +26579,6 @@ paths:
26550
26579
  summary: Remove host tags
26551
26580
  tags:
26552
26581
  - Tags
26553
- x-menu-order: 5
26554
- x-undo:
26555
- type: idempotent
26556
26582
  get:
26557
26583
  description: Return the list of tags that apply to a given host.
26558
26584
  operationId: GetHostTags
@@ -26594,9 +26620,6 @@ paths:
26594
26620
  summary: Get host tags
26595
26621
  tags:
26596
26622
  - Tags
26597
- x-menu-order: 2
26598
- x-undo:
26599
- type: safe
26600
26623
  post:
26601
26624
  description: 'This endpoint allows you to add new tags to a host,
26602
26625
 
@@ -26651,15 +26674,6 @@ paths:
26651
26674
  tags:
26652
26675
  - Tags
26653
26676
  x-codegen-request-body-name: body
26654
- x-menu-order: 3
26655
- x-undo:
26656
- operationId: DeleteHostTags
26657
- parameters:
26658
- - name: host_name
26659
- source: <RESPONSE_PATH>
26660
- - name: source
26661
- source: <RESPONSE_PATH>
26662
- type: unsafe
26663
26677
  put:
26664
26678
  description: 'This endpoint allows you to update/replace all tags in
26665
26679
 
@@ -26713,15 +26727,14 @@ paths:
26713
26727
  tags:
26714
26728
  - Tags
26715
26729
  x-codegen-request-body-name: body
26716
- x-menu-order: 4
26717
- x-undo:
26718
- type: idempotent
26719
26730
  /api/v1/usage/analyzed_logs:
26720
26731
  get:
26721
26732
  description: 'Get hourly usage for analyzed logs (Security Monitoring).
26722
26733
 
26723
26734
  **Note:** hourly usage data for all products is now available in the [Get
26724
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
26735
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
26736
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
26737
+ for the associated migration guide.'
26725
26738
  operationId: GetUsageAnalyzedLogs
26726
26739
  parameters:
26727
26740
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -26775,13 +26788,15 @@ paths:
26775
26788
  summary: Get hourly usage for analyzed logs
26776
26789
  tags:
26777
26790
  - Usage Metering
26778
- x-menu-order: 22
26779
- x-undo:
26780
- type: safe
26781
26791
  /api/v1/usage/attribution:
26782
26792
  get:
26783
26793
  deprecated: true
26784
- description: Get usage attribution.
26794
+ description: 'Get usage attribution.
26795
+
26796
+ **Note:** This endpoint will be fully deprecated on December 1, 2022.
26797
+
26798
+ Refer to [Migrating from v1 to v2 of the Usage Attribution API](https://docs.datadoghq.com/account_management/guide/usage-attribution-migration/)
26799
+ for the associated migration guide.'
26785
26800
  operationId: GetUsageAttribution
26786
26801
  parameters:
26787
26802
  - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]`
@@ -26867,18 +26882,14 @@ paths:
26867
26882
  summary: Get usage attribution
26868
26883
  tags:
26869
26884
  - Usage Metering
26870
- x-menu-order: 39
26871
- x-undo:
26872
- type: safe
26873
- x-unstable: '**Note**: This endpoint is in public beta.
26874
-
26875
- If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
26876
26885
  /api/v1/usage/audit_logs:
26877
26886
  get:
26878
26887
  description: 'Get hourly usage for audit logs.
26879
26888
 
26880
26889
  **Note:** hourly usage data for all products is now available in the [Get
26881
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
26890
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
26891
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
26892
+ for the associated migration guide.'
26882
26893
  operationId: GetUsageAuditLogs
26883
26894
  parameters:
26884
26895
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -26932,15 +26943,14 @@ paths:
26932
26943
  summary: Get hourly usage for audit logs
26933
26944
  tags:
26934
26945
  - Usage Metering
26935
- x-menu-order: 28
26936
- x-undo:
26937
- type: safe
26938
26946
  /api/v1/usage/aws_lambda:
26939
26947
  get:
26940
26948
  description: 'Get hourly usage for lambda.
26941
26949
 
26942
26950
  **Note:** hourly usage data for all products is now available in the [Get
26943
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
26951
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
26952
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
26953
+ for the associated migration guide.'
26944
26954
  operationId: GetUsageLambda
26945
26955
  parameters:
26946
26956
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -26992,9 +27002,6 @@ paths:
26992
27002
  summary: Get hourly usage for lambda
26993
27003
  tags:
26994
27004
  - Usage Metering
26995
- x-menu-order: 18
26996
- x-undo:
26997
- type: safe
26998
27005
  /api/v1/usage/billable-summary:
26999
27006
  get:
27000
27007
  description: Get billable usage across your account.
@@ -27041,15 +27048,14 @@ paths:
27041
27048
  summary: Get billable usage across your account
27042
27049
  tags:
27043
27050
  - Usage Metering
27044
- x-menu-order: 5
27045
- x-undo:
27046
- type: safe
27047
27051
  /api/v1/usage/ci-app:
27048
27052
  get:
27049
27053
  description: 'Get hourly usage for CI visibility (tests, pipeline, and spans).
27050
27054
 
27051
27055
  **Note:** hourly usage data for all products is now available in the [Get
27052
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
27056
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
27057
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
27058
+ for the associated migration guide.'
27053
27059
  operationId: GetUsageCIApp
27054
27060
  parameters:
27055
27061
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27103,15 +27109,14 @@ paths:
27103
27109
  summary: Get hourly usage for CI visibility
27104
27110
  tags:
27105
27111
  - Usage Metering
27106
- x-menu-order: 34
27107
- x-undo:
27108
- type: safe
27109
27112
  /api/v1/usage/cspm:
27110
27113
  get:
27111
27114
  description: 'Get hourly usage for cloud security posture management (CSPM).
27112
27115
 
27113
27116
  **Note:** hourly usage data for all products is now available in the [Get
27114
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
27117
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
27118
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
27119
+ for the associated migration guide.'
27115
27120
  operationId: GetUsageCloudSecurityPostureManagement
27116
27121
  parameters:
27117
27122
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27165,15 +27170,14 @@ paths:
27165
27170
  summary: Get hourly usage for CSPM
27166
27171
  tags:
27167
27172
  - Usage Metering
27168
- x-menu-order: 27
27169
- x-undo:
27170
- type: safe
27171
27173
  /api/v1/usage/cws:
27172
27174
  get:
27173
27175
  description: 'Get hourly usage for cloud workload security.
27174
27176
 
27175
27177
  **Note:** hourly usage data for all products is now available in the [Get
27176
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
27178
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
27179
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
27180
+ for the associated migration guide.'
27177
27181
  operationId: GetUsageCWS
27178
27182
  parameters:
27179
27183
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27227,15 +27231,14 @@ paths:
27227
27231
  summary: Get hourly usage for cloud workload security
27228
27232
  tags:
27229
27233
  - Usage Metering
27230
- x-menu-order: 29
27231
- x-undo:
27232
- type: safe
27233
27234
  /api/v1/usage/dbm:
27234
27235
  get:
27235
27236
  description: 'Get hourly usage for database monitoring
27236
27237
 
27237
27238
  **Note:** hourly usage data for all products is now available in the [Get
27238
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
27239
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
27240
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
27241
+ for the associated migration guide.'
27239
27242
  operationId: GetUsageDBM
27240
27243
  parameters:
27241
27244
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27289,15 +27292,14 @@ paths:
27289
27292
  summary: Get hourly usage for database monitoring
27290
27293
  tags:
27291
27294
  - Usage Metering
27292
- x-menu-order: 30
27293
- x-undo:
27294
- type: safe
27295
27295
  /api/v1/usage/fargate:
27296
27296
  get:
27297
27297
  description: 'Get hourly usage for [Fargate](https://docs.datadoghq.com/integrations/ecs_fargate/).
27298
27298
 
27299
27299
  **Note:** hourly usage data for all products is now available in the [Get
27300
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
27300
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
27301
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
27302
+ for the associated migration guide.'
27301
27303
  operationId: GetUsageFargate
27302
27304
  parameters:
27303
27305
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -27349,15 +27351,14 @@ paths:
27349
27351
  summary: Get hourly usage for Fargate
27350
27352
  tags:
27351
27353
  - Usage Metering
27352
- x-menu-order: 17
27353
- x-undo:
27354
- type: safe
27355
27354
  /api/v1/usage/hosts:
27356
27355
  get:
27357
27356
  description: 'Get hourly usage for hosts and containers.
27358
27357
 
27359
27358
  **Note:** hourly usage data for all products is now available in the [Get
27360
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
27359
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
27360
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
27361
+ for the associated migration guide.'
27361
27362
  operationId: GetUsageHosts
27362
27363
  parameters:
27363
27364
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -27409,9 +27410,6 @@ paths:
27409
27410
  summary: Get hourly usage for hosts and containers
27410
27411
  tags:
27411
27412
  - Usage Metering
27412
- x-menu-order: 10
27413
- x-undo:
27414
- type: safe
27415
27413
  /api/v1/usage/hourly-attribution:
27416
27414
  get:
27417
27415
  description: "Get hourly usage attribution.\n\nThis API endpoint is paginated.
@@ -27499,15 +27497,14 @@ paths:
27499
27497
  summary: Get hourly usage attribution
27500
27498
  tags:
27501
27499
  - Usage Metering
27502
- x-menu-order: 2
27503
- x-undo:
27504
- type: safe
27505
27500
  /api/v1/usage/incident-management:
27506
27501
  get:
27507
27502
  description: 'Get hourly usage for incident management.
27508
27503
 
27509
27504
  **Note:** hourly usage data for all products is now available in the [Get
27510
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
27505
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
27506
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
27507
+ for the associated migration guide.'
27511
27508
  operationId: GetIncidentManagement
27512
27509
  parameters:
27513
27510
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27561,15 +27558,14 @@ paths:
27561
27558
  summary: Get hourly usage for incident management
27562
27559
  tags:
27563
27560
  - Usage Metering
27564
- x-menu-order: 25
27565
- x-undo:
27566
- type: safe
27567
27561
  /api/v1/usage/indexed-spans:
27568
27562
  get:
27569
27563
  description: 'Get hourly usage for indexed spans.
27570
27564
 
27571
27565
  **Note:** hourly usage data for all products is now available in the [Get
27572
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
27566
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
27567
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
27568
+ for the associated migration guide.'
27573
27569
  operationId: GetUsageIndexedSpans
27574
27570
  parameters:
27575
27571
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27621,15 +27617,14 @@ paths:
27621
27617
  summary: Get hourly usage for indexed spans
27622
27618
  tags:
27623
27619
  - Usage Metering
27624
- x-menu-order: 13
27625
- x-undo:
27626
- type: safe
27627
27620
  /api/v1/usage/ingested-spans:
27628
27621
  get:
27629
27622
  description: 'Get hourly usage for ingested spans.
27630
27623
 
27631
27624
  **Note:** hourly usage data for all products is now available in the [Get
27632
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
27625
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
27626
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
27627
+ for the associated migration guide.'
27633
27628
  operationId: GetIngestedSpans
27634
27629
  parameters:
27635
27630
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27683,15 +27678,14 @@ paths:
27683
27678
  summary: Get hourly usage for ingested spans
27684
27679
  tags:
27685
27680
  - Usage Metering
27686
- x-menu-order: 24
27687
- x-undo:
27688
- type: safe
27689
27681
  /api/v1/usage/iot:
27690
27682
  get:
27691
27683
  description: 'Get hourly usage for IoT.
27692
27684
 
27693
27685
  **Note:** hourly usage data for all products is now available in the [Get
27694
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
27686
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
27687
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
27688
+ for the associated migration guide.'
27695
27689
  operationId: GetUsageInternetOfThings
27696
27690
  parameters:
27697
27691
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27745,15 +27739,14 @@ paths:
27745
27739
  summary: Get hourly usage for IoT
27746
27740
  tags:
27747
27741
  - Usage Metering
27748
- x-menu-order: 26
27749
- x-undo:
27750
- type: safe
27751
27742
  /api/v1/usage/logs:
27752
27743
  get:
27753
27744
  description: 'Get hourly usage for logs.
27754
27745
 
27755
27746
  **Note:** hourly usage data for all products is now available in the [Get
27756
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
27747
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
27748
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
27749
+ for the associated migration guide.'
27757
27750
  operationId: GetUsageLogs
27758
27751
  parameters:
27759
27752
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -27805,15 +27798,14 @@ paths:
27805
27798
  summary: Get hourly usage for logs
27806
27799
  tags:
27807
27800
  - Usage Metering
27808
- x-menu-order: 11
27809
- x-undo:
27810
- type: safe
27811
27801
  /api/v1/usage/logs-by-retention:
27812
27802
  get:
27813
27803
  description: 'Get hourly usage for indexed logs by retention period.
27814
27804
 
27815
27805
  **Note:** hourly usage data for all products is now available in the [Get
27816
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
27806
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
27807
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
27808
+ for the associated migration guide.'
27817
27809
  operationId: GetUsageLogsByRetention
27818
27810
  parameters:
27819
27811
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27867,9 +27859,6 @@ paths:
27867
27859
  summary: Get hourly logs usage by retention
27868
27860
  tags:
27869
27861
  - Usage Metering
27870
- x-menu-order: 9
27871
- x-undo:
27872
- type: safe
27873
27862
  /api/v1/usage/logs_by_index:
27874
27863
  get:
27875
27864
  description: Get hourly usage for logs by index.
@@ -27932,9 +27921,6 @@ paths:
27932
27921
  summary: Get hourly usage for logs by index
27933
27922
  tags:
27934
27923
  - Usage Metering
27935
- x-menu-order: 8
27936
- x-undo:
27937
- type: safe
27938
27924
  /api/v1/usage/monthly-attribution:
27939
27925
  get:
27940
27926
  description: "Get monthly usage attribution.\n\nThis API endpoint is paginated.
@@ -28035,23 +28021,14 @@ paths:
28035
28021
  summary: Get monthly usage attribution
28036
28022
  tags:
28037
28023
  - Usage Metering
28038
- x-given:
28039
- monthly_usage_attribution:
28040
- parameters:
28041
- - name: start_month
28042
- value: '"{{ timeISO(''now - 3d'') }}"'
28043
- - name: fields
28044
- value: '"infra_host_usage"'
28045
- step: there is a valid "monthly_usage_attribution" response
28046
- x-menu-order: 3
28047
- x-undo:
28048
- type: safe
28049
28024
  /api/v1/usage/network_flows:
28050
28025
  get:
28051
28026
  description: 'Get hourly usage for network flows.
28052
28027
 
28053
28028
  **Note:** hourly usage data for all products is now available in the [Get
28054
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
28029
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
28030
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
28031
+ for the associated migration guide.'
28055
28032
  operationId: GetUsageNetworkFlows
28056
28033
  parameters:
28057
28034
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -28105,15 +28082,14 @@ paths:
28105
28082
  summary: get hourly usage for network flows
28106
28083
  tags:
28107
28084
  - Usage Metering
28108
- x-menu-order: 21
28109
- x-undo:
28110
- type: safe
28111
28085
  /api/v1/usage/network_hosts:
28112
28086
  get:
28113
28087
  description: 'Get hourly usage for network hosts.
28114
28088
 
28115
28089
  **Note:** hourly usage data for all products is now available in the [Get
28116
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
28090
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
28091
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
28092
+ for the associated migration guide.'
28117
28093
  operationId: GetUsageNetworkHosts
28118
28094
  parameters:
28119
28095
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -28165,15 +28141,14 @@ paths:
28165
28141
  summary: Get hourly usage for network hosts
28166
28142
  tags:
28167
28143
  - Usage Metering
28168
- x-menu-order: 20
28169
- x-undo:
28170
- type: safe
28171
28144
  /api/v1/usage/online-archive:
28172
28145
  get:
28173
28146
  description: 'Get hourly usage for online archive.
28174
28147
 
28175
28148
  **Note:** hourly usage data for all products is now available in the [Get
28176
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
28149
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
28150
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
28151
+ for the associated migration guide.'
28177
28152
  operationId: GetUsageOnlineArchive
28178
28153
  parameters:
28179
28154
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -28227,15 +28202,14 @@ paths:
28227
28202
  summary: Get hourly usage for online archive
28228
28203
  tags:
28229
28204
  - Usage Metering
28230
- x-menu-order: 35
28231
- x-undo:
28232
- type: safe
28233
28205
  /api/v1/usage/profiling:
28234
28206
  get:
28235
28207
  description: 'Get hourly usage for profiled hosts.
28236
28208
 
28237
28209
  **Note:** hourly usage data for all products is now available in the [Get
28238
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
28210
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
28211
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
28212
+ for the associated migration guide.'
28239
28213
  operationId: GetUsageProfiling
28240
28214
  parameters:
28241
28215
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -28289,16 +28263,15 @@ paths:
28289
28263
  summary: Get hourly usage for profiled hosts
28290
28264
  tags:
28291
28265
  - Usage Metering
28292
- x-menu-order: 33
28293
- x-undo:
28294
- type: safe
28295
28266
  /api/v1/usage/rum:
28296
28267
  get:
28297
28268
  description: 'Get hourly usage for [RUM](https://docs.datadoghq.com/real_user_monitoring/)
28298
28269
  Units.
28299
28270
 
28300
28271
  **Note:** hourly usage data for all products is now available in the [Get
28301
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
28272
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
28273
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
28274
+ for the associated migration guide.'
28302
28275
  operationId: GetUsageRumUnits
28303
28276
  parameters:
28304
28277
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -28350,16 +28323,15 @@ paths:
28350
28323
  summary: Get hourly usage for RUM units
28351
28324
  tags:
28352
28325
  - Usage Metering
28353
- x-menu-order: 32
28354
- x-undo:
28355
- type: safe
28356
28326
  /api/v1/usage/rum_sessions:
28357
28327
  get:
28358
28328
  description: 'Get hourly usage for [RUM](https://docs.datadoghq.com/real_user_monitoring/)
28359
28329
  Sessions.
28360
28330
 
28361
28331
  **Note:** hourly usage data for all products is now available in the [Get
28362
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
28332
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
28333
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
28334
+ for the associated migration guide.'
28363
28335
  operationId: GetUsageRumSessions
28364
28336
  parameters:
28365
28337
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -28417,15 +28389,14 @@ paths:
28417
28389
  summary: Get hourly usage for RUM sessions
28418
28390
  tags:
28419
28391
  - Usage Metering
28420
- x-menu-order: 19
28421
- x-undo:
28422
- type: safe
28423
28392
  /api/v1/usage/sds:
28424
28393
  get:
28425
28394
  description: 'Get hourly usage for sensitive data scanner.
28426
28395
 
28427
28396
  **Note:** hourly usage data for all products is now available in the [Get
28428
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
28397
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
28398
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
28399
+ for the associated migration guide.'
28429
28400
  operationId: GetUsageSDS
28430
28401
  parameters:
28431
28402
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -28479,15 +28450,14 @@ paths:
28479
28450
  summary: Get hourly usage for sensitive data scanner
28480
28451
  tags:
28481
28452
  - Usage Metering
28482
- x-menu-order: 31
28483
- x-undo:
28484
- type: safe
28485
28453
  /api/v1/usage/snmp:
28486
28454
  get:
28487
28455
  description: 'Get hourly usage for SNMP devices.
28488
28456
 
28489
28457
  **Note:** hourly usage data for all products is now available in the [Get
28490
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
28458
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
28459
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
28460
+ for the associated migration guide.'
28491
28461
  operationId: GetUsageSNMP
28492
28462
  parameters:
28493
28463
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -28541,9 +28511,6 @@ paths:
28541
28511
  summary: Get hourly usage for SNMP devices
28542
28512
  tags:
28543
28513
  - Usage Metering
28544
- x-menu-order: 23
28545
- x-undo:
28546
- type: safe
28547
28514
  /api/v1/usage/summary:
28548
28515
  get:
28549
28516
  description: Get usage across your multi-org account. You must have the multi-org
@@ -28607,16 +28574,15 @@ paths:
28607
28574
  summary: Get usage across your multi-org account
28608
28575
  tags:
28609
28576
  - Usage Metering
28610
- x-menu-order: 7
28611
- x-undo:
28612
- type: safe
28613
28577
  /api/v1/usage/synthetics:
28614
28578
  get:
28615
28579
  deprecated: true
28616
28580
  description: 'Get hourly usage for [synthetics checks](https://docs.datadoghq.com/synthetics/).
28617
28581
 
28618
28582
  **Note:** hourly usage data for all products is now available in the [Get
28619
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
28583
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
28584
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
28585
+ for the associated migration guide.'
28620
28586
  operationId: GetUsageSynthetics
28621
28587
  parameters:
28622
28588
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -28668,15 +28634,14 @@ paths:
28668
28634
  summary: Get hourly usage for synthetics checks
28669
28635
  tags:
28670
28636
  - Usage Metering
28671
- x-menu-order: 14
28672
- x-undo:
28673
- type: safe
28674
28637
  /api/v1/usage/synthetics_api:
28675
28638
  get:
28676
28639
  description: 'Get hourly usage for [synthetics API checks](https://docs.datadoghq.com/synthetics/).
28677
28640
 
28678
28641
  **Note:** hourly usage data for all products is now available in the [Get
28679
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
28642
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
28643
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
28644
+ for the associated migration guide.'
28680
28645
  operationId: GetUsageSyntheticsAPI
28681
28646
  parameters:
28682
28647
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -28728,15 +28693,14 @@ paths:
28728
28693
  summary: Get hourly usage for synthetics API checks
28729
28694
  tags:
28730
28695
  - Usage Metering
28731
- x-menu-order: 15
28732
- x-undo:
28733
- type: safe
28734
28696
  /api/v1/usage/synthetics_browser:
28735
28697
  get:
28736
28698
  description: 'Get hourly usage for synthetics browser checks.
28737
28699
 
28738
28700
  **Note:** hourly usage data for all products is now available in the [Get
28739
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
28701
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
28702
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
28703
+ for the associated migration guide.'
28740
28704
  operationId: GetUsageSyntheticsBrowser
28741
28705
  parameters:
28742
28706
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -28788,15 +28752,14 @@ paths:
28788
28752
  summary: Get hourly usage for synthetics browser checks
28789
28753
  tags:
28790
28754
  - Usage Metering
28791
- x-menu-order: 16
28792
- x-undo:
28793
- type: safe
28794
28755
  /api/v1/usage/timeseries:
28795
28756
  get:
28796
28757
  description: 'Get hourly usage for [custom metrics](https://docs.datadoghq.com/developers/metrics/custom_metrics/).
28797
28758
 
28798
28759
  **Note:** hourly usage data for all products is now available in the [Get
28799
- hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
28760
+ hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
28761
+ Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
28762
+ for the associated migration guide.'
28800
28763
  operationId: GetUsageTimeseries
28801
28764
  parameters:
28802
28765
  - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -28848,9 +28811,6 @@ paths:
28848
28811
  summary: Get hourly usage for custom metrics
28849
28812
  tags:
28850
28813
  - Usage Metering
28851
- x-menu-order: 12
28852
- x-undo:
28853
- type: safe
28854
28814
  /api/v1/usage/top_avg_metrics:
28855
28815
  get:
28856
28816
  description: Get all [custom metrics](https://docs.datadoghq.com/developers/metrics/custom_metrics/)
@@ -28934,9 +28894,6 @@ paths:
28934
28894
  summary: Get all custom metrics by hourly average
28935
28895
  tags:
28936
28896
  - Usage Metering
28937
- x-menu-order: 6
28938
- x-undo:
28939
- type: safe
28940
28897
  /api/v1/user:
28941
28898
  get:
28942
28899
  description: List all users for your organization.
@@ -28963,9 +28920,6 @@ paths:
28963
28920
  summary: List all users
28964
28921
  tags:
28965
28922
  - Users
28966
- x-menu-order: 2
28967
- x-undo:
28968
- type: safe
28969
28923
  post:
28970
28924
  description: 'Create a user for your organization.
28971
28925
 
@@ -29017,13 +28971,6 @@ paths:
29017
28971
  tags:
29018
28972
  - Users
29019
28973
  x-codegen-request-body-name: body
29020
- x-menu-order: 1
29021
- x-undo:
29022
- operationId: DisableUser
29023
- parameters:
29024
- - name: user_handle
29025
- source: user.handle
29026
- type: unsafe
29027
28974
  /api/v1/user/{user_handle}:
29028
28975
  delete:
29029
28976
  description: 'Delete a user from an organization.
@@ -29072,9 +29019,6 @@ paths:
29072
29019
  summary: Disable a user
29073
29020
  tags:
29074
29021
  - Users
29075
- x-menu-order: 5
29076
- x-undo:
29077
- type: idempotent
29078
29022
  get:
29079
29023
  description: Get a user's details.
29080
29024
  operationId: GetUser
@@ -29111,9 +29055,6 @@ paths:
29111
29055
  summary: Get user details
29112
29056
  tags:
29113
29057
  - Users
29114
- x-menu-order: 3
29115
- x-undo:
29116
- type: safe
29117
29058
  put:
29118
29059
  description: 'Update a user information.
29119
29060
 
@@ -29167,9 +29108,6 @@ paths:
29167
29108
  tags:
29168
29109
  - Users
29169
29110
  x-codegen-request-body-name: body
29170
- x-menu-order: 4
29171
- x-undo:
29172
- type: idempotent
29173
29111
  /api/v1/validate:
29174
29112
  get:
29175
29113
  description: Check if the API key (not the APP key) is valid. If invalid, a
@@ -29196,9 +29134,6 @@ paths:
29196
29134
  summary: Validate API key
29197
29135
  tags:
29198
29136
  - Authentication
29199
- x-menu-order: 1
29200
- x-undo:
29201
- type: safe
29202
29137
  /v1/input:
29203
29138
  post:
29204
29139
  deprecated: true
@@ -29366,9 +29301,6 @@ paths:
29366
29301
  tags:
29367
29302
  - Logs
29368
29303
  x-codegen-request-body-name: body
29369
- x-menu-order: 1
29370
- x-undo:
29371
- type: safe
29372
29304
  security:
29373
29305
  - apiKeyAuth: []
29374
29306
  appKeyAuth: []