RubyGems - datadog_api_client - Versions diffs - 2.5.0 → 2.6.0 - Mend

datadog_api_client 2.5.0 → 2.6.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 (1124) hide show

data/.generator/schemas/v2/openapi.yaml CHANGED Viewed

@@ -197,6 +197,44 @@ components:
         items:
           $ref: '#/components/schemas/IncidentRelatedObject'
         type: array
+    IncidentSearchIncludeQueryParameter:
+      description: Specifies which types of related objects should be included in
+        the response.
+      in: query
+      name: include
+      required: false
+      schema:
+        $ref: '#/components/schemas/IncidentRelatedObject'
+    IncidentSearchQueryQueryParameter:
+      description: 'Specifies which incidents should be returned. After entering a
+        search query in your [Incidents page][1],
+        use the query parameter value in the URL of the page as the value for this
+        parameter.
+        The query can contain any number of incident facets joined by `ANDs`, along
+        with multiple values for each of
+        those facets joined by `OR`s, for instance: `query="state:active AND severity:(SEV-2
+        OR SEV-1)"`.
+        [1]: https://app.datadoghq.com/incidents'
+      explode: false
+      in: query
+      name: query
+      required: true
+      schema:
+        type: string
+    IncidentSearchSortQueryParameter:
+      description: Specifies the order of returned incidents.
+      explode: false
+      in: query
+      name: sort
+      required: false
+      schema:
+        $ref: '#/components/schemas/IncidentSearchSortOrder'
     IncidentServiceIDPathParameter:
       description: The ID of the incident service.
       in: path
@@ -1385,7 +1423,7 @@ components:
         links:
           $ref: '#/components/schemas/CIAppResponseLinks'
         meta:
-          $ref: '#/components/schemas/CIAppResponseMetadata'
+          $ref: '#/components/schemas/CIAppResponseMetadataWithPagination'
       type: object
     CIAppPipelinesAggregateRequest:
       description: The object sent with the request to retrieve aggregation buckets
@@ -1406,8 +1444,6 @@ components:
           type: array
         options:
           $ref: '#/components/schemas/CIAppQueryOptions'
-        page:
-          $ref: '#/components/schemas/CIAppQueryPageOptions'
       type: object
     CIAppPipelinesAggregationBucketsResponse:
       description: The query results.
@@ -1434,7 +1470,6 @@ components:
         by:
           additionalProperties:
             description: The values for each group-by.
-            type: string
           description: The key-value pairs for each group-by.
           example:
             '@ci.provider.name': gitlab
@@ -1531,6 +1566,29 @@ components:
           type: string
       type: object
     CIAppResponseMetadata:
+      description: The metadata associated with a request.
+      properties:
+        elapsed:
+          description: The time elapsed in milliseconds.
+          example: 132
+          format: int64
+          type: integer
+        request_id:
+          description: The identifier of the request.
+          example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR
+          type: string
+        status:
+          $ref: '#/components/schemas/CIAppResponseStatus'
+        warnings:
+          description: 'A list of warnings (non-fatal errors) encountered. Partial
+            results may return if
+            warnings are present in the response.'
+          items:
+            $ref: '#/components/schemas/CIAppWarning'
+          type: array
+      type: object
+    CIAppResponseMetadataWithPagination:
       description: The metadata associated with a request.
       properties:
         elapsed:
@@ -1638,7 +1696,7 @@ components:
         links:
           $ref: '#/components/schemas/CIAppResponseLinks'
         meta:
-          $ref: '#/components/schemas/CIAppResponseMetadata'
+          $ref: '#/components/schemas/CIAppResponseMetadataWithPagination'
       type: object
     CIAppTestsAggregateRequest:
       description: The object sent with the request to retrieve aggregation buckets
@@ -1659,8 +1717,6 @@ components:
           type: array
         options:
           $ref: '#/components/schemas/CIAppQueryOptions'
-        page:
-          $ref: '#/components/schemas/CIAppQueryPageOptions'
       type: object
     CIAppTestsAggregationBucketsResponse:
       description: The query results.
@@ -1687,7 +1743,6 @@ components:
         by:
           additionalProperties:
             description: The values for each group-by.
