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 パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前です。
project	path	True	string	プロジェクト ID またはプロジェクト名
structureGroup	path	True	TreeStructureGroup	分類ノード、領域、または反復の構造グループ。
path	path		string	分類ノードのパス。
api-version	query	True	string	使う API のバージョン。 このバージョンの API を使用するには、これを '7.1-preview.2' に設定する必要があります。
$depth	query		integer int32	フェッチする子の深さ。

応答

名前	型	説明
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

名前	説明
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"
}

定義

名前	説明
ReferenceLinks	REST 参照リンクのコレクションを表す クラス。
TreeNodeStructureType	ノード構造の種類。
TreeStructureGroup	分類ノード、領域、または反復の構造グループ。
WorkItemClassificationNode	作業項目追跡用の分類ノードを定義します。

ReferenceLinks

REST 参照リンクのコレクションを表す クラス。

名前	型	説明
links	object	リンクの読み取り時ビュー。 参照リンクは読み取り専用であるため、参照リンクは読み取り専用として公開する必要があります。

TreeNodeStructureType

ノード構造の種類。

名前	型	説明
area	string	エリアの種類。
iteration	string	イテレーションの種類。

TreeStructureGroup

分類ノード、領域、または反復の構造グループ。

名前	型	説明
areas	string
iterations	string

WorkItemClassificationNode

作業項目追跡用の分類ノードを定義します。

名前	型	説明
_links	ReferenceLinks	関連する REST リソースへの参照をリンクします。
attributes	object	イテレーション ノードの開始日/終了日などのノード属性を持つディクショナリ。
children	WorkItemClassificationNode[]	フェッチされた子ノードの一覧。
hasChildren	boolean	分類ノードに子ノードがあるかどうかを示すフラグ。
id	integer	分類ノードの整数 ID。
identifier	string	分類ノードの GUID ID。
name	string	分類ノードの名前。
path	string	分類ノードのパス。
structureType	TreeNodeStructureType	ノード構造の種類。
url	string