ビルド グループへの割り当て

Groups/{ Group name}/AddAgents API を使用することで、既存のビルドグループ に 1 つまたは複数のAgentを割り当てることができます。

次の場合は 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 ）。

• グループ名は大文字と小文字を区別します。

次の例では、QAビルドグループに3つのAgentを割り当てるリクエストを送信しています。

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 が正常に割り当てられた場合、結果は「"{Agent name}": "OK"」となります。

コマンドの例:

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

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

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

エラーの発生条件

次の場合リクエストは失敗します。

• Agent がビルド実行に参加している場合。

• Agent が存在しない場合。

• Agent がオフラインの場合。

• ビルド グループが存在しない場合。

次の例では 1 つの Agent がオフライン、もう 1 つの Agent は存在していないためエラーが発生しています。

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

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