Deploymentgroups - Add

참조

서비스:: Distributed Task

API 버전:: 7.1

배포 그룹을 만듭니다.

POST https://dev.azure.com/{organization}/{project}/_apis/distributedtask/deploymentgroups?api-version=7.1

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
organization	path	True	string	Azure DevOps 조직의 이름입니다.
project	path	True	string	프로젝트 ID 또는 프로젝트 이름
api-version	query	True	string	사용할 API의 버전입니다. 이 버전의 API를 사용하려면 '7.1'로 설정해야 합니다.

요청 본문

Name	형식	Description
description	string	배포 그룹에 대한 설명입니다.
name	string	배포 그룹의 이름입니다.
poolId	integer (int32)	배포 에이전트가 등록된 배포 풀의 식별자입니다.

응답

Name	형식	Description
200 OK	DeploymentGroup	성공한 작업

보안

oauth2

형식: oauth2
Flow: accessCode
권한 부여 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
토큰 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

범위

Name	Description
vso.machinegroup_manage	배포 그룹 및 에이전트 풀을 관리하는 기능을 제공합니다.

예제

Create a deployment group

샘플 요청

HTTP

POST https://dev.azure.com/fabrikam/{project}/_apis/distributedtask/deploymentgroups?api-version=7.1

{
  "name": "MyDeploymentGroup1",
  "description": "This deployment group is created to demnostrate the client usage"
}

샘플 응답

상태 코드:: 200

{
  "machineCount": 0,
  "description": "This deployment group is created to demnostrate the client usage",
  "id": 11,
  "project": {
    "id": "91879ed9-819b-46f3-9e0b-52ed4b20c04c",
    "name": "DeploymentGroupRESTSample"
  },
  "name": "MyDeploymentGroup1",
  "pool": {
    "id": 6,
    "scope": "86088ab1-30d8-4526-9663-3406752b8bc6",
    "name": "DeploymentGroupRESTSample-MyDeploymentGroup1",
    "isHosted": false,
    "poolType": "deployment",
    "size": 0
  }
}

정의

Name	Description
Demand
DeploymentGroup	배포 그룹입니다.
DeploymentGroupCreateParameter	배포 그룹을 만드는 속성입니다.
DeploymentMachine	배포 대상입니다.
IdentityRef
JObject	JSON 개체를 나타냅니다.
JToken	추상 JSON 토큰을 나타냅니다.
PackageVersion
ProjectReference
PropertiesCollection	클래스는 키-값 쌍의 컬렉션으로 속성 모음을 나타냅니다. `DBNull` 제외한 모든 기본 형식(`TypeCode != TypeCode.Object`있는 모든 형식)의 값이 허용됩니다. Byte[], Int32, Double, DateType 및 String 형식의 값은 해당 형식을 유지하며, 다른 기본 형식은 문자열로 다시 조정됩니다. Byte[]가 base64로 인코딩된 문자열로 필요합니다.
ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
TaskAgent	작업 에이전트입니다.
TaskAgentAuthorization	OAuth 2.0 인증 흐름을 사용하여 에이전트에 권한을 부여하는 데 필요한 데이터를 제공합니다.
TaskAgentCloudRequest
TaskAgentJobRequest	에이전트에 대한 작업 요청입니다.
TaskAgentPoolOptions	추가 풀 설정 및 세부 정보
TaskAgentPoolReference
TaskAgentPoolType	풀의 형식을 가져오거나 설정합니다.
TaskAgentPublicKey	RSA 비대칭 키의 공개 키 부분을 나타냅니다.
TaskAgentReference	에이전트에 대한 참조입니다.
TaskAgentStatus	에이전트가 온라인인지 여부입니다.
TaskAgentUpdate	에이전트 업데이트에 대한 세부 정보입니다.
TaskAgentUpdateReason
TaskAgentUpdateReasonType
TaskOrchestrationOwner
TaskResult	이 요청의 결과입니다.

Demand

Object

Name	형식	Description
name	string
value	string

DeploymentGroup

Object

배포 그룹입니다.

Name	형식	Description
description	string	배포 그룹에 대한 설명입니다.
id	integer (int32)	배포 그룹 식별자입니다.
machineCount	integer (int32)	배포 그룹의 배포 대상 수입니다.
machineTags	string[]	배포 그룹의 모든 배포 대상에 대한 고유 태그 목록입니다.
machines	DeploymentMachine[]	배포 그룹의 배포 대상 목록입니다.
name	string	배포 그룹의 이름입니다.
pool	TaskAgentPoolReference	배포 에이전트가 등록된 배포 풀입니다.
project	ProjectReference	배포 그룹이 속한 프로젝트입니다.

DeploymentGroupCreateParameter

Object

배포 그룹을 만드는 속성입니다.