-            type: string
           description: The key-value pairs for each group-by.
           example:
             '@test.service': web-ui-tests
@@ -1776,7 +1831,12 @@ components:
           type: string
       type: object
     CloudConfigurationComplianceRuleOptions:
-      description: Options for cloud_configuration rules.
+      description: 'Options for cloud_configuration rules.
+        Fields `resourceType` and `regoRule` are mandatory when managing custom `cloud_configuration`
+        rules.
+        '
       properties:
         complexRule:
           description: 'Whether the rule is a complex one.
@@ -1795,9 +1855,6 @@ components:
             '
           example: aws_acm
           type: string
-      required:
-      - resourceType
-      - regoRule
       type: object
     CloudConfigurationRegoRule:
       description: Rule details.
@@ -2823,6 +2880,95 @@ components:
       type: string
       x-enum-varnames:
       - EVENT
+    EventsAggregation:
+      default: count
+      description: The type of aggregation that can be performed on events-based queries.
+      enum:
+      - count
+      - cardinality
+      - pc75
+      - pc90
+      - pc95
+      - pc98
+      - pc99
+      - sum
+      - min
+      - max
+      - avg
+      example: count
+      type: string
+      x-enum-varnames:
+      - COUNT
+      - CARDINALITY
+      - PC75
+      - PC90
+      - PC95
+      - PC98
+      - PC99
+      - SUM
+      - MIN
+      - MAX
+      - AVG
+    EventsCompute:
+      description: The instructions for what to compute for this query.
+      properties:
+        aggregation:
+          $ref: '#/components/schemas/EventsAggregation'
+        interval:
+          description: Interval for compute in milliseconds.
+          example: 60000
+          format: int64
+          type: integer
+        metric:
+          description: The "measure" attribute on which to perform the computation.
+          type: string
+      required:
+      - aggregation
+      type: object
+    EventsDataSource:
+      default: logs
+      description: A data source that is powered by the Events Platform.
+      enum:
+      - logs
+      example: logs
+      type: string
+      x-enum-varnames:
+      - LOGS
+    EventsGroupBy:
+      description: A dimension on which to split a query's results.
+      properties:
+        facet:
+          description: The facet by which to split groups.
+          example: '@error.type'
+          type: string
+        limit:
+          description: The maximum number of groups to return.
+          example: 10
+          format: int32
+          maximum: 2147483647
+          type: integer
+        sort:
+          $ref: '#/components/schemas/EventsGroupBySort'
+      required:
+      - facet
+      type: object
+    EventsGroupBySort:
+      description: The dimension by which to sort a query's results.
+      properties:
+        aggregation:
+          $ref: '#/components/schemas/EventsAggregation'
+        metric:
+          description: Metric whose calculated value should be used to define the
+            sort order of a query's results.
+          example: '@duration'
+          type: string
+        order:
+          $ref: '#/components/schemas/QuerySortOrder'
+        type:
+          $ref: '#/components/schemas/EventsSortType'
+      required:
+      - aggregation
+      type: object
     EventsListRequest:
       description: The object sent with the request to retrieve a list of events from
         your organization.
@@ -2882,6 +3028,11 @@ components:
           example: now
           type: string
       type: object
+    EventsQueryGroupBys:
+      description: The list of facets on which to split results.
+      items:
+        $ref: '#/components/schemas/EventsGroupBy'
+      type: array
     EventsQueryOptions:
       description: 'The global query options that are used. Either provide a timezone
         or a time offset but not both,
@@ -2948,6 +3099,39 @@ components:
           example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==
           type: string
       type: object
+    EventsScalarQuery:
+      description: An individual scalar events query.
+      properties:
+        compute:
+          $ref: '#/components/schemas/EventsCompute'
+        data_source:
+          $ref: '#/components/schemas/EventsDataSource'
+        group_by:
+          $ref: '#/components/schemas/EventsQueryGroupBys'
+        indexes:
+          description: The indexes in which to search.
+          items:
+            description: The unique index name.
+            example: main
+            type: string
+          type: array
+        name:
+          description: The variable name for use in formulas.
+          type: string
+        search:
+          $ref: '#/components/schemas/EventsSearch'
+      required:
+      - data_source
+      - compute
+      type: object
+    EventsSearch:
+      description: Configuration of the search/filter for an events query.
+      properties:
+        query:
+          description: The search/filter string for an events query.
+          example: status:warn service:foo
+          type: string
+      type: object
     EventsSort:
       description: The sort parameters when querying events.
       enum:
