Classification Nodes - Create Or Update

  • 참조
Service:
Work Item Tracking
API Version:
7.1-preview.2

새로 만들거나 기존 분류 노드를 업데이트합니다.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=7.1-preview.2

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
organization
 path True

string

Azure DevOps 조직의 이름입니다.
project
 path True

string

프로젝트 ID 또는 프로젝트 이름
structureGroup
 path True

TreeStructureGroup

분류 노드, 영역 또는 반복의 구조 그룹입니다.
path
 path

string

분류 노드의 경로입니다.
api-version
 query True

string

사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '7.1-preview.2'로 설정해야 합니다.

요청 본문

Name 형식 Description
_links

ReferenceLinks

관련 REST 리소스에 대한 참조를 연결합니다.
attributes

object

반복 노드의 시작/완료 날짜와 같은 노드 특성이 있는 사전입니다.
children

WorkItemClassificationNode[]

가져온 자식 노드 목록입니다.
hasChildren

boolean

분류 노드에 자식 노드가 있는지를 나타내는 플래그입니다.
id

integer

분류 노드의 정수 ID입니다.
identifier

string

분류 노드의 GUID ID입니다.
name

string

분류 노드의 이름입니다.
path

string

분류 노드의 경로입니다.
structureType

TreeNodeStructureType

노드 구조체 형식입니다.
url

string

응답

Name 형식 Description
200 OK

WorkItemClassificationNode

성공한 작업

보안

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.work_write 작업 항목 및 쿼리를 읽고, 만들고, 업데이트하고, 보드 메타데이터, 읽기 영역 및 반복 경로를 다른 작업 항목이 관련 메타데이터를 추적하고, 쿼리를 실행하고, 서비스 후크를 통해 작업 항목 이벤트에 대한 알림을 받을 수 있는 기능을 부여합니다.

예제

Create an area
Create an iteration
Move an area node
Move an iteration node

Create an area

Sample Request

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=7.1-preview.2

{
  "name": "Web"
}

Sample Response

Status code:
201 
{
  "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

Sample Request

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Iterations?api-version=7.1-preview.2

{
  "name": "Final Iteration",
  "attributes": {
    "startDate": "2014-10-27T00:00:00Z",
    "finishDate": "2014-10-31T00:00:00Z"
  }
}

Sample Response

Status code:
201 
{
  "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

Sample Request

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=7.1-preview.2

{
  "id": 126391
}

Sample Response

Status code:
200 
{
  "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

Sample Request

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/{structureGroup}?api-version=7.1-preview.2

{
  "id": 126392
}

Sample Response

Status code:
200 
{
  "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
ReferenceLinks

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

노드 구조체 형식입니다.
TreeStructureGroup

분류 노드, 영역 또는 반복의 구조 그룹입니다.
WorkItemClassificationNode

작업 항목 추적을 위한 분류 노드를 정의합니다.

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

Name 형식 Description
links

object

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

TreeNodeStructureType

노드 구조체 형식입니다.

Name 형식 Description
area

string

영역 유형입니다.
iteration

string

반복 유형입니다.

TreeStructureGroup

분류 노드, 영역 또는 반복의 구조 그룹입니다.

Name 형식 Description
areas

string

iterations

string

WorkItemClassificationNode

작업 항목 추적을 위한 분류 노드를 정의합니다.

Name 형식 Description
_links

ReferenceLinks

관련 REST 리소스에 대한 참조를 연결합니다.
attributes

object

반복 노드의 시작/완료 날짜와 같은 노드 특성이 있는 사전입니다.
children

WorkItemClassificationNode[]

가져온 자식 노드 목록입니다.
hasChildren

boolean

분류 노드에 자식 노드가 있는지를 나타내는 플래그입니다.
id

integer

분류 노드의 정수 ID입니다.
identifier

string

분류 노드의 GUID ID입니다.
name

string

분류 노드의 이름입니다.
path

string

분류 노드의 경로입니다.
structureType

TreeNodeStructureType

노드 구조체 형식입니다.
url

string