AgentPool
An agent pool that is the group of agents with shared permissions and available projects.
Related Help article: Agent Pool
tip
Data type:
integer
Example:31
The unique ID of this pool. The Default pool has the ID value of 0.
tip
Data type:
string
Example:Kubernetes
The public name of the pool.
tip
Data type:
string
Example:/app/rest/agentPools/id:82
Returns the shortened (without the server URL) link to the current pool.
tip
Data type:
integer
Example:10
The pool capacity. Returns null for pools with the unlimited number of agent slots.
tip
Data type:
Project
Example:
Returns the corresponding project for project pool. A project pool is an automatically created agent pool for cloud agents spawned from cloud images that belong to this (non-Root) project. These agents can run builds of the corresponding project only.
Regular (non-project) pools return null.
tip
Data type:
Projects
Example:
Returns the list of projects assigned to this pool. Pool agents can run builds of these assigned projects only.
Send POST
and DELETE
requests to the /app/rest/agentPools/{poolLocator}/projects
endpoint to change the list of projects assigned to this pool.
tip
Data type:
Agents
Example:
The list of agents owned by this pool.
Send POST
requests to the /app/rest/agentPools/{agentPoolLocator}/agents
endpoint to add agents to the required pool. To remove an agent from the specific pool, add this agent to the Default (id:0) pool.
tip
Data type:
string
Example:
tip
Data type:
AgentTypes
Example:
Below, you can find a full schema of this object, in XML and JSON formats. You can choose what fields to submit depending on your current needs. Different methods might expect different fields: the best approach is to request this entity via GET
and use the response as a base for the following POST
request.
A link to another object implies that you can substitute it with the schema of the linked object, if it is required for your call.
<agentPool href="/app/rest/agentPools/id:82" id="31" locator="string" maxAgents="10" name="Kubernetes">
<ownerProject archived="true" description="string" href="string" id="string" internalId="string" locator="string" name="string" parentProjectId="string" parentProjectInternalId="string" parentProjectName="string" uuid="string" virtual="true" webUrl="string">
<links>links...</links>
<parentProject>project...</parentProject>
<readOnlyUI>StateField...</readOnlyUI>
<defaultTemplate>buildType...</defaultTemplate>
<buildTypes>buildTypes...</buildTypes>
<templates>buildTypes...</templates>
<deploymentDashboards>deploymentDashboards...</deploymentDashboards>
<parameters>properties...</parameters>
<vcsRoots>vcs-roots...</vcsRoots>
<projectFeatures>projectFeatures...</projectFeatures>
<projects>projects...</projects>
<cloudProfiles>cloudProfiles...</cloudProfiles>
<ancestorProjects>projects...</ancestorProjects>
</ownerProject>
<projects count="123" href="string" nextHref="string" prevHref="string">
<project>project...</project>
</projects>
<agents count="7" href="/app/rest/agents" nextHref="/app/rest/agents?locator=count:200,start:250" prevHref="/app/rest/agents?locator=count:50,start:0">
<agent>agent...</agent>
</agents>
<agentTypes count="1" href="/app/rest/agentTypes" nextHref="/app/rest/agentTypes?locator=count:200,start:250" prevHref="/app/rest/agentTypes?locator=count:50,start:0">
<agentType>agentType...</agentType>
</agentTypes>
</agentPool>
{
"projects" : {
"count" : 1,
"project" : [ "project..." ],
"prevHref" : "prevHref",
"href" : "href",
"nextHref" : "nextHref"
},
"maxAgents" : 10,
"ownerProject" : {
"virtual" : true,
"parentProjectName" : "parentProjectName",
"vcsRoots" : {
"count" : 0,
"vcs-root" : [ "vcs-root..." ],
"prevHref" : "prevHref",
"href" : "href",
"nextHref" : "nextHref"
},
"projects" : {
"count" : 1,
"project" : [ "project..." ],
"prevHref" : "prevHref",
"href" : "href",
"nextHref" : "nextHref"
},
"defaultTemplate" : {
"template" : "buildType...",
"paused" : true,
"description" : "description",
"project" : "project...",
"investigations" : "investigations...",
"templateFlag" : true,
"type" : "regular",
"uuid" : "uuid",
"projectInternalId" : "projectInternalId",
"internalId" : "internalId",
"features" : "features...",
"builds" : "builds...",
"links" : "links...",
"id" : "id",
"href" : "href",
"compatibleCloudImages" : "cloudImages...",
"settings" : "properties...",
"vcsRootInstances" : "vcs-root-instances...",
"templates" : "buildTypes...",
"artifact-dependencies" : "artifact-dependencies...",
"compatibleAgents" : "agents...",
"pauseComment" : "comment...",
"triggers" : "triggers...",
"branches" : "branches...",
"steps" : "steps...",
"externalStatusAllowed" : true,
"agent-requirements" : "agent-requirements...",
"webUrl" : "webUrl",
"inherited" : true,
"snapshot-dependencies" : "snapshot-dependencies...",
"name" : "name",
"vcs-root-entries" : "vcs-root-entries...",
"projectName" : "projectName",
"projectId" : "projectId",
"parameters" : "properties...",
"locator" : "locator"
},
"description" : "description",
"uuid" : "uuid",
"parentProjectInternalId" : "parentProjectInternalId",
"cloudProfiles" : {
"count" : 8,
"prevHref" : "prevHref",
"href" : "href",
"cloudProfile" : [ "cloudProfile..." ],
"nextHref" : "nextHref"
},
"internalId" : "internalId",
"archived" : true,
"parentProjectId" : "parentProjectId",
"deploymentDashboards" : {
"count" : 3,
"deploymentDashboard" : [ "deploymentDashboard..." ],
"prevHref" : "prevHref",
"href" : "href",
"nextHref" : "nextHref"
},
"links" : {
"count" : 8,
"link" : [ "link..." ]
},
"id" : "id",
"href" : "href",
"parentProject" : {
"virtual" : true,
"parentProjectName" : "parentProjectName",
"vcsRoots" : "vcs-roots...",
"projects" : "projects...",
"defaultTemplate" : "buildType...",
"description" : "description",
"uuid" : "uuid",
"parentProjectInternalId" : "parentProjectInternalId",
"cloudProfiles" : "cloudProfiles...",
"internalId" : "internalId",
"archived" : true,
"parentProjectId" : "parentProjectId",
"deploymentDashboards" : "deploymentDashboards...",
"links" : "links...",
"id" : "id",
"href" : "href",
"parentProject" : "project...",
"templates" : "buildTypes...",
"readOnlyUI" : "StateField...",
"webUrl" : "webUrl",
"buildTypes" : "buildTypes...",
"name" : "name",
"ancestorProjects" : "projects...",
"parameters" : "properties...",
"projectFeatures" : "projectFeatures...",
"locator" : "locator"
},
"templates" : {
"buildType" : [ "buildType..." ],
"count" : 4,
"prevHref" : "prevHref",
"href" : "href",
"nextHref" : "nextHref"
},
"readOnlyUI" : {
"inherited" : true,
"value" : true
},
"webUrl" : "webUrl",
"buildTypes" : {
"buildType" : [ "buildType..." ],
"count" : 4,
"prevHref" : "prevHref",
"href" : "href",
"nextHref" : "nextHref"
},
"name" : "name",
"ancestorProjects" : {
"count" : 1,
"project" : [ "project..." ],
"prevHref" : "prevHref",
"href" : "href",
"nextHref" : "nextHref"
},
"parameters" : {
"count" : 1,
"property" : [ {
"inherited" : true,
"name" : "name",
"type" : "type...",
"value" : "value"
} ],
"href" : "href"
},
"projectFeatures" : {
"projectFeature" : [ "projectFeature..." ],
"count" : 2,
"href" : "href"
},
"locator" : "locator"
},
"name" : "Kubernetes",
"id" : 31,
"href" : "/app/rest/agentPools/id:82",
"locator" : "locator",
"agents" : {
"agent" : [ "agent..." ],
"count" : 7,
"prevHref" : "/app/rest/agents?locator=count:50,start:0",
"href" : "/app/rest/agents",
"nextHref" : "/app/rest/agents?locator=count:200,start:250"
},
"agentTypes" : {
"agentType" : [ "agentType..." ],
"count" : 1,
"prevHref" : "/app/rest/agentTypes?locator=count:50,start:0",
"href" : "/app/rest/agentTypes",
"nextHref" : "/app/rest/agentTypes?locator=count:200,start:250"
}
}
Thanks for your feedback!