Regenerate client from commit caa6557 of spec repo

Author: ci.datadog-api-spec

content/en/api/v1/service-level-objectives/examples.json

@@ -0,0 +1,43 @@
+{
+  "type": "metric",
+  "description": "Metric SLO using sli_specification",
+  "name": "Example-Service-Level-Objective",
+  "sli_specification": {
+    "count": {
+      "good_events_formula": {
+        "formula": "query1 - query2"
+      },
+      "total_events_formula": {
+        "formula": "query1"
+      },
+      "queries": [
+        {
+          "data_source": "metrics",
+          "name": "query1",
+          "query": "sum:httpservice.hits{*}.as_count()"
+        },
+        {
+          "data_source": "metrics",
+          "name": "query2",
+          "query": "sum:httpservice.errors{*}.as_count()"
+        }
+      ]
+    }
+  },
+  "tags": [
+    "env:prod",
+    "type:count"
+  ],
+  "thresholds": [
+    {
+      "target": 99.0,
+      "target_display": "99.0",
+      "timeframe": "7d",
+      "warning": 99.5,
+      "warning_display": "99.5"
+    }
+  ],
+  "timeframe": "7d",
+  "target_threshold": 99.0,
+  "warning_threshold": 99.5
+}

content/en/api/v1/service-level-objectives/request.CreateSLO_512760759.json

@@ -853,6 +853,11 @@
     }
   ],
   "CreateSLO": [
+    {
+      "group": "service_level_objectives",
+      "suffix": "_512760759",
+      "description": "Create a new metric SLO object using sli_specification returns \"OK\" response"
+    },
     {
       "group": "service_level_objectives",
       "suffix": "_3765703239",

data/api/v1/CodeExamples.json

@@ -11641,6 +11641,61 @@ components:
           example: UTC
           type: string
       type: object
+    SLOCountDefinition:
+      description: 'A count-based (metric) SLI specification, composed of three parts:
+        the good events formula, the total events formula,
+
+        and the underlying queries. Usage is not permitted when request payload contains
+        `query` field.'
+      example:
+        good_events_formula: query1 - query2
+        queries:
+        - data_source: metrics
+          name: query1
+          query: sum:trace.servlet.request.hits{*} by {env}.as_count()
+        - data_source: metrics
+          name: query2
+          query: sum:trace.servlet.request.errors{*} by {env}.as_count()
+        total_events_formula: query1
+      properties:
+        good_events_formula:
+          $ref: '#/components/schemas/SLOFormula'
+        queries:
+          example:
+          - data_source: metrics
+            name: query1
+            query: sum:trace.servlet.request.hits{*} by {env}.as_count()
+          items:
+            $ref: '#/components/schemas/SLODataSourceQueryDefinition'
+          minItems: 1
+          type: array
+        total_events_formula:
+          $ref: '#/components/schemas/SLOFormula'
+      required:
+      - good_events_formula
+      - total_events_formula
+      - queries
+      type: object
+    SLOCountSpec:
+      additionalProperties: false
+      description: A metric SLI specification.
+      example:
+        count:
+          good_events_formula: query1 - query2
+          queries:
+          - data_source: metrics
+            name: query1
+            query: sum:trace.servlet.request.hits{*} by {env}.as_count()
+          - data_source: metrics
+            name: query2
+            query: sum:trace.servlet.request.errors{*} by {env}.as_count()
+          total_events_formula: query1
+      properties:
+        count:
+          $ref: '#/components/schemas/SLOCountDefinition'
+      required:
+      - count
+      type: object
     SLOCreator:
       description: The creator of the SLO
       nullable: true
@@ -12488,8 +12543,16 @@ components:
           type: string
         query:
           $ref: '#/components/schemas/ServiceLevelObjectiveQuery'
+          description: 'The metric query of good / total events. This is not allowed
+            if the `sli_specification` field
+
+            is used in the same request.'
         sli_specification:
           $ref: '#/components/schemas/SLOSliSpec'
+          description: 'A generic SLI specification. This is currently used for time-slice
+            and count-based (metric) SLOs only.
+
+            This is not allowed if the `query` field is used in the same request.'
         tags:
           description: 'A list of tags associated with this service level objective.
 
@@ -12546,9 +12609,10 @@ components:
       type: object
     SLOSliSpec:
       description: A generic SLI specification. This is currently used for time-slice
-        SLOs only.
+        and count-based (metric) SLOs only.
       oneOf:
       - $ref: '#/components/schemas/SLOTimeSliceSpec'
+      - $ref: '#/components/schemas/SLOCountSpec'
     SLOState:
       description: State of the SLO.
       enum:
@@ -13731,13 +13795,15 @@ components:
       - type
       type: object
     ServiceLevelObjectiveQuery:
-      description: 'A metric-based SLO. **Required if type is `metric`**. Note that
+      description: 'A count-based (metric) SLO query. This field has been superseded
+        by `sli_specification` but is retained for backwards compatibility. Note that
         Datadog only allows the sum by aggregator
 
         to be used because this will sum up all request counts instead of averaging
         them, or taking the max or
 
-        min of all of those requests.'
+        min of all of those requests. Usage is not permitted when request payload
+        contains `sli_specification` field.'
       properties:
         denominator:
           description: A Datadog metric query for total (valid) events.