datadog_api_client 1.9.0 → 1.10.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 (137) hide show
  1. checksums.yaml +4 -4
  2. data/.apigentools-info +4 -4
  3. data/.generator/schemas/v1/openapi.yaml +489 -124
  4. data/.generator/schemas/v2/openapi.yaml +701 -28
  5. data/.generator/src/generator/formatter.py +6 -1
  6. data/.generator/src/generator/openapi.py +5 -5
  7. data/.generator/src/generator/templates/api_client.j2 +1 -4
  8. data/.generator/src/generator/templates/model_generic.j2 +42 -3
  9. data/.github/workflows/prepare_release.yml +15 -3
  10. data/CHANGELOG.md +32 -0
  11. data/Makefile +1 -1
  12. data/README.md +16 -0
  13. data/check-examples.sh +0 -2
  14. data/examples/v1/aws-integration/UpdateAWSAccount.rb +8 -4
  15. data/examples/v1/downtimes/CreateDowntime_2908359488.rb +1 -0
  16. data/examples/v1/downtimes/CreateDowntime_3059354445.rb +1 -0
  17. data/examples/v1/downtimes/UpdateDowntime.rb +1 -0
  18. data/examples/v1/monitors/CreateMonitor_1969035628.rb +52 -0
  19. data/examples/v1/monitors/CreateMonitor_2520912138.rb +22 -0
  20. data/examples/v1/security-monitoring/AddSecurityMonitoringSignalToIncident.rb +9 -0
  21. data/examples/v1/security-monitoring/EditSecurityMonitoringSignalAssignee.rb +9 -0
  22. data/examples/v1/security-monitoring/EditSecurityMonitoringSignalState.rb +10 -0
  23. data/examples/v1/service-level-objective-corrections/CreateSLOCorrection.rb +0 -3
  24. data/examples/v1/service-level-objective-corrections/CreateSLOCorrection_1326388368.rb +0 -3
  25. data/examples/v1/service-level-objective-corrections/DeleteSLOCorrection.rb +0 -3
  26. data/examples/v1/service-level-objective-corrections/GetSLOCorrection.rb +0 -3
  27. data/examples/v1/service-level-objective-corrections/ListSLOCorrection.rb +0 -3
  28. data/examples/v1/service-level-objective-corrections/UpdateSLOCorrection.rb +0 -3
  29. data/examples/v1/service-level-objectives/GetSLOCorrections.rb +0 -3
  30. data/examples/v1/synthetics/CreateSyntheticsAPITest.rb +5 -0
  31. data/examples/v1/synthetics/CreateSyntheticsAPITest_1402674167.rb +44 -0
  32. data/examples/v1/synthetics/CreateSyntheticsBrowserTest_2932742688.rb +64 -0
  33. data/examples/v1/synthetics/UpdateBrowserTest.rb +5 -0
  34. data/examples/v1/usage-metering/GetHourlyUsageAttribution.rb +1 -1
  35. data/examples/v1/usage-metering/GetMonthlyUsageAttribution.rb +1 -1
  36. data/examples/v1/usage-metering/{GetMonthlyUsageAttribution_3738504447.rb → GetMonthlyUsageAttribution_3849653599.rb} +1 -1
  37. data/examples/v1/usage-metering/GetUsageAttribution.rb +1 -1
  38. data/examples/v1/usage-metering/GetUsageRumSessions_3271366243.rb +9 -0
  39. data/examples/v2/logs/SubmitLog.rb +1 -0
  40. data/examples/v2/logs-archives/CreateLogsArchive.rb +1 -0
  41. data/examples/v2/logs-archives/UpdateLogsArchive.rb +1 -0
  42. data/examples/v2/metrics/EstimateMetricsOutputSeries.rb +9 -0
  43. data/examples/v2/metrics/SubmitMetrics.rb +20 -0
  44. data/examples/v2/security-monitoring/UpdateSecurityMonitoringRule.rb +1 -0
  45. data/examples/v2/usage-metering/GetCostByOrg.rb +5 -0
  46. data/examples/v2/usage-metering/GetUsageApplicationSecurityMonitoring.rb +8 -0
  47. data/examples/v2/usage-metering/GetUsageLambdaTracedInvocations.rb +8 -0
  48. data/lib/datadog_api_client/v1/api/metrics_api.rb +1 -1
  49. data/lib/datadog_api_client/v1/api/monitors_api.rb +69 -56
  50. data/lib/datadog_api_client/v1/api/security_monitoring_api.rb +266 -0
  51. data/lib/datadog_api_client/v1/api/service_level_objective_corrections_api.rb +1 -1
  52. data/lib/datadog_api_client/v1/api/usage_metering_api.rb +10 -10
  53. data/lib/datadog_api_client/v1/api_client.rb +1 -4
  54. data/lib/datadog_api_client/v1/configuration.rb +0 -6
  55. data/lib/datadog_api_client/v1/models/add_signal_to_incident_request.rb +142 -0
  56. data/lib/datadog_api_client/v1/models/downtime.rb +11 -1
  57. data/lib/datadog_api_client/v1/models/downtime_child.rb +11 -1
  58. data/lib/datadog_api_client/v1/models/event.rb +1 -1
  59. data/lib/datadog_api_client/v1/models/http_log_item.rb +29 -4
  60. data/lib/datadog_api_client/v1/models/logs_category_processor.rb +1 -1
  61. data/lib/datadog_api_client/v1/models/logs_list_request.rb +1 -1
  62. data/lib/datadog_api_client/v1/models/logs_sort.rb +1 -1
  63. data/lib/datadog_api_client/v1/models/monitor_formula_and_function_events_data_source.rb +1 -0
  64. data/lib/datadog_api_client/v1/models/monitor_group_search_response_counts.rb +2 -2
  65. data/lib/datadog_api_client/v1/models/{monitor_search_response_counts_tag_item.rb → monitor_search_count_item.rb} +3 -3
  66. data/lib/datadog_api_client/v1/models/monitor_search_response_counts.rb +4 -4
  67. data/lib/datadog_api_client/v1/models/monitor_type.rb +1 -0
  68. data/lib/datadog_api_client/v1/models/monthly_usage_attribution_response.rb +1 -1
  69. data/lib/datadog_api_client/v1/models/notebook_cell_create_request.rb +146 -0
  70. data/lib/datadog_api_client/v1/models/notebook_cell_create_request_attributes.rb +68 -0
  71. data/lib/datadog_api_client/v1/models/series.rb +2 -2
  72. data/lib/datadog_api_client/v1/models/signal_archive_reason.rb +29 -0
  73. data/lib/datadog_api_client/v1/models/signal_assignee_update_request.rb +132 -0
  74. data/lib/datadog_api_client/v1/models/signal_state_update_request.rb +152 -0
  75. data/lib/datadog_api_client/v1/models/signal_triage_state.rb +28 -0
  76. data/lib/datadog_api_client/v1/models/slo_correction_create_request_attributes.rb +1 -1
  77. data/lib/datadog_api_client/v1/models/slo_correction_response_attributes.rb +4 -4
  78. data/lib/datadog_api_client/v1/models/slo_correction_update_request_attributes.rb +1 -1
  79. data/lib/datadog_api_client/v1/models/{monitor_search_response_counts_status_item.rb → successful_signal_update_response.rb} +12 -22
  80. data/lib/datadog_api_client/v1/models/synthetics_api_test.rb +1 -1
  81. data/lib/datadog_api_client/v1/models/synthetics_assertion_type.rb +2 -0
  82. data/lib/datadog_api_client/v1/models/synthetics_browser_test_rum_settings.rb +152 -0
  83. data/lib/datadog_api_client/v1/models/synthetics_test_details.rb +1 -1
  84. data/lib/datadog_api_client/v1/models/synthetics_test_details_sub_type.rb +2 -1
  85. data/lib/datadog_api_client/v1/models/synthetics_test_options.rb +21 -1
  86. data/lib/datadog_api_client/v1/models/synthetics_test_request.rb +21 -1
  87. data/lib/datadog_api_client/v1/models/usage_attribution_response.rb +1 -1
  88. data/lib/datadog_api_client/v1/models/usage_rum_sessions_hour.rb +18 -4
  89. data/lib/datadog_api_client/v1/models/usage_summary_date.rb +11 -1
  90. data/lib/datadog_api_client/v1/models/usage_summary_date_org.rb +11 -1
  91. data/lib/datadog_api_client/v1/models/usage_summary_response.rb +11 -1
  92. data/lib/datadog_api_client/v1.rb +11 -6
  93. data/lib/datadog_api_client/v2/api/authn_mappings_api.rb +0 -2
  94. data/lib/datadog_api_client/v2/api/metrics_api.rb +173 -0
  95. data/lib/datadog_api_client/v2/api/usage_metering_api.rb +228 -0
  96. data/lib/datadog_api_client/v2/api_client.rb +1 -4
  97. data/lib/datadog_api_client/v2/models/authn_mapping.rb +1 -13
  98. data/lib/datadog_api_client/v2/models/authn_mapping_attributes.rb +1 -12
  99. data/lib/datadog_api_client/v2/models/authn_mapping_response.rb +16 -4
  100. data/lib/datadog_api_client/v2/models/authn_mappings_response.rb +13 -1
  101. data/lib/datadog_api_client/v2/models/chargeback_breakdown.rb +131 -0
  102. data/lib/datadog_api_client/v2/models/cost_by_org.rb +133 -0
  103. data/lib/datadog_api_client/v2/models/cost_by_org_attributes.rb +153 -0
  104. data/lib/datadog_api_client/v2/models/cost_by_org_response.rb +113 -0
  105. data/lib/datadog_api_client/v2/models/cost_by_org_type.rb +26 -0
  106. data/lib/datadog_api_client/v2/models/hourly_usage_type.rb +2 -0
  107. data/lib/datadog_api_client/v2/models/http_log_item.rb +40 -4
  108. data/lib/datadog_api_client/v2/models/intake_payload_accepted.rb +111 -0
  109. data/lib/datadog_api_client/v2/models/logs_archive_attributes.rb +12 -1
  110. data/lib/datadog_api_client/v2/models/logs_archive_create_request_attributes.rb +12 -1
  111. data/lib/datadog_api_client/v2/models/metric_content_encoding.rb +26 -0
  112. data/lib/datadog_api_client/v2/models/metric_estimate.rb +133 -0
  113. data/lib/datadog_api_client/v2/models/metric_estimate_attributes.rb +133 -0
  114. data/lib/datadog_api_client/v2/models/metric_estimate_resource_type.rb +26 -0
  115. data/lib/datadog_api_client/v2/models/metric_estimate_response.rb +111 -0
  116. data/lib/datadog_api_client/v2/models/metric_estimate_type.rb +28 -0
  117. data/lib/datadog_api_client/v2/models/metric_intake_type.rb +30 -0
  118. data/lib/datadog_api_client/v2/models/metric_metadata.rb +111 -0
  119. data/lib/datadog_api_client/v2/models/metric_origin.rb +170 -0
  120. data/lib/datadog_api_client/{v1/models/monitor_group_search_response_counts_type_item.rb → v2/models/metric_payload.rb} +27 -24
  121. data/lib/datadog_api_client/v2/models/metric_point.rb +122 -0
  122. data/lib/datadog_api_client/{v1/models/monitor_search_response_counts_type_item.rb → v2/models/metric_resource.rb} +21 -21
  123. data/lib/datadog_api_client/v2/models/metric_series.rb +220 -0
  124. data/lib/datadog_api_client/v2/models/relationship_to_saml_assertion_attribute_data.rb +1 -5
  125. data/lib/datadog_api_client/v2/models/saml_assertion_attribute.rb +1 -5
  126. data/lib/datadog_api_client/v2/models/security_monitoring_rule_detection_method.rb +1 -0
  127. data/lib/datadog_api_client/v2/models/security_monitoring_rule_hardcoded_evaluator_type.rb +26 -0
  128. data/lib/datadog_api_client/v2/models/security_monitoring_rule_options.rb +11 -1
  129. data/lib/datadog_api_client/{v1/models/monitor_group_search_response_counts_status_item.rb → v2/models/usage_application_security_monitoring_response.rb} +16 -24
  130. data/lib/datadog_api_client/{v1/models/monitor_search_response_counts_muted_item.rb → v2/models/usage_lambda_traced_invocations_response.rb} +16 -24
  131. data/lib/datadog_api_client/v2.rb +22 -0
  132. data/lib/datadog_api_client/version.rb +1 -1
  133. data/spec/v1/api_client_spec.rb +3 -3
  134. data/spec/v2/api_client_spec.rb +3 -3
  135. metadata +49 -11
  136. data/extract-code-blocks.awk +0 -81
  137. data/extract-code-blocks.sh +0 -3
