rest - REST API GROUP 版本控制

Question

有人知道 REST API 中的组版本控制是什么吗？我在下面找到了解释它的链接，但我不明白如何使用它。

我在寻找：

1. 如何跨多个端点配置组版本？
2. 有人可以提供它的实际例子吗？

Github 微软 API 指南

Answer 1

尽管是白话，但组版本控制实际上只不过是按日期进行版本控制。大多数（如果不是全部）Azure 服务都是以这种方式版本的。您可以选择是否要按数字或日期进行版本 - 这两种最常见的格式。按组（例如日期）进行版本控制对于服务来说很方便。你确切地知道什么时候发布的。随着时间的推移，可能很难跟踪数字版本的部署时间。是否将组映射到某个内部值取决于您，但我会声称它除了复杂性和混乱之外不会给您带来任何东西。如果您使用日期作为版本号，请彻底接受它。

该指南在某种程度上暗示您可以将不同的次要版本映射到单个组（例如日期）；那可能很危险。通常假设次要版本是向后兼容的；但是，服务永远不应该假设这是真的。服务无法控制客户端及其处理附加内容的能力（例如容错阅读器）。组背后唯一应该做的版本控制是打补丁，它没有可见的有线协议差异。您必须决定是否值得在内部将补丁版本映射到组/日期。

是选择按编号、日期还是两者都选择版本，取决于您。ASP.NET API 版本控制就是这些指南的一种实现方式。它还包括对不再出现在正式 REST 指南中的状态（例如：Beta）的支持。wiki包含深入的细节。

我希望这会有所帮助。