@@ -2957,6 +3141,40 @@ components:
       x-enum-varnames:
       - TIMESTAMP_ASCENDING
       - TIMESTAMP_DESCENDING
+    EventsSortType:
+      description: The type of sort to use on the calculated value.
+      enum:
+      - alphabetical
+      - measure
+      type: string
+      x-enum-varnames:
+      - ALPHABETICAL
+      - MEASURE
+    EventsTimeseriesQuery:
+      description: An individual timeseries events query.
+      properties:
+        compute:
+          $ref: '#/components/schemas/EventsCompute'
+        data_source:
+          $ref: '#/components/schemas/EventsDataSource'
+        group_by:
+          $ref: '#/components/schemas/EventsQueryGroupBys'
+        indexes:
+          description: The indexes in which to search.
+          items:
+            description: The unique index name.
+            example: main
+            type: string
+          type: array
+        name:
+          description: The variable name for use in formulas.
+          type: string
+        search:
+          $ref: '#/components/schemas/EventsSearch'
+      required:
+      - data_source
+      - compute
+      type: object
     EventsWarning:
       description: A warning message indicating something is wrong with the query.
       properties:
@@ -2974,6 +3192,19 @@ components:
             from the other indexes.
           type: string
       type: object
+    FormulaLimit:
+      description: Message for specifying limits to the number of values returned
+        by a query.
+      properties:
+        count:
+          description: The number of results to which to limit.
+          example: 10
+          format: int32
+          maximum: 2147483647
+          type: integer
+        order:
+          $ref: '#/components/schemas/QuerySortOrder'
+      type: object
     FullAPIKey:
       description: Datadog API key.
       properties:
@@ -3066,6 +3297,12 @@ components:
           nullable: true
           type: array
       type: object
+    GroupTags:
+      description: List of tags that apply to a single response value.
+      items:
+        description: A single tag that applies to a single response value.
+        type: string
+      type: array
     HTTPLog:
       description: Structured log message.
       items:
@@ -3830,6 +4067,220 @@ components:
         last_modified_by_user:
           $ref: '#/components/schemas/RelationshipToUser'
       type: object
