return 422 response code for logs indexes creation when max limit is reached (#3276)

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

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

.generated-info

@@ -1,4 +1,4 @@
 {
-  "spec_repo_commit": "205813d",
-  "generated": "2025-08-25 08:43:18.277"
+  "spec_repo_commit": "c3b2b7d",
+  "generated": "2025-08-25 10:19:56.716"
 }

.generator/schemas/v1/openapi.yaml

@@ -5123,6 +5123,12 @@ components:
         error:
           $ref: '#/components/schemas/LogsAPIError'
       type: object
+    LogsAPILimitReachedResponse:
+      description: Response returned by the Logs API when the max limit has been reached.
+      properties:
+        error:
+          $ref: '#/components/schemas/LogsAPIError'
+      type: object
     LogsArithmeticProcessor:
       description: "Use the Arithmetic Processor to add a new attribute (without spaces
         or special characters\nin the new attribute name) to a log with the result
@@ -29444,6 +29450,12 @@ paths:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
           description: Forbidden
+        '422':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/LogsAPILimitReachedResponse'
+          description: Unprocessable Entity
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
       summary: Create an index

api/datadogV1/api_logs_indexes.go

@@ -88,6 +88,15 @@ func (a *LogsIndexesApi) CreateLogsIndex(ctx _context.Context, body LogsIndex) (
 				return localVarReturnValue, localVarHTTPResponse, newErr
 			}
 			newErr.ErrorModel = v
+			return localVarReturnValue, localVarHTTPResponse, newErr
+		}
+		if localVarHTTPResponse.StatusCode == 422 {
+			var v LogsAPILimitReachedResponse
+			err = a.Client.Decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
+			if err != nil {
+				return localVarReturnValue, localVarHTTPResponse, newErr
+			}
+			newErr.ErrorModel = v
 		}
 		return localVarReturnValue, localVarHTTPResponse, newErr
 	}

api/datadogV1/model_logs_api_limit_reached_response.go

@@ -0,0 +1,111 @@
+// 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 (
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
+)
+
+// LogsAPILimitReachedResponse Response returned by the Logs API when the max limit has been reached.
+type LogsAPILimitReachedResponse struct {
+	// Error returned by the Logs API
+	Error *LogsAPIError `json:"error,omitempty"`
+	// 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:"-"`
+}
+
+// NewLogsAPILimitReachedResponse instantiates a new LogsAPILimitReachedResponse 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 NewLogsAPILimitReachedResponse() *LogsAPILimitReachedResponse {
+	this := LogsAPILimitReachedResponse{}
+	return &this
+}
+
+// NewLogsAPILimitReachedResponseWithDefaults instantiates a new LogsAPILimitReachedResponse 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 NewLogsAPILimitReachedResponseWithDefaults() *LogsAPILimitReachedResponse {
+	this := LogsAPILimitReachedResponse{}
+	return &this
+}
+
+// GetError returns the Error field value if set, zero value otherwise.
+func (o *LogsAPILimitReachedResponse) GetError() LogsAPIError {
+	if o == nil || o.Error == nil {
+		var ret LogsAPIError
+		return ret
+	}
+	return *o.Error
+}
+
+// GetErrorOk returns a tuple with the Error field value if set, nil otherwise
+// and a boolean to check if the value has been set.
+func (o *LogsAPILimitReachedResponse) GetErrorOk() (*LogsAPIError, bool) {
+	if o == nil || o.Error == nil {
+		return nil, false
+	}
+	return o.Error, true
+}
+
+// HasError returns a boolean if a field has been set.
+func (o *LogsAPILimitReachedResponse) HasError() bool {
+	return o != nil && o.Error != nil
+}
+
+// SetError gets a reference to the given LogsAPIError and assigns it to the Error field.
+func (o *LogsAPILimitReachedResponse) SetError(v LogsAPIError) {
+	o.Error = &v
+}
+
+// MarshalJSON serializes the struct using spec logic.
+func (o LogsAPILimitReachedResponse) MarshalJSON() ([]byte, error) {
+	toSerialize := map[string]interface{}{}
+	if o.UnparsedObject != nil {
+		return datadog.Marshal(o.UnparsedObject)
+	}
+	if o.Error != nil {
+		toSerialize["error"] = o.Error
+	}
+
+	for key, value := range o.AdditionalProperties {
+		toSerialize[key] = value
+	}
+	return datadog.Marshal(toSerialize)
+}
+
+// UnmarshalJSON deserializes the given payload.
+func (o *LogsAPILimitReachedResponse) UnmarshalJSON(bytes []byte) (err error) {
+	all := struct {
+		Error *LogsAPIError `json:"error,omitempty"`
+	}{}
+	if err = datadog.Unmarshal(bytes, &all); err != nil {
+		return datadog.Unmarshal(bytes, &o.UnparsedObject)
+	}
+	additionalProperties := make(map[string]interface{})
+	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
+		datadog.DeleteKeys(additionalProperties, &[]string{"error"})
+	} else {
+		return err
+	}
+
+	hasInvalidField := false
+	if all.Error != nil && all.Error.UnparsedObject != nil && o.UnparsedObject == nil {
+		hasInvalidField = true
+	}
+	o.Error = all.Error
+
+	if len(additionalProperties) > 0 {
+		o.AdditionalProperties = additionalProperties
+	}
+
+	if hasInvalidField {
+		return datadog.Unmarshal(bytes, &o.UnparsedObject)
+	}
+
+	return nil
+}

tests/scenarios/features/v1/logs_indexes.feature

@@ -22,6 +22,13 @@ Feature: Logs Indexes
     When the request is sent
     Then the response status is 200 OK
 
+  @generated @skip @team:DataDog/logs-backend @team:DataDog/logs-core
+  Scenario: Create an index returns "Unprocessable Entity" response
+    Given new "CreateLogsIndex" request
+    And body with value {"daily_limit": 300000000, "daily_limit_reset": {"reset_time": "14:00", "reset_utc_offset": "+02:00"}, "daily_limit_warning_threshold_percentage": 70, "exclusion_filters": [{"filter": {"query": "*", "sample_rate": 1.0}, "name": "payment"}], "filter": {"query": "source:python"}, "name": "main", "num_flex_logs_retention_days": 360, "num_retention_days": 15}
+    When the request is sent
+    Then the response status is 422 Unprocessable Entity
+
   @generated @skip @team:DataDog/logs-backend @team:DataDog/logs-core
   Scenario: Delete an index returns "Not Found" response
     Given new "DeleteLogsIndex" request