Name	형식	Description
description	string	배포 그룹에 대한 설명입니다.
name	string	배포 그룹의 이름입니다.
poolId	integer (int32)	배포 에이전트가 등록된 배포 풀의 식별자입니다.

DeploymentMachine

Object

배포 대상입니다.

Name	형식	Description
agent	TaskAgent	배포 에이전트.
id	integer (int32)	배포 대상 식별자입니다.
properties	PropertiesCollection	배포 대상의 속성입니다.
tags	string[]	배포 대상의 태그입니다.

IdentityRef

Object

Name	형식	Description
_links	ReferenceLinks	이 필드에는 그래프 제목에 대한 0개 이상의 흥미로운 링크가 포함되어 있습니다. 이러한 링크를 호출하여 이 그래프 제목에 대한 추가 관계 또는 자세한 정보를 얻을 수 있습니다.
descriptor	string	설명자는 시스템이 실행되는 동안 그래프 제목을 참조하는 기본 방법입니다. 이 필드는 계정과 조직 모두에서 동일한 그래프 제목을 고유하게 식별합니다.
directoryAlias	string	사용되지 않음 - IdentityRef "_links" 사전의 "자체" 항목에서 참조된 Graph 사용자를 쿼리하여 검색할 수 있습니다.
displayName	string	그래프 주체의 고유하지 않은 표시 이름입니다. 이 필드를 변경하려면 원본 공급자에서 해당 값을 변경해야 합니다.
id	string
imageUrl	string	사용되지 않음 - IdentityRef "_links" 사전의 "아바타" 항목에서 사용할 수 있습니다.
inactive	boolean	사용되지 않음 - GraphUser "_links" 사전의 "membershipState" 항목에서 참조되는 Graph 멤버 자격 상태를 쿼리하여 검색할 수 있습니다.
isAadIdentity	boolean	사용되지 않음 - 설명자의 주체 형식(Descriptor.IsAadUserType/Descriptor.IsAadGroupType)에서 유추할 수 있습니다.
isContainer	boolean	사용되지 않음 - 설명자의 주체 형식에서 유추할 수 있음(Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	사용되지 않음 - ToIdentityRef의 기존 구현에서 사용되지 않음
uniqueName	string	사용되지 않음 - 대신 Domain+PrincipalName 사용
url	string	이 URL은 이 그래프 주체의 원본 리소스에 대한 전체 경로입니다.

JObject

Object

JSON 개체를 나타냅니다.

Name	형식	Description
item	JToken	추상 JSON 토큰을 나타냅니다.
type	string (JTokenType)	이 JToken의 노드 형식을 가져옵니다.

JToken

Object

추상 JSON 토큰을 나타냅니다.

Name	형식	Description
first	JToken	이 토큰의 첫 번째 자식 토큰을 가져옵니다.
hasValues	boolean	이 토큰에 자식 토큰이 있는지 여부를 나타내는 값을 가져옵니다.
item	JToken	추상 JSON 토큰을 나타냅니다.
last	JToken	이 토큰의 마지막 자식 토큰을 가져옵니다.
next	JToken	이 노드의 다음 형제 토큰을 가져옵니다.
parent	string (JContainer)	부모를 가져오거나 설정합니다.
path	string	JSON 토큰의 경로를 가져옵니다.
previous	JToken	이 노드의 이전 형제 토큰을 가져옵니다.
root	JToken	이 JToken의 루트 JToken을 가져옵니다.
type	string (JTokenType)	이 JToken의 노드 형식을 가져옵니다.

PackageVersion

Object

Name	형식	Description
major	integer (int32)
minor	integer (int32)
patch	integer (int32)

ProjectReference

Object

Name	형식	Description
id	string (uuid)
name	string

PropertiesCollection

Object

클래스는 키-값 쌍의 컬렉션으로 속성 모음을 나타냅니다. DBNull 제외한 모든 기본 형식(TypeCode != TypeCode.Object있는 모든 형식)의 값이 허용됩니다. Byte[], Int32, Double, DateType 및 String 형식의 값은 해당 형식을 유지하며, 다른 기본 형식은 문자열로 다시 조정됩니다. Byte[]가 base64로 인코딩된 문자열로 필요합니다.

Name	형식	Description
count	integer (int32)	컬렉션의 속성 수입니다.
item	object
keys	string[]	컬렉션의 키 집합입니다.
values	string[]	컬렉션의 값 집합입니다.

ReferenceLinks

Object

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

Name	형식	Description
links	object	링크의 읽기 전용 보기입니다. 참조 링크는 읽기 전용이므로 읽기 전용으로만 노출하려고 합니다.

TaskAgent

Object

작업 에이전트입니다.

Name	형식	Description
_links	ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
accessPoint	string	이 에이전트의 액세스 지점입니다.
assignedAgentCloudRequest	TaskAgentCloudRequest	현재 이 에이전트와 연결된 에이전트 클라우드 요청입니다.
assignedRequest	TaskAgentJobRequest	현재 이 에이전트에 할당된 요청입니다.
authorization	TaskAgentAuthorization	이 에이전트에 대한 권한 부여 정보입니다.
createdOn	string (date-time)	이 에이전트를 만든 날짜입니다.
enabled	boolean	이 에이전트가 작업을 실행해야 하는지 여부입니다.
id	integer (int32)	에이전트의 식별자입니다.
lastCompletedRequest	TaskAgentJobRequest	이 에이전트에 의해 완료된 마지막 요청입니다.
maxParallelism	integer (int32)	이 에이전트에 허용되는 최대 작업 병렬 처리입니다.
name	string	에이전트의 이름입니다.
osDescription	string	에이전트 OS.
pendingUpdate	TaskAgentUpdate	이 에이전트에 대한 보류 중인 업데이트입니다.
properties	PropertiesCollection	클래스는 키-값 쌍의 컬렉션으로 속성 모음을 나타냅니다. `DBNull` 제외한 모든 기본 형식(`TypeCode != TypeCode.Object`있는 모든 형식)의 값이 허용됩니다. Byte[], Int32, Double, DateType 및 String 형식의 값은 해당 형식을 유지하며, 다른 기본 형식은 문자열로 다시 조정됩니다. Byte[]가 base64로 인코딩된 문자열로 필요합니다.
provisioningState	string	이 에이전트의 프로비전 상태입니다.
status	TaskAgentStatus	에이전트가 온라인인지 여부입니다.
statusChangedOn	string (date-time)	마지막 연결 상태가 변경된 날짜입니다.
systemCapabilities	object	이 에이전트의 호스트에서 지원하는 시스템 정의 기능입니다. 경고: PUT 메서드를 사용하여 기능을 설정하려면 PUT에서 기존 기능을 완전히 덮어씁 수 있습니다.
userCapabilities	object	이 에이전트의 호스트에서 지원하는 사용자 정의 기능입니다. 경고: PUT 메서드를 사용하여 기능을 설정하려면 PUT에서 기존 기능을 완전히 덮어씁 수 있습니다.
version	string	에이전트 버전입니다.

TaskAgentAuthorization

Object

OAuth 2.0 인증 흐름을 사용하여 에이전트에 권한을 부여하는 데 필요한 데이터를 제공합니다.

Name	형식	Description
authorizationUrl	string	구성된 토큰 서비스에서 액세스 토큰을 가져오는 데 사용되는 엔드포인트입니다.
clientId	string (uuid)	이 에이전트의 클라이언트 식별자입니다.
publicKey	TaskAgentPublicKey	이 에이전트의 ID를 확인하는 데 사용되는 공개 키입니다.

TaskAgentCloudRequest

Object

Name	형식	Description
agent	TaskAgentReference	에이전트에 대한 참조입니다.
agentCloudId	integer (int32)
agentConnectedTime	string (date-time)
agentData	JObject	JSON 개체를 나타냅니다.
agentSpecification	JObject	JSON 개체를 나타냅니다.
pool	TaskAgentPoolReference
provisionRequestTime	string (date-time)
provisionedTime	string (date-time)
releaseRequestTime	string (date-time)
requestId	string (uuid)

TaskAgentJobRequest

Object

에이전트에 대한 작업 요청입니다.

Name	형식	Description
agentSpecification	JObject	JSON 개체를 나타냅니다.
assignTime	string (date-time)	이 요청이 할당된 날짜/시간입니다.
data	object	요청에 대한 추가 데이터입니다.
definition	TaskOrchestrationOwner	이 요청과 연결된 파이프라인 정의
demands	Demand[]	이 요청을 수행하는 데 필요한 요구 목록입니다.
finishTime	string (date-time)	이 요청이 완료된 날짜/시간입니다.
hostId	string (uuid)	이 요청을 트리거한 호스트입니다.
jobId	string (uuid)	이 요청에서 생성된 작업의 ID입니다.
jobName	string	이 요청에서 생성된 작업의 이름입니다.
lockedUntil	string (date-time)	에이전트가 잠금을 갱신할 최종 기한입니다.
matchedAgents	TaskAgentReference[]	에이전트에 대한 참조입니다.
matchesAllAgentsInPool	boolean
orchestrationId	string
owner	TaskOrchestrationOwner	이 요청과 연결된 파이프라인
planGroup	string
planId	string (uuid)	이 요청과 연결된 오케스트레이션 계획의 내부 ID입니다.
planType	string	오케스트레이션 계획의 유형을 나타내는 내부 세부 정보입니다.
poolId	integer (int32)	이 요청이 대상으로 하는 풀의 ID
priority	integer (int32)
queueId	integer (int32)	이 요청이 대상으로 하는 큐의 ID
queueTime	string (date-time)	이 요청이 큐에 대기된 날짜/시간입니다.
receiveTime	string (date-time)	이 요청이 에이전트에 의해 회수된 날짜/시간입니다.
requestId	integer (int64)	요청의 ID입니다.
reservedAgent	TaskAgentReference	이 요청에 할당된 에이전트입니다.
result	TaskResult	이 요청의 결과입니다.
scopeId	string (uuid)	파이프라인의 범위입니다. 는 프로젝트 ID와 일치합니다.
serviceOwner	string (uuid)	이 요청을 소유하는 서비스입니다.
statusMessage	string
userDelayed	boolean

TaskAgentPoolOptions

열거형

추가 풀 설정 및 세부 정보

값	Description
elasticPool	탄력적 풀 서비스에서 지원되는 TaskAgentPool
none
preserveAgentOnJobFailure	TaskAgentJobRequest 실패 후 에이전트가 조사를 위해 유지되는 경우 true로 설정
singleUseAgents	각 TaskAgentJobRequest 이후 에이전트가 다시 이미지화되는 경우 true로 설정

TaskAgentPoolReference

Object

Name	형식	Description
id	integer (int32)
isHosted	boolean	이 풀이 서비스에서 관리되는지 여부를 나타내는 값을 가져오거나 설정합니다.
isLegacy	boolean	풀이 레거시인지 여부를 확인합니다.
name	string
options	TaskAgentPoolOptions	추가 풀 설정 및 세부 정보
poolType	TaskAgentPoolType	풀의 형식을 가져오거나 설정합니다.
scope	string (uuid)
size	integer (int32)	풀의 현재 크기를 가져옵니다.

TaskAgentPoolType

열거형

풀의 형식을 가져오거나 설정합니다.

값	Description
automation	일반적인 작업 에이전트 풀
deployment	배포 풀

TaskAgentPublicKey

Object

RSA 비대칭 키의 공개 키 부분을 나타냅니다.

Name	형식	Description
exponent	string[] (byte)	공개 키의 지수를 가져오거나 설정합니다.
modulus	string[] (byte)	공개 키의 모듈러스를 가져오거나 설정합니다.

TaskAgentReference

Object

에이전트에 대한 참조입니다.

Name	형식	Description
_links	ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
accessPoint	string	이 에이전트의 액세스 지점입니다.
enabled	boolean	이 에이전트가 작업을 실행해야 하는지 여부입니다.
id	integer (int32)	에이전트의 식별자입니다.
name	string	에이전트의 이름입니다.
osDescription	string	에이전트 OS.
provisioningState	string	이 에이전트의 프로비전 상태입니다.
status	TaskAgentStatus	에이전트가 온라인인지 여부입니다.
version	string	에이전트 버전입니다.

TaskAgentStatus

열거형

에이전트가 온라인인지 여부입니다.

값	Description
offline
online

TaskAgentUpdate

Object

에이전트 업데이트에 대한 세부 정보입니다.

Name	형식	Description
currentState	string	이 에이전트 업데이트의 현재 상태입니다.
reason	TaskAgentUpdateReason	이 업데이트의 이유입니다.
requestTime	string (date-time)	이 업데이트가 요청된 날짜입니다.
requestedBy	IdentityRef	이 업데이트를 요청한 ID입니다.
sourceVersion	PackageVersion	업데이트의 원본 에이전트 버전입니다.
targetVersion	PackageVersion	업데이트의 대상 에이전트 버전입니다.

TaskAgentUpdateReason

Object

Name	형식	Description
code	TaskAgentUpdateReasonType

TaskAgentUpdateReasonType

열거형

값	Description
downgrade
manual
minAgentVersionRequired

TaskOrchestrationOwner

Object

Name	형식	Description
_links	ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
id	integer (int32)
name	string

TaskResult

열거형

이 요청의 결과입니다.

값	Description
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues

다음을 통해 공유

Deploymentgroups - Add

URI 매개 변수

요청 본문

응답

보안

oauth2

범위

예제

Create a deployment group

샘플 요청

샘플 응답

정의

Demand

DeploymentGroup

DeploymentGroupCreateParameter

DeploymentMachine

IdentityRef

JObject

JToken

PackageVersion

ProjectReference

PropertiesCollection

ReferenceLinks

TaskAgent

TaskAgentAuthorization

TaskAgentCloudRequest

TaskAgentJobRequest

TaskAgentPoolOptions

TaskAgentPoolReference

TaskAgentPoolType

TaskAgentPublicKey

TaskAgentReference

TaskAgentStatus

TaskAgentUpdate

TaskAgentUpdateReason

TaskAgentUpdateReasonType

TaskOrchestrationOwner

TaskResult