+    IncidentSearchResponse:
+      description: Response with incidents and facets.
+      properties:
+        data:
+          $ref: '#/components/schemas/IncidentSearchResponseData'
+        included:
+          description: Included related resources that the user requested.
+          items:
+            $ref: '#/components/schemas/IncidentResponseIncludedItem'
+          readOnly: true
+          type: array
+      required:
+      - data
+      type: object
+    IncidentSearchResponseAttributes:
+      description: Attributes returned by an incident search.
+      properties:
+        facets:
+          $ref: '#/components/schemas/IncidentSearchResponseFacetsData'
+        incidents:
+          description: Incidents returned by the search.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponseIncidentsData'
+          type: array
+        total:
+          description: Number of incidents returned by the search.
+          example: 10
+          format: int32
+          maximum: 2147483647
+          type: integer
+      required:
+      - facets
+      - incidents
+      - total
+      type: object
+    IncidentSearchResponseData:
+      description: Data returned by an incident search.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/IncidentSearchResponseAttributes'
+        type:
+          $ref: '#/components/schemas/IncidentSearchResultsType'
+      type: object
+    IncidentSearchResponseFacetCount:
+      description: Count of the facet value appearing in search results.
+      example: 5
+      format: int32
+      maximum: 2147483647
+      type: integer
+    IncidentSearchResponseFacetsData:
+      description: Facet data for incidents returned by a search query.
+      properties:
+        commander:
+          description: Facet data for incident commander users.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponseUserFacetData'
+          type: array
+        created_by:
+          description: Facet data for incident creator users.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponseUserFacetData'
+          type: array
+        fields:
+          description: Facet data for incident property fields.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponsePropertyFieldFacetData'
+          type: array
+        impact:
+          description: Facet data for incident impact attributes.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData'
+          type: array
+        last_modified_by:
+          description: Facet data for incident last modified by users.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponseUserFacetData'
+          type: array
+        postmortem:
+          description: Facet data for incident postmortem existence.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData'
+          type: array
+        responder:
+          description: Facet data for incident responder users.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponseUserFacetData'
+          type: array
+        severity:
+          description: Facet data for incident severity attributes.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData'
+          type: array
+        state:
+          description: Facet data for incident state attributes.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData'
+          type: array
+        time_to_repair:
+          description: Facet data for incident time to repair metrics.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponseNumericFacetData'
+          type: array
+        time_to_resolve:
+          description: Facet data for incident time to resolve metrics.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponseNumericFacetData'
+          type: array
+      type: object
+    IncidentSearchResponseFieldFacetData:
+      description: Facet value and number of occurrences for a property field of an
+        incident.
+      properties:
+        count:
+          $ref: '#/components/schemas/IncidentSearchResponseFacetCount'
+        name:
+          description: The facet value appearing in search results.
+          example: SEV-2
+          type: string
+      type: object
+    IncidentSearchResponseIncidentsData:
+      description: Incident returned by the search.
+      properties:
+        data:
+          $ref: '#/components/schemas/IncidentResponseData'
+      required:
+      - data
+      type: object
+    IncidentSearchResponseNumericFacetData:
+      description: Facet data numeric attributes of an incident.
+      properties:
+        aggregates:
+          $ref: '#/components/schemas/IncidentSearchResponseNumericFacetDataAggregates'
+        name:
+          description: Name of the incident property field.
+          example: time_to_repair
+          type: string
+      required:
+      - name
+      - aggregates
+      type: object
+    IncidentSearchResponseNumericFacetDataAggregates:
+      description: Aggregate information for numeric incident data.
+      properties:
+        max:
+          description: Maximum value of the numeric aggregates.
+          example: 1234.0
+          format: double
+          nullable: true
+          type: number
+        min:
+          description: Minimum value of the numeric aggregates.
+          example: 20.0
+          format: double
+          nullable: true
+          type: number
+      type: object
+    IncidentSearchResponsePropertyFieldFacetData:
+      description: Facet data for the incident property fields.
+      properties:
+        aggregates:
+          $ref: '#/components/schemas/IncidentSearchResponseNumericFacetDataAggregates'
+        facets:
+          description: Facet data for the property field of an incident.
+          items:
+            $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData'
+          type: array
+        name:
+          description: Name of the incident property field.
+          example: Severity
+          type: string
+      required:
+      - facets
+      - name
+      type: object
+    IncidentSearchResponseUserFacetData:
+      description: Facet data for user attributes of an incident.
+      properties:
+        count:
+          $ref: '#/components/schemas/IncidentSearchResponseFacetCount'
+        email:
+          description: Email of the user.
+          example: datadog.user@example.com
+          type: string
+        handle:
+          description: Handle of the user.
+          example: '@datadog.user@example.com'
+          type: string
+        name:
+          description: Name of the user.
+          example: Datadog User
+          type: string
+        uuid:
+          description: ID of the user.
+          example: 773b045d-ccf8-4808-bd3b-955ef6a8c940
+          type: string
+      type: object
+    IncidentSearchResultsType:
+      default: incidents_search_results
+      description: Incident search result type.
+      enum:
+      - incidents_search_results
+      example: incidents_search_results
+      type: string
+      x-enum-varnames:
+      - INCIDENTS_SEARCH_RESULTS
+    IncidentSearchSortOrder:
+      description: The ways searched incidents can be sorted.
+      enum:
+      - created
+      - -created
+      type: string
+      x-enum-varnames:
+      - CREATED_ASCENDING
+      - CREATED_DESCENDING
     IncidentServiceCreateAttributes:
       description: The incident service's attributes for a create request.
       properties:
@@ -4490,7 +4941,6 @@ components:
         by:
           additionalProperties:
             description: The values for each group by
-            type: string
           description: The key, value pairs for each group by
           example:
             '@state': success
