Regenerate client from commit 0895ae7 of spec repo (#4135)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v1/openapi.yaml

@@ -1345,6 +1345,50 @@ components:
       type: string
       x-enum-varnames:
         - COHORT
+    ComparisonCustomTimeframe:
+      description: Fixed time range for a `custom_timeframe` comparison.
+      properties:
+        from:
+          description: Start time in milliseconds since epoch.
+          example: 1779290190000
+          format: int64
+          type: integer
+        to:
+          description: End time in milliseconds since epoch.
+          example: 1779894990000
+          format: int64
+          type: integer
+      required:
+        - from
+        - to
+      type: object
+    ComparisonDuration:
+      description: The comparison period. Use a preset `type` value or set `type` to `custom_timeframe` and provide `custom_timeframe` with explicit millisecond epoch bounds.
+      properties:
+        custom_timeframe:
+          $ref: "#/components/schemas/ComparisonCustomTimeframe"
+          description: Required when `type` is `custom_timeframe`. Fixed time range to compare against.
+        type:
+          $ref: "#/components/schemas/ComparisonDurationType"
+      required:
+        - type
+      type: object
+    ComparisonDurationType:
+      description: "The comparison window type."
+      enum:
+        - previous_timeframe
+        - custom_timeframe
+        - previous_day
+        - previous_week
+        - previous_month
+      example: previous_timeframe
+      type: string
+      x-enum-varnames:
+        - PREVIOUS_TIMEFRAME
+        - CUSTOM_TIMEFRAME
+        - PREVIOUS_DAY
+        - PREVIOUS_WEEK
+        - PREVIOUS_MONTH
     ContentEncoding:
       description: HTTP header used to compress the media-type.
       enum:
@@ -12064,6 +12108,43 @@ components:
       x-enum-varnames:
         - ASC
         - DESC
+    QueryValueWidgetComparison:
+      description: A change indicator that compares the current value to a historical period.
+      properties:
+        directionality:
+          $ref: "#/components/schemas/QueryValueWidgetComparisonDirectionality"
+          description: Which direction of change is considered an improvement, determining the indicator color.
+        duration:
+          $ref: "#/components/schemas/ComparisonDuration"
+        type:
+          $ref: "#/components/schemas/QueryValueWidgetComparisonType"
+      required:
+        - duration
+      type: object
+    QueryValueWidgetComparisonDirectionality:
+      default: neutral
+      description: "Color-coding direction: `increase_better` (green on rise), `decrease_better` (green on drop), or `neutral` (no color)."
+      enum:
+        - increase_better
+        - decrease_better
+        - neutral
+      type: string
+      x-enum-varnames:
+        - INCREASE_BETTER
+        - DECREASE_BETTER
+        - NEUTRAL
+    QueryValueWidgetComparisonType:
+      default: absolute
+      description: "How the delta is expressed: `absolute` (raw difference), `relative` (percentage), or `both`."
+      enum:
+        - absolute
+        - relative
+        - both
+      type: string
+      x-enum-varnames:
+        - ABSOLUTE
+        - RELATIVE
+        - BOTH
     QueryValueWidgetDefinition:
       description: Query values display the current value of a given metric, APM, or log query.
       properties:
@@ -12135,6 +12216,9 @@ components:
           $ref: "#/components/schemas/LogQueryDefinition"
           deprecated: true
           description: Deprecated - Use `queries` and `formulas` instead.
+        comparison:
+          $ref: "#/components/schemas/QueryValueWidgetComparison"
+          description: Displays a change indicator showing a delta against a historical baseline.
         conditional_formats:
           description: List of conditional formats.
           items:

.generator/schemas/v2/openapi.yaml

@@ -66681,9 +66681,6 @@ components:
         filter:
           description: Filter expression applied to the recommendations.
           type: string
-        scope:
-          description: Recommendations scope. Defaults to `ccm`; use `experiment` for experimental recommendations or `*` for both.
-          type: string
         sort:
           description: Ordered list of sort clauses applied to the result set.
           items:

api/datadogV1/model_comparison_custom_timeframe.go

@@ -0,0 +1,133 @@
+// Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+// This product includes software developed at Datadog (https://www.datadoghq.com/).
+// Copyright 2019-Present Datadog, Inc.
+
+package datadogV1
+
+import (
+	"fmt"
+
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
+)
+
+// ComparisonCustomTimeframe Fixed time range for a `custom_timeframe` comparison.
+type ComparisonCustomTimeframe struct {
+	// Start time in milliseconds since epoch.
+	From int64 `json:"from"`
+	// End time in milliseconds since epoch.
+	To int64 `json:"to"`
+	// UnparsedObject contains the raw value of the object if there was an error when deserializing into the struct
+	UnparsedObject       map[string]interface{} `json:"-"`
+	AdditionalProperties map[string]interface{} `json:"-"`
+}
+
+// NewComparisonCustomTimeframe instantiates a new ComparisonCustomTimeframe object.
+// This constructor will assign default values to properties that have it defined,
+// and makes sure properties required by API are set, but the set of arguments
+// will change when the set of required properties is changed.
+func NewComparisonCustomTimeframe(from int64, to int64) *ComparisonCustomTimeframe {
+	this := ComparisonCustomTimeframe{}
+	this.From = from
+	this.To = to
+	return &this
+}
+
+// NewComparisonCustomTimeframeWithDefaults instantiates a new ComparisonCustomTimeframe object.
+// This constructor will only assign default values to properties that have it defined,
+// but it doesn't guarantee that properties required by API are set.
+func NewComparisonCustomTimeframeWithDefaults() *ComparisonCustomTimeframe {
+	this := ComparisonCustomTimeframe{}
+	return &this
+}
+
+// GetFrom returns the From field value.
+func (o *ComparisonCustomTimeframe) GetFrom() int64 {
+	if o == nil {
+		var ret int64
+		return ret
+	}
+	return o.From
+}
+
+// GetFromOk returns a tuple with the From field value
+// and a boolean to check if the value has been set.
+func (o *ComparisonCustomTimeframe) GetFromOk() (*int64, bool) {
+	if o == nil {
+		return nil, false
+	}
+	return &o.From, true
+}
+
+// SetFrom sets field value.
+func (o *ComparisonCustomTimeframe) SetFrom(v int64) {
+	o.From = v
+}
+
+// GetTo returns the To field value.
+func (o *ComparisonCustomTimeframe) GetTo() int64 {
+	if o == nil {
+		var ret int64
+		return ret
+	}
+	return o.To
+}
+
+// GetToOk returns a tuple with the To field value
+// and a boolean to check if the value has been set.
+func (o *ComparisonCustomTimeframe) GetToOk() (*int64, bool) {
+	if o == nil {
+		return nil, false
+	}
+	return &o.To, true
+}
+
+// SetTo sets field value.
+func (o *ComparisonCustomTimeframe) SetTo(v int64) {
+	o.To = v
+}
+
+// MarshalJSON serializes the struct using spec logic.
+func (o ComparisonCustomTimeframe) MarshalJSON() ([]byte, error) {
+	toSerialize := map[string]interface{}{}
+	if o.UnparsedObject != nil {
+		return datadog.Marshal(o.UnparsedObject)
+	}
+	toSerialize["from"] = o.From
+	toSerialize["to"] = o.To
+
+	for key, value := range o.AdditionalProperties {
+		toSerialize[key] = value
+	}
+	return datadog.Marshal(toSerialize)
+}
+
+// UnmarshalJSON deserializes the given payload.
+func (o *ComparisonCustomTimeframe) UnmarshalJSON(bytes []byte) (err error) {
+	all := struct {
+		From *int64 `json:"from"`
+		To   *int64 `json:"to"`
+	}{}
+	if err = datadog.Unmarshal(bytes, &all); err != nil {
+		return datadog.Unmarshal(bytes, &o.UnparsedObject)
+	}
+	if all.From == nil {
+		return fmt.Errorf("required field from missing")
+	}
+	if all.To == nil {
+		return fmt.Errorf("required field to missing")
+	}
+	additionalProperties := make(map[string]interface{})
+	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
+		datadog.DeleteKeys(additionalProperties, &[]string{"from", "to"})
+	} else {
+		return err
+	}
+	o.From = *all.From
+	o.To = *all.To
+
+	if len(additionalProperties) > 0 {
+		o.AdditionalProperties = additionalProperties
+	}
+
+	return nil
+}

