Classification Nodes - Get

Service:

Work Item Tracking

API Version:

7.1-preview.2

取得指定節點路徑的分類節點。

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

With optional parameters:

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

URI 參數

名稱	位於	必要	類型	Description
organization	path	True	string	Azure DevOps 組織的名稱。
project	path	True	string	專案識別碼或專案名稱
structureGroup	path	True	TreeStructureGroup	分類節點、區域或反復專案的結構群組。
path	path		string	分類節點的路徑。
api-version	query	True	string	要使用的 API 版本。 這應該設定為 '7.1-preview.2' 以使用此版本的 API。
$depth	query		integer int32	要擷取的子系深度。

回應

名稱	類型	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

名稱	Description
vso.work	授與讀取工作專案、查詢、面板、區域和反復專案路徑，以及其他工作專案追蹤相關中繼資料的能力。 也授與執行查詢、搜尋工作專案，以及透過服務勾點接收工作專案事件通知的能力。

範例

Get an area

Get an iteration

Get an area

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "id": 126391,
  "identifier": "d5d98099-47ac-468a-9579-c059c90bf7c5",
  "name": "Web",
  "structureType": "area",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "_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"
}

Get an iteration

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "id": 126392,
  "identifier": "dd643523-4d15-4106-a6a4-e70d39a09446",
  "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"
}

定義

名稱	Description
ReferenceLinks	表示 REST 參考連結集合的類別。
TreeNodeStructureType	節點結構類型。
TreeStructureGroup	分類節點、區域或反復專案的結構群組。
WorkItemClassificationNode	定義工作專案追蹤的分類節點。

ReferenceLinks

表示 REST 參考連結集合的類別。

名稱	類型	Description
links	object	連結的唯讀檢視。 因為參考連結是唯讀的，所以我們只想要將它們公開為唯讀。

TreeNodeStructureType

節點結構類型。

名稱	類型	Description
area	string	區欄位型別。
iteration	string	反復專案類型。

TreeStructureGroup

分類節點、區域或反復專案的結構群組。

名稱	類型	Description
areas	string
iterations	string

WorkItemClassificationNode

定義工作專案追蹤的分類節點。

名稱	類型	Description
_links	ReferenceLinks	連結相關 REST 資源的參考。
attributes	object	具有節點屬性的字典，例如反復專案節點的開始/完成日期。
children	WorkItemClassificationNode[]	擷取的子節點清單。
hasChildren	boolean	旗標，指出分類節點是否有任何子節點。
id	integer	分類節點的整數識別碼。
identifier	string	分類節點的 GUID 識別碼。
name	string	分類節點的名稱。
path	string	分類節點的路徑。
structureType	TreeNodeStructureType	節點結構類型。
url	string