调用Azure DevOps API创建自托管池遇Pool参数空值错误及配置问题

问题重现 #

用PowerShell CLI调用Azure DevOps官方API，尝试创建关联已预配VM Scale Set的自托管代理池时，执行脚本返回错误：

Value cannot be null.
Parameter name: pool

但官方文档中并未提及pool这个必填参数。

排查过程 #

• 测试不含scope参数的极简请求：成功创建了组织级代理池，但这类池无法关联VM Scale Set，不符合需求。
• 为创建项目级代理池添加scope参数后，直接触发上述pool为空的错误，且官方文档未明确scope的有效值范围，尝试多种格式的值均无效。
• 进一步验证发现：普通代理池的API接口本身不支持配置服务连接和VM Scale Set关联，这是核心限制。

正确解决方案 #

必须通过**弹性代理池（Elastic Pool）**的专属API来完成配置，具体步骤：

1. 调用弹性池创建API时，在请求体中明确指定VM Scale Set的资源ID、对应的Azure服务连接ID、自动缩放规则等参数，确保池与VMSS绑定。
2. 弹性池创建完成后，将其关联到目标项目的Agent_Queue，实现项目级的代理池使用权限控制。

内容的提问来源于stack exchange，提问作者Ryu S.