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 |
專案識別碼或專案名稱 |
structure
|
path | True |
分類節點、區域或反復專案的結構群組。 |
|
path
|
path |
string |
分類節點的路徑。 |
|
api-version
|
query | True |
string |
要使用的 API 版本。 這應該設定為 '5.0' 以使用此版本的 API。 |
$depth
|
query |
integer int32 |
要擷取的子系深度。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
成功作業 |
安全性
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 |
---|---|
Reference |
表示 REST 參考連結集合的類別。 |
Tree |
節點結構類型。 |
Tree |
分類節點、區域或反復專案的結構群組。 |
Work |
定義工作專案追蹤的分類節點。 |
ReferenceLinks
表示 REST 參考連結集合的類別。
名稱 | 類型 | Description |
---|---|---|
links |
object |
連結的唯讀檢視。 因為參考連結是唯讀的,所以我們只想要將它們公開為唯讀。 |
TreeNodeStructureType
節點結構類型。
名稱 | 類型 | Description |
---|---|---|
area |
string |
區欄位型別。 |
iteration |
string |
反復專案類型。 |
TreeStructureGroup
分類節點、區域或反復專案的結構群組。
名稱 | 類型 | Description |
---|---|---|
areas |
string |
|
iterations |
string |
WorkItemClassificationNode
定義工作專案追蹤的分類節點。
名稱 | 類型 | Description |
---|---|---|
_links |
連結相關 REST 資源的參考。 |
|
attributes |
object |
具有節點屬性的字典,例如反復專案節點的開始/完成日期。 |
children |
擷取的子節點清單。 |
|
hasChildren |
boolean |
旗標,指出分類節點是否有任何子節點。 |
id |
integer |
分類節點的整數識別碼。 |
identifier |
string |
分類節點的 GUID 識別碼。 |
name |
string |
分類節點的名稱。 |
structureType |
節點結構類型。 |
|
url |
string |