c# - 如何指定API版本？

Question

根据Azure DevOps Services REST API Reference ，请求 URI 的格式如下:

https://{instance}[/{team-project}]/_apis[/{area}]/{resource}?api-version={version}

关于api版本:

Every API request should include an api-version to avoid having your app or service break as APIs evolve.

我开始使用 .NET client libraries for Azure DevOps Services (and TFS)以编程方式管理仪表板。

我能够使用个人访问 token 连接到 Azure DevOps:

var credential = new VssBasicCredential(string.Empty, "PersonalAccessToken");

using (VssConnection connection = new VssConnection(new Uri("...."), credential))
using (var client = connection.GetClient<DashboardHttpClient>())
{
     // ...
}

如何指定 API 版本？当使用 .NET client libraries 时，这样做仍然有意义吗？ ？

Answer 1

API版本由客户端库决定。您可以通过反汇编它们来确认这一点(例如使用 ILSpy)。

例如，在 Microsoft.TeamFoundationServer.Client 的当前稳定版本中，DashboardHttpClientBase 有一个 CreateDashboardAsnc 方法，该方法进行以下调用:

this.SendAsync<Dashboard>(..., new ApiResourceVersion("4.1-preview.2"), ...);