@@ -850,11 +850,6 @@ components:
850
850
  description: ID of the AuthN Mapping.
851
851
  example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d
852
852
  type: string
853
- included:
854
- description: Included data in the AuthN Mapping response.
855
- items:
856
- $ref: '#/components/schemas/AuthNMappingIncluded'
857
- type: array
858
853
  relationships:
859
854
  $ref: '#/components/schemas/AuthNMappingRelationships'
860
855
  type:
@@ -888,10 +883,8 @@ components:
888
883
  type: string
889
884
  saml_assertion_attribute_id:
890
885
  description: The ID of the SAML assertion attribute.
891
- example: 0
892
- format: int32
893
- maximum: 2147483647
894
- type: integer
886
+ example: '0'
887
+ type: string
895
888
  type: object
896
889
  AuthNMappingCreateAttributes:
897
890
  description: Key/Value pair of attributes used for create request.
@@ -953,6 +946,11 @@ components:
953
946
  properties:
954
947
  data:
955
948
  $ref: '#/components/schemas/AuthNMapping'
949
+ included:
950
+ description: Included data in the AuthN Mapping response.
951
+ items:
952
+ $ref: '#/components/schemas/AuthNMappingIncluded'
953
+ type: array
956
954
  type: object
957
955
  AuthNMappingUpdateAttributes:
