Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il valore predefinito di OpenApiVersion è passato da OpenApiSpecVersion.OpenApi3_1 a OpenApiSpecVersion.OpenApi3_2. Le app che dipendono dall'output OpenAPI 3.1 senza impostare in modo esplicito la versione ora producono documenti OpenAPI 3.2.
Versione introdotta
.NET 11 Preview 6
Comportamento precedente
In precedenza, OpenApiOptions.OpenApiVersion era impostato per impostazione predefinita su OpenApiSpecVersion.OpenApi3_1. La chiamata AddOpenApi senza impostare in modo esplicito una versione ha prodotto un documento OpenAPI 3.1.
Nuovo comportamento
A partire da ASP.NET Core 11 Preview 6, OpenApiOptions.OpenApiVersion per impostazione predefinita è OpenApiSpecVersion.OpenApi3_2. La chiamata AddOpenApi senza impostare in modo esplicito una versione genera ora un documento OpenAPI 3.2.
Tipo di cambiamento che interrompe la compatibilità
Questa modifica è una modifica funzionale.
Motivo della modifica
il supporto OpenAPI di ASP.NET Core usa la versione rilasciata più recente della specifica OpenAPI come impostazione predefinita, in modo che le app traggono vantaggio dalle nuove funzionalità senza configurazione aggiuntiva.
Azione consigliata
Nella maggior parte dei casi non è necessaria alcuna azione. Per supportare gli strumenti downstream che non gestiscono ancora OpenAPI 3.2, configurare la versione in modo esplicito:
builder.Services.AddOpenApi(options =>
{
options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi3_1;
});
Le API interessate
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
