将 Agent 分配至 Build Group

Groups/{Group name}/AddAgents API 允许您将一个或多个 Agent 分配至现有 Build Group。

如果出现以下情形，您将不能执行 Agent 分配操作：

• Agent 当前正在参与构建执行。

• Agent 已离线。

请求语法

POST https:// {Coordinator IP Address/Hostname}:{Web Access Port}/Groups/{Group name}/AddAgents
[
    {
        "Name":"{Agent name}",

        "IP":"{Agent IP address}
    }
] 

其中:

• Web Access Port 即 Coordinator Settings 对话框中所定义的端口编号（默认为 31100）。

• Group 名称需区分大小写。

如下例所示，发送了一条用于将 Agent 分配至 QA Build Group 的请求：

POST https://win10-1:31100/Groups/QA/AddAgents
[
    {
        "Name":"WIN10-1",

        "IP":"192.100.00.001"
    },

    {
        "Name":"WIN10-2",

        "IP":"192.100.00.002"
    },

    {    
        "Name":"WIN10-3",

        "IP":"192.100.00.003"
    }
]

响应语法

当 Agent 成功分配至指定 Build Group 后，结果应显示为："{Agent name}": "OK"。

例如：

[
    {
        "WIN10-1": "OK"
    },

    {
        "WIN10-2": "OK"
    },

    {
        "WIN10-3": "OK"
    }
]

错误

如果有下列情形，请求将会失败：

• Agent 当前正在参与构建执行。

• Agent 不存在。

• Agent 已离线。

• Build Group 不存在。

如下例所示，一个 Agent 当前处于离线状态，另一 Agent 不存在：

[
    {
        "WIN10-2": "Agent is offline"
    },

    {
        "WIN10-4": "Agent does not exist"
    }
]