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

我找不到任何关于速率限制和分页的文档，有人有这方面的经验吗？

有一个关于服务限额和费率限制的文档，它引入了所有项目和组织都必须遵守的服务限制和费率限制。

关于限速：

Azure DevOps服务和许多软件即服务解决方案一样，使用多租户来降低成本，并提高可伸缩性和性能。这使得用户很容易受到性能问题的影响，甚至在共享资源的其他用户的消耗急剧增加时也会出现中断。为了解决这些问题，Azure DevOps服务限制了个人可以使用的资源和对某些命令的请求数量。当超出这些限制时，随后的请求可能会被延迟或阻止。

您可以参考费率限制文件获得详细信息

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

但微软并没有很好地记录这一点--在支持延续令牌的每个API调用中都应该提到这一点：

构建-列表：

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

如果我在$top=50中使用上面的REST，如预期的那样，我会得到50个返回和一个名为"x-ms-continuationtoken“的标题，那么我们可以用continuationtoken循环输出结果。

​

​

您可以查看此相似螺纹以获得更多详细信息。

Answer 2

我认为对于大多数apis来说，查询参数都是$top/$apis，您可以使用这些参数进行分页。假设默认运行在响应中提供200个文档。在下一次运行中，通过在请求的查询参数中提供$skip=200来跳过这200条以获得接下来的200条。您可以继续迭代，直到响应的count属性变为0。

对于那些apis，您没有这些参数，可以使用Liu MSFT中提到的延续令牌。

Answer 3

看起来你可以通过$top和continuationToken来列出Azure参考文献。

文件如下：

https://learn.microsoft.com/en-us/rest/api/azure/devops/git/refs/list?view=azure-devops-rest-6.0