api/datadogV1/model_comparison_duration.go

@@ -0,0 +1,149 @@
+// Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+// This product includes software developed at Datadog (https://www.datadoghq.com/).
+// Copyright 2019-Present Datadog, Inc.
+
+package datadogV1
+
+import (
+	"fmt"
+
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
+)
+
+// ComparisonDuration The comparison period. Use a preset `type` value or set `type` to `custom_timeframe` and provide `custom_timeframe` with explicit millisecond epoch bounds.
+type ComparisonDuration struct {
+	// Fixed time range for a `custom_timeframe` comparison.
+	CustomTimeframe *ComparisonCustomTimeframe `json:"custom_timeframe,omitempty"`
+	// The comparison window type.
+	Type ComparisonDurationType `json:"type"`
+	// UnparsedObject contains the raw value of the object if there was an error when deserializing into the struct
+	UnparsedObject       map[string]interface{} `json:"-"`
+	AdditionalProperties map[string]interface{} `json:"-"`
+}
+
+// NewComparisonDuration instantiates a new ComparisonDuration object.
+// This constructor will assign default values to properties that have it defined,
+// and makes sure properties required by API are set, but the set of arguments
+// will change when the set of required properties is changed.
+func NewComparisonDuration(typeVar ComparisonDurationType) *ComparisonDuration {
+	this := ComparisonDuration{}
+	this.Type = typeVar
+	return &this
+}
+
+// NewComparisonDurationWithDefaults instantiates a new ComparisonDuration object.
+// This constructor will only assign default values to properties that have it defined,
+// but it doesn't guarantee that properties required by API are set.
+func NewComparisonDurationWithDefaults() *ComparisonDuration {
+	this := ComparisonDuration{}
+	return &this
+}
+
+// GetCustomTimeframe returns the CustomTimeframe field value if set, zero value otherwise.
+func (o *ComparisonDuration) GetCustomTimeframe() ComparisonCustomTimeframe {
+	if o == nil || o.CustomTimeframe == nil {
+		var ret ComparisonCustomTimeframe
+		return ret
+	}
+	return *o.CustomTimeframe
+}
+
+// GetCustomTimeframeOk returns a tuple with the CustomTimeframe field value if set, nil otherwise
+// and a boolean to check if the value has been set.
+func (o *ComparisonDuration) GetCustomTimeframeOk() (*ComparisonCustomTimeframe, bool) {
+	if o == nil || o.CustomTimeframe == nil {
+		return nil, false
+	}
+	return o.CustomTimeframe, true
+}
+
+// HasCustomTimeframe returns a boolean if a field has been set.
+func (o *ComparisonDuration) HasCustomTimeframe() bool {
+	return o != nil && o.CustomTimeframe != nil
+}
+
+// SetCustomTimeframe gets a reference to the given ComparisonCustomTimeframe and assigns it to the CustomTimeframe field.
+func (o *ComparisonDuration) SetCustomTimeframe(v ComparisonCustomTimeframe) {
+	o.CustomTimeframe = &v
+}
+
+// GetType returns the Type field value.
+func (o *ComparisonDuration) GetType() ComparisonDurationType {
+	if o == nil {
+		var ret ComparisonDurationType
+		return ret
+	}
+	return o.Type
+}
+
+// GetTypeOk returns a tuple with the Type field value
+// and a boolean to check if the value has been set.
+func (o *ComparisonDuration) GetTypeOk() (*ComparisonDurationType, bool) {
+	if o == nil {
+		return nil, false
+	}
+	return &o.Type, true
+}
+
+// SetType sets field value.
+func (o *ComparisonDuration) SetType(v ComparisonDurationType) {
+	o.Type = v
+}
+
+// MarshalJSON serializes the struct using spec logic.
+func (o ComparisonDuration) MarshalJSON() ([]byte, error) {
+	toSerialize := map[string]interface{}{}
+	if o.UnparsedObject != nil {
+		return datadog.Marshal(o.UnparsedObject)
+	}
+	if o.CustomTimeframe != nil {
+		toSerialize["custom_timeframe"] = o.CustomTimeframe
+	}
+	toSerialize["type"] = o.Type
+
+	for key, value := range o.AdditionalProperties {
+		toSerialize[key] = value
+	}
+	return datadog.Marshal(toSerialize)
+}
+
+// UnmarshalJSON deserializes the given payload.
+func (o *ComparisonDuration) UnmarshalJSON(bytes []byte) (err error) {
+	all := struct {
+		CustomTimeframe *ComparisonCustomTimeframe `json:"custom_timeframe,omitempty"`
+		Type            *ComparisonDurationType    `json:"type"`
+	}{}
+	if err = datadog.Unmarshal(bytes, &all); err != nil {
+		return datadog.Unmarshal(bytes, &o.UnparsedObject)
+	}
+	if all.Type == nil {
+		return fmt.Errorf("required field type missing")
+	}
+	additionalProperties := make(map[string]interface{})
+	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
+		datadog.DeleteKeys(additionalProperties, &[]string{"custom_timeframe", "type"})
+	} else {
+		return err
+	}
+
+	hasInvalidField := false
+	if all.CustomTimeframe != nil && all.CustomTimeframe.UnparsedObject != nil && o.UnparsedObject == nil {
+		hasInvalidField = true
+	}
+	o.CustomTimeframe = all.CustomTimeframe
+	if !all.Type.IsValid() {
+		hasInvalidField = true
+	} else {
+		o.Type = *all.Type
+	}
+
+	if len(additionalProperties) > 0 {
+		o.AdditionalProperties = additionalProperties
+	}
+
+	if hasInvalidField {
+		return datadog.Unmarshal(bytes, &o.UnparsedObject)
+	}
+
+	return nil
+}