958
956
  description: Key/Value pair of attributes used for update request.
@@ -1007,6 +1005,11 @@ components:
1007
1005
  items:
1008
1006
  $ref: '#/components/schemas/AuthNMapping'
1009
1007
  type: array
1008
+ included:
1009
+ description: Included data in the AuthN Mapping response.
1010
+ items:
1011
+ $ref: '#/components/schemas/AuthNMappingIncluded'
1012
+ type: array
1010
1013
  meta:
1011
1014
  $ref: '#/components/schemas/ResponseMetaAttributes'
1012
1015
  type: object
@@ -1048,6 +1051,23 @@ components:
1048
1051
  type: string
1049
1052
  x-enum-varnames:
1050
1053
  - AUTHN_MAPPINGS
1054
+ ChargebackBreakdown:
1055
+ description: Charges breakdown.
1056
+ properties:
1057
+ charge_type:
1058
+ description: The type of charge for a particular product.
1059
+ example: on_demand
1060
+ type: string
1061
+ cost:
1062
+ description: The cost for a particular product and charge type during a
1063
+ given month.
1064
+ format: double
1065
+ type: number
1066
+ product_name:
1067
+ description: The product for which cost is being reported.
1068
+ example: infra_host
1069
+ type: string
1070
+ type: object
1051
1071
  CloudWorkloadSecurityAgentRuleAttributes:
1052
1072
  description: A Cloud Workload Security Agent rule returned by the API.
1053
1073
  properties:
@@ -1242,6 +1262,58 @@ components:
1242
1262
  x-enum-varnames:
1243
1263
  - GZIP
1244
1264
  - DEFLATE
1265
+ CostByOrg:
1266
+ description: Cost data.
1267
+ properties:
1268
+ attributes:
1269
+ $ref: '#/components/schemas/CostByOrgAttributes'
1270
+ id:
1271
+ description: Unique ID of the response.
1272
+ type: string
1273
+ type:
1274
+ $ref: '#/components/schemas/CostByOrgType'
1275
+ type: object
1276
+ CostByOrgAttributes:
1277
+ description: Cost attributes data.
1278
+ properties:
1279
+ charges:
1280
+ description: List of charges data reported for the requested month.
1281
+ items:
1282
+ $ref: '#/components/schemas/ChargebackBreakdown'
1283
+ type: array
1284
+ date:
1285
+ description: The month requested.
1286
+ format: date-time
1287
+ type: string
1288
+ org_name:
1289
+ description: The organization name.
1290
+ type: string
1291
+ public_id:
1292
+ description: The organization public ID.
1293
+ type: string
1294
+ total_cost:
1295
+ description: The total cost of products for the month.
1296
+ format: double
1297
+ type: number
1298
+ type: object
1299
+ CostByOrgResponse:
1300
+ description: Chargeback Summary response.
1301
+ properties:
1302
+ data:
1303
+ description: Response containing Chargeback Summary.
1304
+ items:
1305
+ $ref: '#/components/schemas/CostByOrg'
1306
+ type: array
1307
+ type: object
1308
+ CostByOrgType:
1309
+ default: cost_by_org
1310
+ description: Type of cost data.
1311
+ enum:
1312
+ - cost_by_org
1313
+ example: cost_by_org
1314
+ type: string
1315
+ x-enum-varnames:
1316
+ - COST_BY_ORG
1245
1317
  Creator:
1246
1318
  description: Creator of the object.
1247
1319
  properties:
@@ -1551,6 +1623,9 @@ components:
1551
1623
  type: array
1552
1624
  type: object
1553
1625
  HTTPLogItem:
1626
+ additionalProperties:
1627
+ description: Additional log attributes.
1628
+ type: string
1554
1629
  description: Logs that are sent over HTTP.
1555
1630
  properties:
1556
1631
  ddsource:
