spectral:oas error on by default

oas2-discriminator

discriminator property must be defined and required

Applies to
discriminator
Selects
$.definitions[?(@.discriminator)]
Function
oasDiscriminator
Specs
OpenAPI 2.0
Message
{{error}}

Use it

This rule ships with OpenLint in spectral:oas. Extending the ruleset turns it on:

extends: spectral:oas
rules:
  oas2-discriminator: error   # or off, or another severity

Definition

As defined in @openlint/openlint-rulesets. Functions show by name.

oas2-discriminator:
  description: discriminator property must be defined and required
  message: '{{error}}'
  severity: 0
  recommended: true
  formats:
    - OpenAPI 2.0 (Swagger)
  given: '$.definitions[?(@.discriminator)]'
  then:
    function: oasDiscriminator

About this rule

The discriminator property MUST be defined at this schema and it MUST be in the required property list.

Sources