对yaml文件进行版本设置的最佳方法是什么？

我正在混合云上做一个API项目。API在本地托管，并通过云服务（Azure API管理服务）向外部世界公开。对于任何API，我们都将在开放API规范中以Yaml文件的形式手动编写合同，然后将其导入Azure APIM。每次在APIM中导入yaml时，yaml get中的版本号都会重置为1.0，即使yaml文件中的版本号有所不同（除非我们在导入后手动修改）。这造成了云中的版本与本地版本之间的混淆。所以，如果有人面临这个问题，我正在寻找一个选择，他们是如何解决的？我们一直在做的一个变通解决方案是在Azure APIM中修改版本时，在描述中写入版本号。

您可以创建一个更新的OpenAPI规范，然后使用下面的更新方法导入更新的OpenAPI规范

另外，您可能已经在做的事情是在

git

存储库中维护OpenAPI规范，以进行版本控制，因为它与任何文件都一样