@@ -29986,6 +29986,25 @@ components:
2998629986 data:
2998729987 $ref: "#/components/schemas/ListDeploymentRuleResponseData"
2998829988 type: object
29989+ DeploymentGatesEvaluationConfiguration:
29990+ description: |-
29991+ Inline rule definitions for a deployment gate evaluation. When provided, rules are evaluated
29992+ directly from this configuration instead of using the preconfigured gate rules.
29993+ At least one rule is required.
29994+ properties:
29995+ dry_run:
29996+ description: Gate-level dry run. When enabled, the rules are evaluated normally but the gate always returns `pass`. The real result is visible in the Datadog UI.
29997+ example: false
29998+ type: boolean
29999+ rules:
30000+ description: The list of rules to evaluate. At least one rule is required.
30001+ items:
30002+ $ref: "#/components/schemas/DeploymentGatesEvaluationRule"
30003+ minItems: 1
30004+ type: array
30005+ required:
30006+ - rules
30007+ type: object
2998930008 DeploymentGatesEvaluationRequest:
2999030009 description: Request body for triggering a deployment gate evaluation.
2999130010 properties:
@@ -29995,8 +30014,13 @@ components:
2999530014 - data
2999630015 type: object
2999730016 DeploymentGatesEvaluationRequestAttributes:
29998- description: Attributes for a deployment gate evaluation request.
30017+ description: |-
30018+ Attributes for a deployment gate evaluation request.
30019+ When `configuration` is provided, rules are evaluated inline from that configuration.
30020+ When omitted, rules are resolved from the preconfigured gate for the given service and environment.
2999930021 properties:
30022+ configuration:
30023+ $ref: "#/components/schemas/DeploymentGatesEvaluationConfiguration"
3000030024 env:
3000130025 description: The environment of the deployment.
3000230026 example: "staging"
@@ -30166,6 +30190,60 @@ components:
3016630190 type: string
3016730191 x-enum-varnames:
3016830192 - DEPLOYMENT_GATES_EVALUATION_RESULT_RESPONSE
30193+ DeploymentGatesEvaluationRule:
30194+ description: A rule to evaluate as part of a deployment gate evaluation.
30195+ discriminator:
30196+ mapping:
30197+ faulty_deployment_detection: "#/components/schemas/DeploymentGatesFDDRule"
30198+ monitor: "#/components/schemas/DeploymentGatesMonitorRule"
30199+ propertyName: type
30200+ oneOf:
30201+ - $ref: "#/components/schemas/DeploymentGatesMonitorRule"
30202+ - $ref: "#/components/schemas/DeploymentGatesFDDRule"
30203+ DeploymentGatesFDDRule:
30204+ description: A faulty deployment detection rule to evaluate as part of a deployment gate evaluation.
30205+ properties:
30206+ dry_run:
30207+ description: Rule-level dry run. When enabled, the rule is evaluated normally but it always returns `pass`. The real result is visible in the Datadog UI.
30208+ example: false
30209+ type: boolean
30210+ name:
30211+ description: Human-readable name for this rule.
30212+ example: "apm faulty deployment"
30213+ type: string
30214+ options:
30215+ $ref: "#/components/schemas/DeploymentGatesFDDRuleOptions"
30216+ type:
30217+ $ref: "#/components/schemas/DeploymentGatesFDDRuleType"
30218+ required:
30219+ - type
30220+ - name
30221+ type: object
30222+ DeploymentGatesFDDRuleOptions:
30223+ description: Options for a `faulty_deployment_detection` rule.
30224+ properties:
30225+ duration:
30226+ description: Evaluation window in seconds. Maximum 7200 (2 hours).
30227+ example: 900
30228+ format: int64
30229+ maximum: 7200
30230+ type: integer
30231+ excluded_resources:
30232+ description: APM resource names to exclude from analysis.
30233+ example:
30234+ - "GET /healthcheck"
30235+ items:
30236+ type: string
30237+ type: array
30238+ type: object
30239+ DeploymentGatesFDDRuleType:
30240+ description: The type identifier for a faulty deployment detection rule.
30241+ enum:
30242+ - faulty_deployment_detection
30243+ example: faulty_deployment_detection
30244+ type: string
30245+ x-enum-varnames:
30246+ - FAULTY_DEPLOYMENT_DETECTION
3016930247 DeploymentGatesListResponse:
3017030248 description: Response containing a paginated list of deployment gates.
3017130249 properties:
@@ -30200,6 +30278,49 @@ components:
3020030278 minimum: 1
3020130279 type: integer
3020230280 type: object
30281+ DeploymentGatesMonitorRule:
30282+ description: A monitor rule to evaluate as part of a deployment gate evaluation.
30283+ properties:
30284+ dry_run:
30285+ description: Rule-level dry run. When enabled, the rule is evaluated normally but always returns `pass`. The real result is visible in the Datadog UI.
30286+ example: false
30287+ type: boolean
30288+ name:
30289+ description: Human-readable name for this rule.
30290+ example: "error rate monitors"
30291+ type: string
30292+ options:
30293+ $ref: "#/components/schemas/DeploymentGatesMonitorRuleOptions"
30294+ type:
30295+ $ref: "#/components/schemas/DeploymentGatesMonitorRuleType"
30296+ required:
30297+ - type
30298+ - name
30299+ type: object
30300+ DeploymentGatesMonitorRuleOptions:
30301+ description: Options for a `monitor` rule.
30302+ properties:
30303+ duration:
30304+ description: Evaluation window in seconds. Maximum 7200 (2 hours).
30305+ example: 300
30306+ format: int64
30307+ maximum: 7200
30308+ type: integer
30309+ query:
30310+ description: Monitor search query.
30311+ example: "service:transaction-backend env:production"
30312+ type: string
30313+ required:
30314+ - query
30315+ type: object
30316+ DeploymentGatesMonitorRuleType:
30317+ description: The type identifier for a monitor rule.
30318+ enum:
30319+ - monitor
30320+ example: monitor
30321+ type: string
30322+ x-enum-varnames:
30323+ - MONITOR
3020330324 DeploymentGatesRuleResponse:
3020430325 description: The result of a single rule evaluation.
3020530326 properties:
@@ -124658,12 +124779,17 @@ paths:
124658124779 Triggers an asynchronous deployment gate evaluation for the given service and environment.
124659124780 Returns an evaluation ID that can be used to poll for the result via the
124660124781 `GET /api/v2/deployments/gates/evaluation/{id}` endpoint.
124782+
124783+ When the `configuration` attribute is provided, rules are evaluated inline from that configuration
124784+ and no pre-configured gate is required. When `configuration` is omitted, rules are resolved from the
124785+ gate pre-configured for the given service and environment through the Datadog UI, API, or Terraform.
124661124786 operationId: TriggerDeploymentGatesEvaluation
124662124787 requestBody:
124663124788 content:
124664124789 application/json:
124665124790 examples:
124666124791 default:
124792+ summary: Evaluate a preconfigured gate
124667124793 value:
124668124794 data:
124669124795 attributes:
@@ -124673,6 +124799,31 @@ paths:
124673124799 service: transaction-backend
124674124800 version: v1.2.3
124675124801 type: deployment_gates_evaluation_request
124802+ with-configuration:
124803+ summary: Evaluate with inline rule configuration
124804+ value:
124805+ data:
124806+ attributes:
124807+ configuration:
124808+ dry_run: false
124809+ rules:
124810+ - dry_run: false
124811+ name: error rate monitors
124812+ options:
124813+ duration: 300
124814+ query: "service:transaction-backend env:production"
124815+ type: monitor
124816+ - dry_run: false
124817+ name: apm faulty deployment
124818+ options:
124819+ duration: 900
124820+ excluded_resources:
124821+ - "GET /healthcheck"
124822+ type: faulty_deployment_detection
124823+ env: production
124824+ service: transaction-backend
124825+ version: 1.2.3
124826+ type: deployment_gates_evaluation_request
124676124827 schema:
124677124828 $ref: "#/components/schemas/DeploymentGatesEvaluationRequest"
124678124829 required: true
0 commit comments