@@ -6351,6 +6801,23 @@ components:
           $ref: '#/components/schemas/MetricVolumes'
       readOnly: true
       type: object
+    MetricsAggregator:
+      default: avg
+      description: The type of aggregation that can be performed on metrics queries.
+      enum:
+      - avg
+      - min
+      - max
+      - sum
+      - last
+      example: avg
+      type: string
+      x-enum-varnames:
+      - AVG
+      - MIN
+      - MAX
+      - SUM
+      - LAST
     MetricsAndMetricTagConfigurations:
       description: Object for a metrics and metric tag configurations.
       oneOf:
@@ -6367,6 +6834,50 @@ components:
           type: array
       readOnly: true
       type: object
+    MetricsDataSource:
+      default: metrics
+      description: A data source that is powered by the Metrics backend.
+      enum:
+      - metrics
+      example: metrics
+      type: string
+      x-enum-varnames:
+      - METRICS
+    MetricsScalarQuery:
+      description: An individual scalar metrics query.
+      properties:
+        aggregator:
+          $ref: '#/components/schemas/MetricsAggregator'
+        data_source:
+          $ref: '#/components/schemas/MetricsDataSource'
+        name:
+          description: The variable name for use in formulas.
+          type: string
+        query:
+          description: A classic metrics query string.
+          example: avg:system.cpu.user{*}
+          type: string
+      required:
+      - data_source
+      - query
+      - aggregator
+      type: object
+    MetricsTimeseriesQuery:
+      description: An individual timeseries metrics query.
+      properties:
+        data_source:
+          $ref: '#/components/schemas/MetricsDataSource'
+        name:
+          description: The variable name for use in formulas.
+          type: string
+        query:
+          description: A classic metrics query string.
+          example: avg:system.cpu.user{*}
+          type: string
+      required:
+      - data_source
+      - query
+      type: object
     MonitorType:
       description: Attributes from the monitor that triggered the event.
       nullable: true
@@ -6913,6 +7424,19 @@ components:
       type: string
       x-enum-varnames:
       - PROCESS
+    QueryFormula:
+      description: A formula for calculation based on one or more queries.
+      properties:
+        formula:
+          description: Formula string, referencing one or more queries with their
+            name property.
+          example: a+b
+          type: string
+        limit:
+          $ref: '#/components/schemas/FormulaLimit'
+      required:
+      - formula
+      type: object
     QuerySortOrder:
       default: desc
       description: Direction of sort.
@@ -8205,6 +8729,134 @@ components:
       type: string
       x-enum-varnames:
       - SAML_ASSERTION_ATTRIBUTES
