OpenApiVersion の既定値は OpenApi3_2

OpenApiVersionの既定値が OpenApiSpecVersion.OpenApi3_1 から OpenApiSpecVersion.OpenApi3_2 に変更されました。 バージョンを明示的に設定せずに OpenAPI 3.1 出力に依存するアプリで、OpenAPI 3.2 ドキュメントが生成されるようになりました。

導入されたバージョン

.NET 11 Preview 6

以前の動作

以前は、 OpenApiOptions.OpenApiVersion 既定では OpenApiSpecVersion.OpenApi3_1 に設定されています。 バージョンを明示的に設定せずに AddOpenApi を呼び出すと、OpenAPI 3.1 ドキュメントが生成されました。

新しい動作

ASP.NET Core 11 Preview 6 以降では、OpenApiOptions.OpenApiVersionの既定値は OpenApiSpecVersion.OpenApi3_2 です。 バージョンを明示的に設定せずに AddOpenApi を呼び出すと、OpenAPI 3.2 ドキュメントが生成されるようになりました。

破壊的変更の種類

この変更は 動作の変更です。

変更理由

ASP.NET Coreの OpenAPI サポートでは、OpenAPI 仕様の最新リリース バージョンが既定として使用されるため、アプリは追加の構成なしで新機能を利用できます。

ほとんどの場合、アクションは必要ありません。 OpenAPI 3.2 をまだ処理していないダウンストリーム ツールをサポートするには、バージョンを明示的に構成します。

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

影響を受ける API

  • 最終更新: