将 API 导入 API Gateway 时出现的错误和警告

在将外部定义文件导入 API Gateway 时，API Gateway 可能会生成警告和错误。以下部分讨论导入过程中可能出现的错误和警告。

导入过程中出现错误

在导入过程中，可能会因 OpenAPI 文档无效等严重问题而产生错误。系统会在不成功响应中将错误作为异常（如 BadRequestException）返回。出现错误时，新的 API 定义会被丢弃，现有 API 不会发生更改。

导入过程中出现警告

在导入过程中，可能会因缺失模型引用等轻微问题而产生警告。出现警告时，如果请求 URL 中附加了 failonwarnings=false 查询表达式，则操作将会继续。否则更新就会回滚。默认情况下，将 failonwarnings 设置为 false。在这种情况下，系统会在生成的 RestApi 资源中以字段形式返回警告。否则，系统会将警告作为异常中的一条消息返回。