swagger - 如何在 OpenAPI/Swagger v3 中指定多部分表单字段是可选的？

Question

我想概述一个多部分表单请求正文，其中一些字段是必需的，而其他字段是可选的。通常，在 OAS 模式对象中，所有未明确标记的属性required: true都默认为可选。但是，在概述requestBody带有multipart/form-data内容的内容时，这似乎被搁置了，并且所有字段都是必需的。

我尝试了多种方法来指定必填字段和可选字段。尝试使用required: false.

OAS3 规格：

requestBody:
  required: true
  content:
    multipart/form-data:
      schema:
        type: object
        required:
          - foo
        properties:
          foo:
            type: string
            format: binary
          bar:
            type: string
            format: binary

预期：详细信息 amultipart/form-data requestBody包含一些必填字段和一些可选字段。

在上面的代码示例中，foo应该是必需文件，而bar应该是可选文件。