Classification Nodes - Create Or Update
새로 만들거나 기존 분류 노드를 업데이트합니다.
POST https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=7.1URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Azure DevOps 조직의 이름입니다. |
|
project
|
path | True |
string |
프로젝트 ID 또는 프로젝트 이름 |
|
structure
|
path | True |
분류 노드, 영역 또는 반복의 구조 그룹입니다. |
|
|
path
|
path |
string |
분류 노드의 경로입니다. |
|
|
api-version
|
query | True |
string |
사용할 API의 버전입니다. 이 버전의 API를 사용하려면 '7.1'로 설정해야 합니다. |
요청 본문
| Name | 형식 | Description |
|---|---|---|
| _links |
관련 REST 리소스에 대한 참조를 연결합니다. |
|
| attributes |
object |
반복 노드의 시작/완료 날짜와 같은 노드 특성이 있는 사전입니다. |
| children |
가져온 자식 노드 목록입니다. |
|
| hasChildren |
boolean |
분류 노드에 자식 노드가 있는지를 나타내는 플래그입니다. |
| id |
integer (int32) |
분류 노드의 정수 ID입니다. |
| identifier |
string (uuid) |
분류 노드의 GUID ID입니다. |
| name |
string |
분류 노드의 이름입니다. |
| path |
string |
분류 노드의 경로입니다. |
| structureType |
노드 구조체 형식입니다. |
|
| url |
string |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
성공한 작업 |
보안
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.work_write | 작업 항목 및 쿼리를 읽고, 만들고, 업데이트하고, 보드 메타데이터, 읽기 영역 및 반복 경로를 다른 작업 항목 추적 관련 메타데이터, 쿼리 실행 및 서비스 후크를 통해 작업 항목 이벤트에 대한 알림을 받을 수 있는 기능을 부여합니다. |
예제
| Create an area |
| Create an iteration |
| Move an area node |
| Move an iteration node |
Create an area
샘플 요청
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=7.1
{
"name": "Web"
}
샘플 응답
{
"id": 126391,
"identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
"name": "Web",
"structureType": "area",
"hasChildren": false,
"path": "\\fabrikam\\fiber\\tfvc\\area",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Web"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Web"
}Create an iteration
샘플 요청
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Iterations?api-version=7.1
{
"name": "Final Iteration",
"attributes": {
"startDate": "2014-10-27T00:00:00Z",
"finishDate": "2014-10-31T00:00:00Z"
}
}
샘플 응답
{
"id": 126392,
"identifier": "8dbed14a-c1b6-46e8-8540-8118c4ea29ae",
"name": "Final Iteration",
"structureType": "iteration",
"hasChildren": false,
"path": "\\fabrikam\\fiber\\tfvc\\iteration",
"attributes": {
"startDate": "2014-10-27T00:00:00Z",
"finishDate": "2014-10-31T00:00:00Z"
},
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Final%20Iteration"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Final%20Iteration"
}Move an area node
샘플 요청
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=7.1
{
"id": 126391
}
샘플 응답
{
"id": 126391,
"identifier": "d01a1947-781a-4328-95be-960b90d04fe3",
"name": "Website team",
"structureType": "area",
"hasChildren": false,
"path": "\\fabrikam\\fiber\\tfvc\\area",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area/Website%20team"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area/Website%20team"
}Move an iteration node
샘플 요청
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/{structureGroup}?api-version=7.1
{
"id": 126392
}
샘플 응답
{
"id": 126392,
"identifier": "81f373b4-93cb-4c2b-99e6-1308ea5d1adc",
"name": "Ultimate iteration",
"structureType": "iteration",
"hasChildren": false,
"path": "\\fabrikam\\fiber\\tfvc\\iteration",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration/Ultimate%20iteration"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration/Ultimate%20iteration"
}정의
| Name | Description |
|---|---|
|
Reference |
REST 참조 링크의 컬렉션을 나타내는 클래스입니다. |
|
Tree |
노드 구조체 형식입니다. |
|
Tree |
분류 노드, 영역 또는 반복의 구조 그룹입니다. |
|
Work |
작업 항목 추적에 대한 분류 노드를 정의합니다. |
ReferenceLinks
REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
| Name | 형식 | Description |
|---|---|---|
| links |
object |
링크의 읽기 전용 보기입니다. 참조 링크는 읽기 전용이므로 읽기 전용으로만 노출하려고 합니다. |
TreeNodeStructureType
노드 구조체 형식입니다.
| 값 | Description |
|---|---|
| area |
영역 유형입니다. |
| iteration |
반복 유형입니다. |
TreeStructureGroup
분류 노드, 영역 또는 반복의 구조 그룹입니다.
| 값 | Description |
|---|---|
| areas | |
| iterations |
WorkItemClassificationNode
작업 항목 추적에 대한 분류 노드를 정의합니다.
| Name | 형식 | Description |
|---|---|---|
| _links |
관련 REST 리소스에 대한 참조를 연결합니다. |
|
| attributes |
object |
반복 노드의 시작/완료 날짜와 같은 노드 특성이 있는 사전입니다. |
| children |
가져온 자식 노드 목록입니다. |
|
| hasChildren |
boolean |
분류 노드에 자식 노드가 있는지를 나타내는 플래그입니다. |
| id |
integer (int32) |
분류 노드의 정수 ID입니다. |
| identifier |
string (uuid) |
분류 노드의 GUID ID입니다. |
| name |
string |
분류 노드의 이름입니다. |
| path |
string |
분류 노드의 경로입니다. |
| structureType |
노드 구조체 형식입니다. |
|
| url |
string |