+    ScalarColumn:
+      description: A single column in a scalar query response.
+      properties:
+        unit:
+          description: List of units.
+          items:
+            $ref: '#/components/schemas/Unit'
+          type: array
+        values:
+          description: Array of values for each group-by combination that results
+            from one formula or query.
+          items:
+            description: An individual value for a given column and group-by.
+            format: double
+            type: number
+          type: array
+      type: object
+    ScalarFormulaQueryRequest:
+      description: A wrapper request around one scalar query to be executed.
+      properties:
+        data:
+          $ref: '#/components/schemas/ScalarFormulaRequest'
+      required:
+      - data
+      type: object
+    ScalarFormulaQueryResponse:
+      description: A message containing one or more responses to scalar queries.
+      properties:
+        data:
+          $ref: '#/components/schemas/ScalarResponse'
+        errors:
+          description: An error generated when processing a request.
+          type: string
+      type: object
+    ScalarFormulaRequest:
+      description: A single scalar query to be executed.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/ScalarFormulaRequestAttributes'
+        type:
+          $ref: '#/components/schemas/ScalarFormulaRequestType'
+      required:
+      - type
+      - attributes
+      type: object
+    ScalarFormulaRequestAttributes:
+      description: The object describing a scalar formula request.
+      properties:
+        formulas:
+          description: List of formulas to be calculated and returned as responses.
+          items:
+            $ref: '#/components/schemas/QueryFormula'
+          type: array
+        from:
+          description: Start date (inclusive) of the query in milliseconds since the
+            Unix epoch.
+          example: 1568899800000
+          format: int64
+          type: integer
+        queries:
+          $ref: '#/components/schemas/ScalarFormulaRequestQueries'
+        to:
+          description: End date (exclusive) of the query in milliseconds since the
+            Unix epoch.
+          example: 1568923200000
+          format: int64
+          type: integer
+      required:
+      - to
+      - from
+      - queries
+      type: object
+    ScalarFormulaRequestQueries:
+      description: List of queries to be run and used as inputs to the formulas.
+      items:
+        $ref: '#/components/schemas/ScalarQuery'
+      type: array
+    ScalarFormulaRequestType:
+      default: scalar_request
+      description: The type of the resource. The value should always be scalar_request.
+      enum:
+      - scalar_request
+      example: scalar_request
+      type: string
+      x-enum-varnames:
+      - SCALAR_REQUEST
+    ScalarFormulaResponseAtrributes:
+      description: The object describing a scalar response.
+      properties:
+        columns:
+          description: List of response columns, each corresponding to an individual
+            formula or query in the request and with values in parallel arrays matching
+            the series list.
+          items:
+            $ref: '#/components/schemas/ScalarColumn'
+          type: array
+        series:
+          $ref: '#/components/schemas/ScalarResponseSeriesList'
+      type: object
+    ScalarFormulaResponseType:
+      default: scalar_response
+      description: The type of the resource. The value should always be scalar_response.
+      enum:
+      - scalar_response
+      example: scalar_response
+      type: string
+      x-enum-varnames:
+      - SCALAR_RESPONSE
+    ScalarQuery:
+      description: An individual scalar query to one of the basic Datadog data sources.
+      oneOf:
+      - $ref: '#/components/schemas/MetricsScalarQuery'
+      - $ref: '#/components/schemas/EventsScalarQuery'
+      type: object
+    ScalarResponse:
+      description: A message containing the response to a scalar query.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/ScalarFormulaResponseAtrributes'
+        type:
+          $ref: '#/components/schemas/ScalarFormulaResponseType'
+      type: object
+    ScalarResponseSeriesList:
+      description: List of group-by tags for the response. Parallel array to the values
+        in each scalar column.
+      items:
+        $ref: '#/components/schemas/GroupTags'
+      type: array
     SecurityFilter:
       description: The security filter's properties.
       properties:
@@ -10672,11 +11324,200 @@ components:
         description: Tag associated with your event.
         type: string
       type: array
