问Open中指定的文档不会从API网关导出

EN

我通过Open规范指定了我的AWS网关API。规范包含了大量文档，我希望客户端开发人员在与API集成时使用这些文档。但是，我们添加到Open规范中的文档似乎不是从API导出的，因此无法使用。

如前所述，我从JSON中的Open规范开始。我使用CloudFormation AWS::ApiGateway::RestApi资源将其导入到API。

在此之后，我将API部署到一个阶段，最后，使用aws从这个API+stage导出文档：

aws apigateway get-export \
    --parameters extensions='documentation' \
    --rest-api-id abc123 \
    --stage-name api \
    --export-type swagger \
    ./docs.json

这个导出似乎缺少了许多重要的文档属性，比如description和pattern。

在我的API中有一个示例Open参数：

{
    in: 'path',
    name: 'service',
    type: 'string',
    required: true,
    pattern: '^[-a-zA-Z0-9]+$',
    description: 'Name of the Service (document) to retrieve.'
}

当我用上面的aws命令导出它时，我得到：

{
    "name" : "service",
    "in" : "path",
    "required" : true,
    "type" : "string"
}

description和pattern属性都已从文档导出中删除，这很糟糕，因为它们实际上是该参数的文档的主要部分。

还值得一提的是，如果我在Also (Swagger+API网关扩展)中导出相同的API，就会得到与文档导出相同的参数定义。

同样值得一提的是，如果有区别的话，集成都是基于Lambda代理的。