在哪里可以找到 AWS SAM Yaml 模型的完整规范？

Question

我找到了几个官方 AWS 文档，这些文档描述了在 Yaml 文件中指定模型的一些结构/模式。 例如：

• https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html
• https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-api.html#sam-resource-api--examples--simpleapiexample--yaml

特别是，第一个文件最后说：

这些示例不使用高级 JSON 架构功能，例如指定所需项、最小值和最大值（对于允许的字符串长度、数值和数组项长度）和正则表达式。 有关更多信息，请参阅介绍 JSON 和 JSON 模式草案 4。

并链接到https://www.json.org/json-en.html和https://datatracker.ietf.org/doc/html/draft-zyp-json-schema-04

这些文档都没有描述任何关于必需项、最小值和最大值或任何其他“高级”JSON 模式特性的内容。

是否有一些规范的参考资料显示了在 yaml 文件中描述模型时可能发生的情况以及语法是什么？ 怎么有人知道要输入什么？ 例如，在编写模型时，有人怎么知道：

        MyModel:
          description: this is an object with one property
          type: object
          properties:
            grade:
              type: integer

是正确的。 尽管：

        MyModel:
          description: this is an object with one property
          type: object
          properties:
            grade:
              type: int

是不正确的？

Answer 1

AWS 页面确实措辞有点糟糕。 “JSON Schema”是一组规范的名称，“Draft 4”是这些规范的特定版本。 （“draft”这个名字有点用词不当，由于历史和官僚原因而存在，所以你可以把它读作“Version 4”或“Release 4”。）

JSON Schema 的主页位于https://json-schema.org ，您可以在其中找到当前版本的基本规范（仅描述一般格式）和验证规范，这正是您所寻找的。

对于旧版本，您需要查看https://json-schema.org/specification-links.html ，因此如果 AWS 文档正确，API Gateway 仅支持 Draft 4（大约 10 年前），更有用的页面链接将是这样的： https ://datatracker.ietf.org/doc/html/draft-fge-json-schema-validation-00