版本yaml文件的最佳方法是什么？

Question

我正在混合云上进行API项目。 API托管在内部，并通过云服务（Azure API管理服务）将API暴露给外部世界。对于任何API，我们都将手动将合同以Yaml文件的形式写在Open API Specification中，然后将其导入到Azure APIM中。每次在APIM中导入yaml时，即使Yaml文件中的版本号有所不同（除非我们在导入后手动进行修改），Yaml get中的版本号也会重置为1.0。这使人们对云中的哪个版本与本地中的哪个版本感到困惑。因此，如果有人遇到此问题，我正在寻找选择，他们如何解决？我们一直在解决的一种解决方法是在Azure APIM中修改版本时在描述中写出版本号。

Answer 1

您可以创建一个new version of an existing API，然后使用以下更新方法导入更新的OpenAPI规范

此外，您可能已经在做的事情是将git存储库中的OpenAPI规范维护为版本控制，因为它就像任何文件一样。