Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La valeur par défaut de OpenApiVersion a changé de OpenApiSpecVersion.OpenApi3_1 à OpenApiSpecVersion.OpenApi3_2. Les applications qui dépendent de la sortie OpenAPI 3.1 sans définir explicitement la version produisent désormais des documents OpenAPI 3.2.
Version introduite
.NET 11 Preview 6
Comportement antérieur
Précédemment, OpenApiOptions.OpenApiVersion défini par défaut sur OpenApiSpecVersion.OpenApi3_1. L’appel AddOpenApi sans définir explicitement une version a produit un document OpenAPI 3.1.
Nouveau comportement
À partir d’ASP.NET Core 11 Preview 6, OpenApiOptions.OpenApiVersion a pour valeur par défaut OpenApiSpecVersion.OpenApi3_2. L’appel AddOpenApi sans définir explicitement une version produit désormais un document OpenAPI 3.2.
Type de changement cassant
Ce changement est un changement de comportement.
Raison du changement
La prise en charge d’OpenAPI par ASP.NET Core utilise par défaut la dernière version publiée de la spécification OpenAPI afin que les applications bénéficient des nouvelles fonctionnalités sans configuration supplémentaire.
Action recommandée
Dans la plupart des cas, aucune action n’est nécessaire. Pour prendre en charge les outils en aval qui ne gèrent pas encore OpenAPI 3.2, configurez la version explicitement :
builder.Services.AddOpenApi(options =>
{
options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi3_1;
});
API affectées
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