+    TimeseriesFormulaQueryRequest:
+      description: A request wrapper around a single timeseries query to be executed.
+      properties:
+        data:
+          $ref: '#/components/schemas/TimeseriesFormulaRequest'
+      required:
+      - data
+      type: object
+    TimeseriesFormulaQueryResponse:
+      description: A message containing one response to a timeseries query made with
+        timeseries formula query request.
+      properties:
+        data:
+          $ref: '#/components/schemas/TimeseriesResponse'
+        errors:
+          description: The error generated by the request.
+          type: string
+      type: object
+    TimeseriesFormulaRequest:
+      description: A single timeseries query to be executed.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/TimeseriesFormulaRequestAttributes'
+        type:
+          $ref: '#/components/schemas/TimeseriesFormulaRequestType'
+      required:
+      - type
+      - attributes
+      type: object
+    TimeseriesFormulaRequestAttributes:
+      description: The object describing a timeseries formula request.
+      properties:
+        formulas:
+          description: List of formulas to be calculated and returned as responses.
+          items:
+            $ref: '#/components/schemas/QueryFormula'
+          type: array
+        from:
+          description: Start date (inclusive) of the query in milliseconds since the
+            Unix epoch.
+          example: 1568899800000
+          format: int64
+          type: integer
+        interval:
+          description: 'A time interval in milliseconds.
+            May be overridden by a larger interval if the query would result in
+            too many points for the specified timeframe.
+            Defaults to a reasonable interval for the given timeframe.'
+          example: 5000
+          format: int64
+          type: integer
+        queries:
+          $ref: '#/components/schemas/TimeseriesFormulaRequestQueries'
+        to:
+          description: End date (exclusive) of the query in milliseconds since the
+            Unix epoch.
+          example: 1568923200000
+          format: int64
+          type: integer
+      required:
+      - to
+      - from
+      - queries
+      type: object
+    TimeseriesFormulaRequestQueries:
+      description: List of queries to be run and used as inputs to the formulas.
+      items:
+        $ref: '#/components/schemas/TimeseriesQuery'
+      type: array
+    TimeseriesFormulaRequestType:
+      default: timeseries_request
+      description: The type of the resource. The value should always be timeseries_request.
+      enum:
+      - timeseries_request
+      example: timeseries_request
+      type: string
+      x-enum-varnames:
+      - TIMESERIES_REQUEST
+    TimeseriesFormulaResponseType:
+      default: timeseries_response
+      description: The type of the resource. The value should always be timeseries_response.
+      enum:
+      - timeseries_response
+      example: timeseries_response
+      type: string
+      x-enum-varnames:
+      - TIMESERIES_RESPONSE
+    TimeseriesQuery:
+      description: An individual timeseries query to one of the basic Datadog data
+        sources.
+      oneOf:
+      - $ref: '#/components/schemas/MetricsTimeseriesQuery'
+      - $ref: '#/components/schemas/EventsTimeseriesQuery'
+      type: object
+    TimeseriesResponse:
+      description: A message containing the response to a timeseries query.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/TimeseriesResponseAttributes'
+        type:
+          $ref: '#/components/schemas/TimeseriesFormulaResponseType'
+      type: object
+    TimeseriesResponseAttributes:
+      description: The object describing a timeseries response.
+      properties:
+        series:
+          $ref: '#/components/schemas/TimeseriesResponseSeriesList'
+        times:
+          $ref: '#/components/schemas/TimeseriesResponseTimes'
+        values:
+          $ref: '#/components/schemas/TimeseriesResponseValuesList'
+      type: object
+    TimeseriesResponseSeries:
+      description: ''
+      properties:
+        group_tags:
+          $ref: '#/components/schemas/GroupTags'
+        query_index:
+          description: The index of the query in the "formulas" array (or "queries"
+            array if no "formulas" was specified).
+          example: 0
+          format: int32
+          maximum: 2147483647
+          type: integer
+        unit:
+          description: List of units.
+          items:
+            $ref: '#/components/schemas/Unit'
+          type: array
+      type: object
+    TimeseriesResponseSeriesList:
+      description: Array of response series. The index here corresponds to the index
+        in the `formulas` or `queries` array from the request.
+      items:
+        $ref: '#/components/schemas/TimeseriesResponseSeries'
+      type: array
+    TimeseriesResponseTimes:
+      description: Array of times, 1-1 match with individual values arrays.
+      items:
+        description: Start date (inclusive) of the query in seconds since the Unix
+          epoch.
+        example: 1568899800000
+        format: int64
+        type: integer
+      type: array
+    TimeseriesResponseValues:
+      description: Array of values for an individual formula or query.
+      items:
+        description: An individual value for a given time.
+        format: double
+        type: number
+      type: array
+    TimeseriesResponseValuesList:
+      description: Array of value-arrays. The index here corresponds to the index
+        in the `formulas` or `queries` array from the request.
+      items:
+        $ref: '#/components/schemas/TimeseriesResponseValues'
+      type: array
     TimestampEventAttribute:
       description: Timestamp of your event.
       example: '2019-01-02T09:42:36.320Z'
       format: date-time
       type: string
+    Unit:
+      description: Object containing the metric unit family, scale factor, name, and
+        short name.
+      nullable: true
+      properties:
+        family:
+          description: Unit family, allows for conversion between units of the same
+            family, for scaling.
+          example: time
+          type: string
+        name:
+          description: Unit name
+          example: minute
+          type: string
+        plural:
+          description: Plural form of the unit name.
+          example: minutes
+          type: string
+        scale_factor:
+          description: Factor for scaling between units of the same family.
+          example: 60.0
+          format: double
+          type: number
+        short_name:
+          description: Abbreviation of the unit.
+          example: min
+          type: string
+      type: object
     UsageApplicationSecurityMonitoringResponse:
       description: Application Security Monitoring usage response.
       properties:
