更新时间：2026-01-13 GMT+08:00
批量配置任务委托 - BatchSetAgency
功能介绍
批量配置任务委托，配置后可以使用委托身份进行构建。
调用方法
请参见如何调用API。
授权信息
当前API调用无需身份策略权限。
URI
POST /v1/job/batch-agency
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
job_ids |
是 |
Array of strings |
参数解释： job_ids列表。获取方法：在构建历史列表页面，拷贝浏览器URL中”/detail/history/“之后的32位数字、字母组合的字符串，即为构建任务ID。 约束限制： 32位UUID集合。 取值范围： 构建任务编号。 默认取值： 不涉及。 |
|
agency_urn |
否 |
String |
参数解释： 委托urn，可前往统一身份认证服务 IAM中获取。 约束限制： 不涉及。 取值范围： 默认为空。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
status |
String |
参数解释： 接口响应状态。 取值范围： ● success：表示接口调用成功。 ● fail：表示接口调用失败。 |
|
error |
Object |
参数解释： 错误信息。 取值范围： 不涉及。 |
|
result |
String |
参数解释： 调用接口成功后返回的数据。 取值范围： 不涉及。 |
请求示例
POST https://{endpoint}/v1/job/batch-agency
{
"job_ids" : [ "436ab57485c94629b60d5c5fb02cb037", "34b1146d863044b6ade25d527169330d" ],
"agency_urn" : "iam::60021bab32fd450aa2cb89226f425e06:agency:build_admin_trust"
}
响应示例
状态码：200
OK
{
"status" : "success"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。
