azure-devops-rest-api - Azure-devops rest api - 分页和速率限制

Question

我正在尝试提取 Azure-Devops 实体数据(团队、项目、存储库、成员等...)并在本地处理该数据，我找不到任何关于速率限制和分页的文档，有没有人有这方面的经验？

成员 api 上有一些关于分页的文档:
https://learn.microsoft.com/en-us/rest/api/azure/devops/memberentitlementmanagement/members/get?view=azure-devops-rest-6.0

但这是唯一的，我找不到任何 git 实体的文档，
例如:存储库。
https://learn.microsoft.com/en-us/rest/api/azure/devops/git/repositories/list?view=azure-devops-rest-6.0

如果有人可以向我指出正确的文档，或者阐明这些主题会很棒。

谢谢。

Answer 1

I cannot find any documentation regarding rate-limiting and pagination, does anyone has any experience with that?

有一个关于Service limits and rate limits的文档，它引入了所有项目和组织都要遵守的服务限制和速率限制。

对于速率限制:

Azure DevOps Services, like many Software-as-a-Service solutions, usesmulti-tenancy to reduce costs and to enhance scalability andperformance. This leaves users vulnerable to performance issues andeven outages when other users of their shared resources have spikes intheir consumption. To combat these problems, Azure DevOps Serviceslimits the resources individuals can consume and the number ofrequests they can make to certain commands. When these limits areexceeded, subsequent requests may be either delayed or blocked.

您可以引用Rate limits documentation详情

对于分页，一般来说，REST API 会有分页响应，而 ADO REST API 通常限制每个响应中每页 100/200(取决于哪个 API)。检索下一页信息的方法是引用响应 header x-ms-continuationtoken 并将其用作下一个请求参数作为 continuationToken。

但是 Microsoft 没有很好地记录这一点 - 这应该在支持 continuation token 的每个 API 调用中提到:

Builds - List :

GET https://dev.azure.com/{organization}/{project}/_apis/build/builds?definitions={definitions}&continuationToken={continuationToken}&maxBuildsPerDefinition={maxBuildsPerDefinition}&deletedFilter={deletedFilter}&queryOrder={queryOrder}&branchName={branchName}&buildIds={buildIds}&repositoryId={repositoryId}&repositoryType={repositoryType}&api-version=5.1

如果我将上面的 REST API 与 $top=50 一起使用，正如预期的那样，我得到了 50 和一个名为“x-ms-continuationtoken”的 header ，那么我们可以用continuationtoken循环输出结果:

你可以检查这个similar thread了解更多详情。