@@ -11046,6 +11887,9 @@ components:
             incident_settings_write: Configure Incidents settings.
             incident_write: Create, view, and manage incidents in Datadog.
             metrics_read: View custom metrics.
+            monitors_downtime: Set downtimes to suppress alerts from any monitor in
+              an organization. The ability to write monitors is not required to set
+              downtimes.
             monitors_read: View monitors.
             security_monitoring_filters_read: Read Security Filters.
             security_monitoring_filters_write: Create, edit, and delete Security Filters.
@@ -12612,6 +13456,42 @@ paths:
       x-unstable: '**Note**: This endpoint is in public beta.
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v2/incidents/search:
+    get:
+      description: Search for incidents matching a certain query.
+      operationId: SearchIncidents
+      parameters:
+      - $ref: '#/components/parameters/IncidentSearchIncludeQueryParameter'
+      - $ref: '#/components/parameters/IncidentSearchQueryQueryParameter'
+      - $ref: '#/components/parameters/IncidentSearchSortQueryParameter'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/IncidentSearchResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '401':
+          $ref: '#/components/responses/UnauthorizedResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - incident_read
+      summary: Search for incidents
+      tags:
+      - Incidents
+      x-unstable: '**Note**: This endpoint is in public beta.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/incidents/{incident_id}:
     delete:
       description: Deletes an existing incident from the users organization.
@@ -14869,6 +15749,82 @@ paths:
         cursorPath: meta.page.after
         limitParam: page[limit]
         resultsPath: data
+  /api/v2/query/scalar:
+    post:
+      description: 'The internal endpoint to query scalar/table data for multiple
+        data sources and
+        process the data using formulas and functions.'
+      operationId: QueryScalarData
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ScalarFormulaQueryRequest'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ScalarFormulaQueryResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '401':
+          $ref: '#/components/responses/UnauthorizedResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Scalar cross product query
+      tags:
+      - Metrics
+      x-codegen-request-body-name: body
+      x-unstable: '**Note**: This endpoint is GA for the metrics data source. Logs
+        is in beta.
+        We are gradually onboarding support for more sources. If you have any feedback,
+        contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v2/query/timeseries:
+    post:
+      description: 'The internal endpoint to query timeseries data for multiple data
+        sources and
+        process the data by applying formulas and functions.'
+      operationId: QueryTimeseriesData
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TimeseriesFormulaQueryRequest'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TimeseriesFormulaQueryResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '401':
+          $ref: '#/components/responses/UnauthorizedResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Timeseries cross product query
+      tags:
+      - Metrics
+      x-codegen-request-body-name: body
+      x-unstable: '**Note**: This endpoint is GA for the metrics data source. Logs
+        is in beta.
+        We are gradually onboarding support for more sources. If you have any feedback,
+        contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/roles:
     get:
       description: Returns all roles, including their names and their unique identifiers.
@@ -18560,12 +19516,13 @@ tags:
     url: https://docs.datadoghq.com/logs/logs_to_metrics/
   name: Logs Metrics
 - description: "The metrics endpoint allows you to:\n\n- Post metrics data so it can
-    be graphed on Datadog\u2019s dashboards\n- Query metrics from any time period\n-
-    Modify tag configurations for metrics\n- View tags and volumes for metrics\n\n**Note**:
-    A graph can only contain a set number of points\nand as the timeframe over which
-    a metric is viewed increases,\naggregation between points occurs to stay below
-    that set number.\n\nThe Post, Patch, and Delete `manage_tags` API methods can
-    only be performed by\na user who has the `Manage Tags for Metrics` permission."
+    be graphed on Datadog\u2019s dashboards\n- Query metrics from any time period
+    (timeseries and scalar)\n- Modify tag configurations for metrics\n- View tags
+    and volumes for metrics\n\n**Note**: A graph can only contain a set number of
+    points\nand as the timeframe over which a metric is viewed increases,\naggregation
+    between points occurs to stay below that set number.\n\nThe Post, Patch, and Delete
+    `manage_tags` API methods can only be performed by\na user who has the `Manage
+    Tags for Metrics` permission."
   name: Metrics
 - description: 'Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/)