Classification Nodes - Get Root Nodes
取得專案底下的根分類節點。
GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes?api-version=7.1
GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes?$depth={$depth}&api-version=7.1
URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Azure DevOps 組織的名稱。 |
|
project
|
path | True |
string |
項目識別碼或項目名稱 |
|
api-version
|
query | True |
string |
要使用的 API 版本。 這應該設定為 『7.1』 以使用此版本的 API。 |
|
$depth
|
query |
integer (int32) |
要擷取的子系深度。 |
回應
| 名稱 | 類型 | 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
範圍
| 名稱 | Description |
|---|---|
| vso.work | 授與讀取工作項目、查詢、面板、區域和反覆項目路徑,以及其他工作專案追蹤相關元數據的能力。 同時授與執行查詢、搜尋工作專案,以及透過服務攔截接收工作專案事件的通知的能力。 |
定義
| 名稱 | Description |
|---|---|
|
Reference |
表示 REST 參考連結集合的類別。 |
|
Tree |
節點結構類型。 |
|
Work |
定義工作項目追蹤的分類節點。 |
ReferenceLinks
表示 REST 參考連結集合的類別。
| 名稱 | 類型 | Description |
|---|---|---|
| links |
object |
連結的只讀檢視。 因為參考連結是只讀的,所以我們只想要將其公開為只讀。 |
TreeNodeStructureType
節點結構類型。
| 值 | Description |
|---|---|
| area |
區域類型。 |
| iteration |
反覆項目類型。 |
WorkItemClassificationNode
定義工作項目追蹤的分類節點。
| 名稱 | 類型 | Description |
|---|---|---|
| _links |
連結相關 REST 資源的參考。 |
|
| attributes |
object |
具有節點屬性的字典,例如反覆運算節點的開始/完成日期。 |
| children |
擷取的子節點清單。 |
|
| hasChildren |
boolean |
旗標,指出分類節點是否有任何子節點。 |
| id |
integer (int32) |
分類節點的整數標識碼。 |
| identifier |
string (uuid) |
分類節點的 GUID 識別碼。 |
| name |
string |
分類節點的名稱。 |
| path |
string |
分類節點的路徑。 |
| structureType |
節點結構類型。 |
|
| url |
string |