共用方式為

Classification Nodes - Get

  • 參考
服務:
Work Item Tracking
API 版本:
7.1

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

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=7.1
含選擇性參數: 
GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?$depth={$depth}&api-version=7.1

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』 以使用此版本的 API。
$depth
 query

integer (int32)

要擷取的子系深度。

回應

名稱 類型 Description
200 OK

WorkItemClassificationNode

成功作業

安全性

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

範圍

名稱 Description
vso.work 授與讀取工作項目、查詢、面板、區域和反覆項目路徑，以及其他工作專案追蹤相關元數據的能力。 同時授與執行查詢、搜尋工作專案，以及透過服務攔截接收工作專案事件的通知的能力。

範例

Get an area
Get an iteration

Get an area

範例要求

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

範例回覆

狀態碼:
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

範例要求

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

範例回覆

狀態碼:
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

定義工作項目追蹤的分類節點。
Object

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

名稱 類型 Description
links

object

連結的只讀檢視。 因為參考連結是只讀的，所以我們只想要將其公開為只讀。

TreeNodeStructureType

列舉型別

節點結構類型。

值 Description
area

區域類型。
iteration

反覆項目類型。

TreeStructureGroup

列舉型別

分類節點、區域或反覆項目的結構群組。

值 Description
areas
iterations

WorkItemClassificationNode

Object

定義工作項目追蹤的分類節點。

名稱 類型 Description
_links

ReferenceLinks

連結相關 REST 資源的參考。
attributes

object

具有節點屬性的字典，例如反覆運算節點的開始/完成日期。
children

WorkItemClassificationNode[]

擷取的子節點清單。
hasChildren

boolean

旗標，指出分類節點是否有任何子節點。
id

integer (int32)

分類節點的整數標識碼。
identifier

string (uuid)

分類節點的 GUID 識別碼。
name

string

分類節點的名稱。
path

string

分類節點的路徑。
structureType

TreeNodeStructureType

節點結構類型。
url

string