OpenApiVersion tiene como valor predeterminado OpenApi3_2

El valor predeterminado de OpenApiVersion ha cambiado de OpenApiSpecVersion.OpenApi3_1 a OpenApiSpecVersion.OpenApi3_2. Las aplicaciones que dependen de la salida de OpenAPI 3.1 sin establecer explícitamente la versión ahora generan documentos de OpenAPI 3.2.

Versión introducida

.NET 11 Preview 6

Comportamiento anterior

Anteriormente, OpenApiOptions.OpenApiVersion tenía como valor predeterminado OpenApiSpecVersion.OpenApi3_1. Llamar AddOpenApi sin establecer explícitamente una versión produjo un documento de OpenAPI 3.1.

Nuevo comportamiento

A partir de ASP.NET Core 11 Preview 6, OpenApiOptions.OpenApiVersion el valor predeterminado es OpenApiSpecVersion.OpenApi3_2. Llamar AddOpenApi sin establecer explícitamente una versión ahora genera un documento de OpenAPI 3.2.

Tipo de cambio disruptivo

Este es un cambio de comportamiento.

Motivo del cambio

la compatibilidad con OpenAPI de ASP.NET Core usa la versión más reciente de la especificación openAPI como valor predeterminado para que las aplicaciones se beneficien de nuevas funcionalidades sin configuración adicional.

Acción recomendada

En la mayoría de los casos, no se necesita ninguna acción. Para admitir las herramientas de nivel inferior que aún no controlan OpenAPI 3.2, configure la versión explícitamente:

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

Las APIs afectadas

• OpenApiVersion