OpenApiVersion está predefinido como OpenApi3_2

O valor padrão de OpenApiVersion mudou de OpenApiSpecVersion.OpenApi3_1 para OpenApiSpecVersion.OpenApi3_2. Aplicações que dependem da saída OpenAPI 3.1 sem definir explicitamente a versão produzem agora documentos OpenAPI 3.2.

Versão introduzida

.NET 11 Pré-visualização 6

Comportamento anterior

Anteriormente, OpenApiOptions.OpenApiVersion estava predefinido como OpenApiSpecVersion.OpenApi3_1. Chamar AddOpenApi sem definir explicitamente uma versão produzia um documento OpenAPI 3.1.

Novo comportamento

A partir do ASP.NET Core 11 Preview 6, OpenApiOptions.OpenApiVersion passa a ser, por predefinição, OpenApiSpecVersion.OpenApi3_2. Chamar AddOpenApi sem definir explicitamente uma versão produz agora um documento OpenAPI 3.2.

Tipo de mudança disruptiva

Esta mudança é uma mudança comportamental.

Motivo da mudança

O suporte OpenAPI do ASP.NET Core utiliza a versão mais recente lançada da especificação OpenAPI como predefinido, para que as aplicações beneficiem de novas capacidades sem necessidade de configurações adicionais.

Ação recomendada

Na maioria dos casos, não é necessária qualquer ação. Para suportar ferramentas a jusante que ainda não lidam com OpenAPI 3.2, configure explicitamente a versão:

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

APIs afetadas

• OpenApiVersion