OpenApiVersion är som standard OpenApi3_2

Standardvärdet OpenApiVersion för har ändrats från OpenApiSpecVersion.OpenApi3_1 till OpenApiSpecVersion.OpenApi3_2. Appar som är beroende av OpenAPI 3.1-utdata utan att uttryckligen ange versionen skapar nu OpenAPI 3.2-dokument.

Version lanserad

.NET 11 Förhandsversion 6

Tidigare beteende

Tidigare var OpenApiOptions.OpenApiVersion standardvärdet OpenApiSpecVersion.OpenApi3_1. När du anropade AddOpenApi utan att uttryckligen ange en version skapades ett OpenAPI 3.1-dokument.

Nytt beteende

Från och med ASP.NET Core 11 Förhandsversion 6 är OpenApiOptions.OpenApiVersion standardvärdet OpenApiSpecVersion.OpenApi3_2. Om du anropar AddOpenApi utan att uttryckligen ange en version skapas nu ett OpenAPI 3.2-dokument.

Typ av brytande ändring

Den här ändringen är en beteendeförändring.

Orsak till ändringen

ASP.NET Core OpenAPI-stöd använder den senaste versionen av OpenAPI-specifikationen som standard så att appar drar nytta av nya funktioner utan ytterligare konfiguration.

I de flesta fall behövs ingen åtgärd. Om du vill ha stöd för nedströmsverktyg som ännu inte hanterar OpenAPI 3.2 konfigurerar du versionen explicit:

builder.Services.AddOpenApi(options =>
{
    options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi3_1;
});

Berörda API:er