Agentclouds - Add

Service:

Distributed Task

API Version:

7.1-preview.1

POST https://dev.azure.com/{organization}/_apis/distributedtask/agentclouds?api-version=7.1-preview.1

URI Parameters

Name	In	Required	Type	Description
organization	path	True	string	The name of the Azure DevOps organization.
api-version	query	True	string	Version of the API to use. This should be set to '7.1-preview.1' to use this version of the api.

Request Body

Name	Type	Description
acquireAgentEndpoint	string	Gets or sets a AcquireAgentEndpoint using which a request can be made to acquire new agent
acquisitionTimeout	integer
agentCloudId	integer
getAccountParallelismEndpoint	string
getAgentDefinitionEndpoint	string
getAgentRequestStatusEndpoint	string
id	string
internal	boolean	Signifies that this Agent Cloud is internal and should not be user-manageable
maxParallelism	integer
name	string
releaseAgentEndpoint	string
sharedSecret	string
type	string	Gets or sets the type of the endpoint.

Responses

Name	Type	Description
200 OK	TaskAgentCloud	successful operation

Security

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name	Description
vso.agentpools_manage	Grants the ability to manage pools, queues, and agents

Definitions

TaskAgentCloud

Name	Type	Description
acquireAgentEndpoint	string	Gets or sets a AcquireAgentEndpoint using which a request can be made to acquire new agent
acquisitionTimeout	integer
agentCloudId	integer
getAccountParallelismEndpoint	string
getAgentDefinitionEndpoint	string
getAgentRequestStatusEndpoint	string
id	string
internal	boolean	Signifies that this Agent Cloud is internal and should not be user-manageable
maxParallelism	integer
name	string
releaseAgentEndpoint	string
sharedSecret	string
type	string	Gets or sets the type of the endpoint.