@@ -1592,16 +1667,20 @@ components:
1592
1667
  example: payment
1593
1668
  type: string
1594
1669
  required:
1595
- - name
1670
+ - message
1596
1671
  type: object
1597
1672
  HourlyUsageType:
1598
1673
  description: Usage type that is being measured.
1599
1674
  enum:
1675
+ - app_sec_host_count
1600
1676
  - observability_pipelines_bytes_processed
1677
+ - lambda_traced_invocations_count
1601
1678
  example: observability_pipelines_bytes_processed
1602
1679
  type: string
1603
1680
  x-enum-varnames:
1681
+ - APP_SEC_HOST_COUNT
1604
1682
  - OBSERVABILITY_PIPELINES_BYTES_PROCESSSED
1683
+ - LAMBDA_TRACED_INVOCATIONS_COUNT
1605
1684
  IdPMetadataFormData:
1606
1685
  description: The form data submitted to upload IdP metadata
1607
1686
  properties:
@@ -2523,6 +2602,14 @@ components:
2523
2602
  required:
2524
2603
  - data
2525
2604
  type: object
2605
+ IntakePayloadAccepted:
2606
+ description: The payload accepted for intake.
2607
+ properties:
2608
+ status:
2609
+ description: The status of the intake payload.
2610
+ example: ok
2611
+ type: string
2612
+ type: object
2526
2613
  ListApplicationKeysResponse:
2527
2614
  description: Response for a list of application keys.
2528
2615
  properties:
@@ -2648,7 +2735,7 @@ components:
2648
2735
  items:
2649
2736
  $ref: '#/components/schemas/LogsAggregateBucketValueTimeseriesPoint'
2650
2737
  type: array
2651
-
2738
+ x-generate-alias-as-model: true
2652
2739
  LogsAggregateBucketValueTimeseriesPoint:
2653
2740
  description: A timeseries point
2654
2741
  properties:
@@ -2804,6 +2891,12 @@ components:
2804
2891
  in the archive.
2805
2892
  example: source:nginx
2806
2893
  type: string
2894
+ rehydration_max_scan_size_in_gb:
2895
+ description: Maximum scan size for rehydration from this archive.
2896
+ example: 100
2897
+ format: int64
2898
+ nullable: true
2899
+ type: integer
2807
2900
  rehydration_tags:
2808
2901
  description: An array of tags to add to rehydrated logs from an archive.
2809
2902
  example:
@@ -2848,6 +2941,12 @@ components:
2848
2941
  in the archive.
2849
2942
  example: source:nginx
2850
2943
  type: string
2944
+ rehydration_max_scan_size_in_gb:
2945
+ description: Maximum scan size for rehydration from this archive.
2946
+ example: 100
2947
+ format: int64
2948
+ nullable: true
2949
+ type: integer
2851
2950
  rehydration_tags:
2852
2951
  description: An array of tags to add to rehydrated logs from an archive.
2853
2952
  example:
@@ -3789,6 +3888,14 @@ components:
3789
3888
  pattern: ^[A-Za-z][A-Za-z0-9\.\-\_:\/]*$
3790
3889
  type: string
3791
3890
  type: array
3891
+ MetricContentEncoding:
3892
+ default: deflate
3893
+ description: HTTP header used to compress the media-type.
3894
+ enum:
3895
+ - deflate
3896
+ type: string
3897
+ x-enum-varnames:
3898
+ - DEFLATE
3792
3899
  MetricCustomAggregation:
3793
3900
  description: A time and space aggregation combination for use in query.
3794
3901
  example:
@@ -3902,6 +4009,63 @@ components:
3902
4009
  type: string
3903
4010
  x-enum-varnames:
3904
4011
  - DISTINCT_METRIC_VOLUMES
4012
+ MetricEstimate:
4013
+ description: Object for a metric cardinality estimate.
4014
+ properties:
4015
+ attributes:
4016
+ $ref: '#/components/schemas/MetricEstimateAttributes'
4017
+ id:
4018
+ $ref: '#/components/schemas/MetricName'
4019
+ type:
4020
+ $ref: '#/components/schemas/MetricEstimateResourceType'
4021
+ type: object
4022
+ MetricEstimateAttributes:
4023
+ description: Object containing the definition of a metric estimate attribute.
4024
+ properties:
4025
+ estimate_type:
4026
+ $ref: '#/components/schemas/MetricEstimateType'
4027
+ estimated_at:
4028
+ description: Timestamp when the cardinality estimate was requested.
4029
+ example: '2022-04-27T09:48:37.463835Z'
4030
+ format: date-time
4031
+ type: string
4032
+ estimated_output_series:
4033
+ description: Estimated cardinality of the metric based on the queried configuration.
4034
+ example: 50
4035
+ format: int64
4036
+ type: integer
4037
+ type: object
4038
+ MetricEstimateResourceType:
4039
+ default: metric_cardinality_estimate
4040
+ description: The metric estimate resource type.
4041
+ enum:
4042
+ - metric_cardinality_estimate
4043
+ example: metric_cardinality_estimate
4044
+ type: string
4045
+ x-enum-varnames:
4046
+ - METRIC_CARDINALITY_ESTIMATE
4047
+ MetricEstimateResponse:
4048
+ description: Response object that includes metric cardinality estimates.
4049
+ properties:
4050
+ data:
4051
+ $ref: '#/components/schemas/MetricEstimate'
4052
+ type: object
4053
+ MetricEstimateType:
4054
+ default: count_or_gauge
4055
+ description: Estimate type based on the queried configuration. By default, `count_or_gauge`
4056
+ is returned. `distribution` is returned for distribution metrics without percentiles
4057
+ enabled. Lastly, `percentile` is returned if `filter[pct]=true` is queried
4058
+ with a distribution metric.
4059
+ enum:
4060
+ - count_or_gauge
4061
+ - distribution
4062
+ - percentile
4063
+ example: distribution
4064
+ type: string
4065
+ x-enum-varnames:
4066
+ - COUNT_OR_GAUGE
4067
+ - DISTRIBUTION
4068
+ - PERCENTILE
3905
4069
  MetricIngestedIndexedVolume:
