共用方式為


Classification Nodes - Get

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

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

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 版本。 這應該設定為 '5.0' 以使用此版本的 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

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

Sample Response

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

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

Sample Response

{
  "id": 126392,
  "identifier": "dd643523-4d15-4106-a6a4-e70d39a09446",
  "name": "Final Iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "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

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

表示 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

分類節點的名稱。

structureType

TreeNodeStructureType

節點結構類型。

url

string