Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Lorsque vous importez votre fichier de définition externe dans API Gateway, des avertissements et des erreurs peuvent être générés. Les sections suivantes décrivent les erreurs et les avertissements susceptibles de se produire lors de l’importation.
Erreurs lors de l’importation
Lors de l'importation, des erreurs peuvent être générées en cas de problème majeur, comme un document OpenAPI document. Les erreurs sont renvoyées en tant qu’exceptions (par exemple, BadRequestException
) dans une réponse infructueuse. Lorsqu’une erreur se produit, la nouvelle définition d’API est ignorée et aucune modification n’est apportée à l’API existante.
Avertissements lors de l’importation
Lors de l’importation, des avertissements peuvent être générés pour les problèmes mineurs, tels que l’absence d’une référence de modèle. En cas d’avertissement, l’opération continue si l’expression de requête failonwarnings=false
est ajoutée à l’URL de la demande. Sinon, les mises à jour sont annulées. Par défaut, la propriété failonwarnings
a la valeur false
. Dans ce cas, les avertissements sont renvoyés sous forme de champ dans la RestApiressource résultante. Sinon, les avertissements sont renvoyés sous la forme d’un message dans l’exception.