3906
4070
  description: Object for a single metric's ingested and indexed volume.
3907
4071
  properties:
@@ -3936,10 +4100,151 @@ components:
3936
4100
  type: string
3937
4101
  x-enum-varnames:
3938
4102
  - METRIC_VOLUMES
4103
+ MetricIntakeType:
4104
+ description: The type of metric.
4105
+ enum:
4106
+ - 0
4107
+ - 1
4108
+ - 2
4109
+ - 3
4110
+ - 15
4111
+ format: int32
4112
+ type: integer
4113
+ x-enum-varnames:
4114
+ - UNSPECIFIED
4115
+ - COUNT
4116
+ - RATE
4117
+ - GAUGE
4118
+ - UNSPECIFIED_LEGACY
4119
+ MetricMetadata:
4120
+ description: Metadata for the metric.
4121
+ properties:
4122
+ origin:
4123
+ $ref: '#/components/schemas/MetricOrigin'
4124
+ type: object
3939
4125
  MetricName:
3940
4126
  description: The metric name for this resource.
3941
4127
  example: test.metric.latency
3942
4128
  type: string
4129
+ MetricOrigin:
4130
+ description: Metric origin information.
4131
+ properties:
4132
+ metric_type:
4133
+ default: 0
4134
+ description: The origin metric type code
4135
+ format: int32
4136
+ maximum: 1000
4137
+ type: integer
4138
+ product:
4139
+ default: 0
4140
+ description: The origin product code
4141
+ format: int32
4142
+ maximum: 1000
4143
+ type: integer
4144
+ service:
4145
+ default: 0
4146
+ description: The origin service code
4147
+ format: int32
4148
+ maximum: 1000
4149
+ type: integer
4150
+ type: object
4151
+ MetricPayload:
4152
+ description: The metrics' payload.
4153
+ properties:
4154
+ series:
4155
+ description: A list of time series to submit to Datadog.
4156
+ example:
4157
+ - metric: system.load.1
4158
+ points:
4159
+ - timestamp: 1475317847
4160
+ value: 0.7
4161
+ items:
4162
+ $ref: '#/components/schemas/MetricSeries'
4163
+ type: array
4164
+ required:
4165
+ - series
4166
+ type: object
4167
+ MetricPoint:
4168
+ description: A point object is of the form `{POSIX_timestamp, numeric_value}`.
4169
+ example:
4170
+ timestamp: 1575317847
4171
+ value: 0.5
4172
+ properties:
4173
+ timestamp:
4174
+ description: 'The timestamp should be in seconds and current.
4175
+
4176
+ Current is defined as not more than 10 minutes in the future or more than
4177
+ 1 hour in the past.'
4178
+ format: int64
4179
+ type: integer
4180
+ value:
4181
+ description: The numeric value format should be a 64bit float gauge-type
4182
+ value.
4183
+ format: double
4184
+ type: number
4185
+ type: object
4186
+ MetricResource:
4187
+ description: Metric resource.
4188
+ properties:
4189
+ name:
4190
+ description: The name of the metric.
4191
+ type: string
4192
+ type:
4193
+ description: The type of metric.
4194
+ type: string
4195
+ type: object
4196
+ MetricSeries:
4197
+ description: 'A metric to submit to Datadog.
4198
+
4199
+ See [Datadog metrics](https://docs.datadoghq.com/developers/metrics/#custom-metrics-properties).'
4200
+ properties:
4201
+ interval:
4202
+ description: If the type of the metric is rate or count, define the corresponding
4203
+ interval.
4204
+ example: 20
4205
+ format: int64
4206
+ type: integer
4207
+ metadata:
4208
+ $ref: '#/components/schemas/MetricMetadata'
4209
+ metric:
4210
+ description: The name of the timeseries.
4211
+ example: system.load.1
4212
+ type: string
4213
+ points:
4214
+ description: Points relating to a metric. All points must be objects with
4215
+ timestamp and a scalar value (cannot be a string). Timestamps should be
4216
+ in POSIX time in seconds, and cannot be more than ten minutes in the future
4217
+ or more than one hour in the past.
4218
+ items:
4219
+ $ref: '#/components/schemas/MetricPoint'
4220
+ type: array
4221
+ resources:
4222
+ description: A list of resources to associate with this metric.
4223
+ items:
4224
+ $ref: '#/components/schemas/MetricResource'
4225
+ type: array
4226
+ source_type_name:
4227
+ description: The source type name.
4228
+ example: datadog
4229
+ type: string
4230
+ tags:
4231
+ description: A list of tags associated with the metric.
4232
+ example:
4233
+ - environment:test
4234
+ items:
4235
+ description: Individual tags.
4236
+ type: string
4237
+ type: array
4238
+ type:
4239
+ $ref: '#/components/schemas/MetricIntakeType'
4240
+ unit:
4241
+ description: The unit of point value.
4242
+ example: second
4243
+ type: string
4244
+ required:
4245
+ - metric
4246
+ - points
4247
+ type: object
3943
4248
  MetricTagConfiguration:
3944
4249
  description: Object for a single metric tag configuration.
3945
4250
  example:
@@ -4538,7 +4843,7 @@ components:
4538
4843
  items:
4539
4844
  $ref: '#/components/schemas/RUMAggregateBucketValueTimeseriesPoint'
4540
4845
  type: array
4541
-
4846
+ x-generate-alias-as-model: true
4542
4847
  RUMAggregateBucketValueTimeseriesPoint:
4543
4848
  description: A timeseries point.
4544
4849
  properties:
@@ -5171,10 +5476,8 @@ components:
5171
5476
  properties:
5172
5477
  id:
5173
5478
  description: The ID of the SAML assertion attribute.
5174
- example: 0
5175
- format: int32
5176
- maximum: 2147483647
5177
- type: integer
5479
+ example: '0'
5480
+ type: string
5178
5481
  type:
5179
5482
  $ref: '#/components/schemas/SAMLAssertionAttributesType'
5180
5483
  required:
@@ -5476,10 +5779,8 @@ components:
5476
5779
  $ref: '#/components/schemas/SAMLAssertionAttributeAttributes'
5477
5780
  id:
5478
5781
  description: The ID of the SAML assertion attribute.
5479
- example: 0
5480
- format: int32
5481
- maximum: 2147483647
5482
- type: integer
5782
+ example: '0'
5783
+ type: string
5483
5784
  type:
5484
5785
  $ref: '#/components/schemas/SAMLAssertionAttributesType'
5485
5786
  required:
@@ -5873,12 +6174,14 @@ components:
5873
6174
  - new_value
5874
6175
  - anomaly_detection
5875
6176
  - impossible_travel
6177
+ - hardcoded
5876
6178
  type: string
5877
6179
  x-enum-varnames:
5878
6180
  - THRESHOLD
5879
6181
  - NEW_VALUE
5880
6182
  - ANOMALY_DETECTION
5881
6183
  - IMPOSSIBLE_TRAVEL
6184
+ - HARDCODED
5882
6185
  SecurityMonitoringRuleEvaluationWindow:
5883
6186
  description: 'A time window is specified to match when at least one of the cases
5884
6187
  matches true. This is a sliding window
@@ -5904,6 +6207,13 @@ components:
5904
6207
  - THIRTY_MINUTES
5905
6208
  - ONE_HOUR
5906
6209
  - TWO_HOURS
6210
+ SecurityMonitoringRuleHardcodedEvaluatorType:
6211
+ description: Hardcoded evaluator type.
6212
+ enum:
6213
+ - log4shell
6214
+ type: string
6215
+ x-enum-varnames:
6216
+ - LOG4SHELL
5907
6217
  SecurityMonitoringRuleImpossibleTravelOptions:
5908
6218
  description: Options on impossible travel rules.
5909
6219
  properties:
@@ -6026,6 +6336,8 @@ components:
6026
6336
  $ref: '#/components/schemas/SecurityMonitoringRuleDetectionMethod'
6027
6337
  evaluationWindow:
6028
6338
  $ref: '#/components/schemas/SecurityMonitoringRuleEvaluationWindow'
6339
+ hardcodedEvaluatorType:
6340
+ $ref: '#/components/schemas/SecurityMonitoringRuleHardcodedEvaluatorType'
6029
6341
  impossibleTravelOptions:
6030
6342
  $ref: '#/components/schemas/SecurityMonitoringRuleImpossibleTravelOptions'
6031
6343
  keepAlive:
@@ -6462,6 +6774,15 @@ components:
6462
6774
  required:
6463
6775
  - data
6464
6776
  type: object
6777
+ UsageApplicationSecurityMonitoringResponse:
6778
+ description: Application Security Monitoring usage response.
6779
+ properties:
6780
+ data:
6781
+ description: Response containing Application Security Monitoring usage.
6782
+ items:
6783
+ $ref: '#/components/schemas/UsageDataObject'
6784
+ type: array
6785
+ type: object
6465
6786
  UsageAttributesObject:
6466
6787
  description: Usage attributes data.
6467
6788
  properties:
@@ -6493,6 +6814,15 @@ components:
6493
6814
  type:
6494
6815
  $ref: '#/components/schemas/UsageTimeSeriesType'
6495
6816
  type: object
6817
+ UsageLambdaTracedInvocationsResponse:
6818
+ description: Lambda Traced Invocations usage response.
6819
+ properties:
6820
+ data:
6821
+ description: Response containing Lambda Traced Invocations usage.
6822
+ items:
6823
+ $ref: '#/components/schemas/UsageDataObject'
6824
+ type: array
6825
+ type: object
6496
6826
  UsageObservabilityPipelinesResponse:
6497
6827
  description: Observability Pipelines usage response.
6498
6828
  properties:
@@ -7333,14 +7663,6 @@ paths:
7333
7663
  required: false
7334
7664
  schema:
7335
7665
  $ref: '#/components/schemas/AuthNMappingsSort'
7336
- - description: Include additional information in the response.
7337
- in: query
7338
- name: include
7339
- required: false
7340
- schema:
7341
- items:
7342
- type: string
7343
- type: array
7344
7666
  - description: Filter all mappings by the given string.
7345
7667
  in: query
7346
7668
  name: filter
@@ -9427,6 +9749,107 @@ paths:
9427
9749
  x-menu-order: 6
9428
9750
  x-undo:
9429
9751
  type: safe
9752
+ /api/v2/metrics/{metric_name}/estimate:
9753
+ get:
9754
+ description: Returns the estimated cardinality for a metric with a given tag,
9755
+ percentile and number of aggregations configuration using Metrics without
9756
+ Limits™.
9757
+ operationId: EstimateMetricsOutputSeries
9758
+ parameters:
9759
+ - $ref: '#/components/parameters/MetricName'
9760
+ - description: Filtered tag keys that the metric is configured to query with.
9761
+ example: app,host
9762
+ in: query
9763
+ name: filter[groups]
9764
+ required: false
9765
+ schema:
9766
+ type: string
9767
+ - description: The number of hours of look back (from now) to estimate cardinality
9768
+ with.
9769
+ example: 49
9770
+ in: query
9771
+ name: filter[hours_ago]
9772
+ required: false
9773
+ schema:
9774
+ type: integer
9775
+ - description: The number of aggregations that a `count`, `rate`, or `gauge`
9776
+ metric is configured to use. Max number of aggregation combos is 9.
9777
+ example: 1
9778
+ in: query
9779
+ name: filter[num_aggregations]
9780
+ required: false
9781
+ schema:
9782
+ type: integer
9783
+ - description: A boolean, for distribution metrics only, to estimate cardinality
9784
+ if the metric includes additional percentile aggregators.
9785
+ example: true
9786
+ in: query
9787
+ name: filter[pct]
9788
+ required: false
9789
+ schema:
9790
+ type: boolean
9791
+ - description: A window, in hours, from the look back to estimate cardinality
9792
+ with.
9793
+ example: 6
9794
+ in: query
9795
+ name: filter[timespan_h]
9796
+ required: false
9797
+ schema:
9798
+ type: integer
9799
+ responses:
9800
+ '200':
9801
+ content:
9802
+ application/json:
9803
+ schema:
9804
+ $ref: '#/components/schemas/MetricEstimateResponse'
9805
+ description: Success
9806
+ '400':
9807
+ content:
9808
+ application/json:
9809
+ schema:
9810
+ $ref: '#/components/schemas/APIErrorResponse'
9811
+ description: API error response.
9812
+ '403':
9813
+ content:
9814
+ application/json:
9815
+ schema:
9816
+ $ref: '#/components/schemas/APIErrorResponse'
9817
+ description: API error response.
9818
+ '404':
9819
+ content:
9820
+ application/json:
9821
+ schema:
9822
+ $ref: '#/components/schemas/APIErrorResponse'
9823
+ description: API error response.
9824
+ '429':
9825
+ content:
9826
+ application/json:
9827
+ schema:
9828
+ $ref: '#/components/schemas/APIErrorResponse'
9829
+ description: Too Many Requests
9830
+ security:
9831
+ - apiKeyAuth: []
9832
+ appKeyAuth: []
9833
+ - AuthZ: []
9834
+ summary: Tag Configuration Cardinality Estimator
9835
+ tags:
9836
+ - Metrics
9837
+ x-dd-ownership:
9838
+ notification_configuration:
9839
+ manual_escalation_policy: '[Points Aggregation] Primary'
9840
+ prod_high_urgency: '@pagerduty-Points-Aggregation @slack-points-aggr-ops'
9841
+ prod_low_urgency: '@slack-points-aggr-ops'
9842
+ slack_support_channel: '#points-aggregation'
9843
+ staging_high_urgency: '@slack-points-aggr-stg-ops'
9844
+ staging_low_urgency: '@slack-points-aggr-stg-ops'
9845
+ team: points-aggregation
9846
+ team_escalation: '[Points Aggregation] Primary'
9847
+ x-menu-order: 10
9848
+ x-permission:
9849
+ operator: OPEN
9850
+ permissions: []
9851
+ x-undo:
9852
+ type: safe
9430
9853
  /api/v2/metrics/{metric_name}/tags:
9431
9854
  delete:
9432
9855
  description: 'Deletes a metric''s tag configuration. Can only be used with application
@@ -11329,6 +11752,80 @@ paths:
11329
11752
  x-unstable: '**Note**: This endpoint is in public beta.
11330
11753
 
11331
11754
  If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
11755
+ /api/v2/series:
11756
+ post:
11757
+ description: "The metrics end-point allows you to post time-series data that
11758
+ can be graphed on Datadog\u2019s dashboards.\nThe maximum payload size is
11759
+ 500 kilobytes (512000 bytes). Compressed payloads must have a decompressed
11760
+ size of less than 5 megabytes (5242880 bytes).\n\nIf you\u2019re submitting
11761
+ metrics directly to the Datadog API without using DogStatsD, expect:\n\n-
11762
+ 64 bits for the timestamp\n- 64 bits for the value\n- 20 bytes for the metric
11763
+ names\n- 50 bytes for the timeseries\n- The full payload is approximately
11764
+ 100 bytes."
11765
+ operationId: SubmitMetrics
11766
+ parameters:
11767
+ - description: HTTP header used to compress the media-type.
11768
+ in: header
11769
+ name: Content-Encoding
11770
+ required: false
11771
+ schema:
11772
+ $ref: '#/components/schemas/MetricContentEncoding'
11773
+ requestBody:
11774
+ content:
11775
+ application/json:
11776
+ examples:
11777
+ dynamic-points:
11778
+ description: "Post time-series data that can be graphed on Datadog\u2019s
11779
+ dashboards."
11780
+ externalValue: examples/metrics/dynamic-points.json.sh
11781
+ summary: Dynamic Points
11782
+ x-variables:
11783
+ NOW: $(date +%s)
11784
+ schema:
11785
+ $ref: '#/components/schemas/MetricPayload'
11786
+ required: true
11787
+ responses:
11788
+ '202':
11789
+ content:
11790
+ application/json:
11791
+ schema:
11792
+ $ref: '#/components/schemas/IntakePayloadAccepted'
11793
+ description: Payload accepted
11794
+ '400':
11795
+ content:
11796
+ application/json:
11797
+ schema:
11798
+ $ref: '#/components/schemas/APIErrorResponse'
11799
+ description: Bad Request
11800
+ '403':
11801
+ content:
11802
+ application/json:
11803
+ schema:
11804
+ $ref: '#/components/schemas/APIErrorResponse'
11805
+ description: Authentication error
11806
+ '408':
11807
+ content:
11808
+ application/json:
11809
+ schema:
11810
+ $ref: '#/components/schemas/APIErrorResponse'
11811
+ description: Request timeout
11812
+ '413':
11813
+ content:
11814
+ application/json:
11815
+ schema:
11816
+ $ref: '#/components/schemas/APIErrorResponse'
11817
+ description: Payload too large
11818
+ '429':
11819
+ $ref: '#/components/responses/TooManyRequestsResponse'
11820
+ security:
11821
+ - apiKeyAuth: []
11822
+ summary: Submit metrics
11823
+ tags:
11824
+ - Metrics
11825
+ x-codegen-request-body-name: body
11826
+ x-menu-order: 1
11827
+ x-undo:
11828
+ type: safe
11332
11829
  /api/v2/service_accounts:
11333
11830
  post:
11334
11831
  description: Create a service account for your organization.
@@ -12001,6 +12498,182 @@ paths:
12001
12498
  x-unstable: '**Note**: This endpoint is in public beta.
12002
12499
 
12003
12500
  If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
12501
+ /api/v2/usage/application_security:
12502
+ get:
12503
+ description: Get hourly usage for Application Security .
12504
+ operationId: GetUsageApplicationSecurityMonitoring
12505
+ parameters:
12506
+ - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
12507
+ for usage beginning at this hour.'
12508
+ in: query
12509
+ name: start_hr
12510
+ required: true
12511
+ schema:
12512
+ format: date-time
12513
+ type: string
12514
+ - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
12515
+ for usage ending
12516
+
12517
+ **before** this hour.'
12518
+ in: query
12519
+ name: end_hr
12520
+ required: false
12521
+ schema:
12522
+ format: date-time
12523
+ type: string
12524
+ responses:
12525
+ '200':
12526
+ content:
12527
+ application/json;datetime-format=rfc3339:
12528
+ schema:
12529
+ $ref: '#/components/schemas/UsageApplicationSecurityMonitoringResponse'
12530
+ description: OK
12531
+ '400':
12532
+ content:
12533
+ application/json;datetime-format=rfc3339:
12534
+ schema:
12535
+ $ref: '#/components/schemas/APIErrorResponse'
12536
+ description: Bad Request
12537
+ '403':
12538
+ content:
12539
+ application/json;datetime-format=rfc3339:
12540
+ schema:
12541
+ $ref: '#/components/schemas/APIErrorResponse'
12542
+ description: Forbidden - User is not authorized
12543
+ '429':
12544
+ content:
12545
+ application/json;datetime-format=rfc3339:
12546
+ schema:
12547
+ $ref: '#/components/schemas/APIErrorResponse'
12548
+ description: Too many requests
12549
+ security:
12550
+ - apiKeyAuth: []
12551
+ appKeyAuth: []
12552
+ - AuthZ:
12553
+ - usage_read
12554
+ summary: Get hourly usage for Application Security
12555
+ tags:
12556
+ - Usage Metering
12557
+ x-menu-order: 38
12558
+ x-undo:
12559
+ type: safe
12560
+ /api/v2/usage/cost_by_org:
12561
+ get:
12562
+ description: Get cost across multi-org account. Cost by org data for a given
12563
+ month becomes available no later than the 16th of the following month.
12564
+ operationId: GetCostByOrg
12565
+ parameters:
12566
+ - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]`
12567
+ for cost beginning this month.'
12568
+ in: query
12569
+ name: start_month
12570
+ required: true
12571
+ schema:
12572
+ format: date-time
12573
+ type: string
12574
+ - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]`
12575
+ for cost ending this month.'
12576
+ in: query
12577
+ name: end_month
12578
+ required: false
12579
+ schema:
12580
+ format: date-time
12581
+ type: string
12582
+ responses:
12583
+ '200':
12584
+ content:
12585
+ application/json;datetime-format=rfc3339:
12586
+ schema:
12587
+ $ref: '#/components/schemas/CostByOrgResponse'
12588
+ description: OK
12589
+ '400':
12590
+ content:
12591
+ application/json;datetime-format=rfc3339:
12592
+ schema:
12593
+ $ref: '#/components/schemas/APIErrorResponse'
12594
+ description: Bad Request
12595
+ '403':
12596
+ content:
12597
+ application/json;datetime-format=rfc3339:
12598
+ schema:
12599
+ $ref: '#/components/schemas/APIErrorResponse'
12600
+ description: Forbidden - User is not authorized
12601
+ '429':
12602
+ content:
12603
+ application/json;datetime-format=rfc3339:
12604
+ schema:
12605
+ $ref: '#/components/schemas/APIErrorResponse'
12606
+ description: Too many requests
12607
+ security:
12608
+ - apiKeyAuth: []
12609
+ appKeyAuth: []
12610
+ - AuthZ:
12611
+ - usage_read
12612
+ summary: Get cost across multi-org account
12613
+ tags:
12614
+ - Usage Metering
12615
+ x-menu-order: 39
12616
+ x-undo:
12617
+ type: safe
12618
+ /api/v2/usage/lambda_traced_invocations:
12619
+ get:
12620
+ description: Get hourly usage for Lambda Traced Invocations.
12621
+ operationId: GetUsageLambdaTracedInvocations
12622
+ parameters:
12623
+ - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
12624
+ for usage beginning at this hour.'
12625
+ in: query
12626
+ name: start_hr
12627
+ required: true
12628
+ schema:
12629
+ format: date-time
12630
+ type: string
12631
+ - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
12632
+ for usage ending
12633
+
12634
+ **before** this hour.'
12635
+ in: query
12636
+ name: end_hr
12637
+ required: false
12638
+ schema:
12639
+ format: date-time
12640
+ type: string
12641
+ responses:
12642
+ '200':
12643
+ content:
12644
+ application/json;datetime-format=rfc3339:
12645
+ schema:
12646
+ $ref: '#/components/schemas/UsageLambdaTracedInvocationsResponse'
12647
+ description: OK
12648
+ '400':
12649
+ content:
12650
+ application/json;datetime-format=rfc3339:
12651
+ schema:
12652
+ $ref: '#/components/schemas/APIErrorResponse'
12653
+ description: Bad Request
12654
+ '403':
12655
+ content:
12656
+ application/json;datetime-format=rfc3339:
12657
+ schema:
12658
+ $ref: '#/components/schemas/APIErrorResponse'
12659
+ description: Forbidden - User is not authorized
12660
+ '429':
12661
+ content:
12662
+ application/json;datetime-format=rfc3339:
12663
+ schema:
12664
+ $ref: '#/components/schemas/APIErrorResponse'
12665
+ description: Too many requests
12666
+ security:
12667
+ - apiKeyAuth: []
12668
+ appKeyAuth: []
12669
+ - AuthZ:
12670
+ - usage_read
12671
+ summary: Get hourly usage for Lambda Traced Invocations
12672
+ tags:
12673
+ - Usage Metering
12674
+ x-menu-order: 38
12675
+ x-undo:
12676
+ type: safe
12004
12677
  /api/v2/usage/observability_pipelines:
12005
12678
  get:
12006
12679
  description: Get hourly usage for Observability Pipelines.