Classification Nodes - Get

特定のノード パスの分類ノードを取得します。

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

名前 / 必須 型 説明
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' に設定する必要があります。

$depth
query

integer (int32)

フェッチする子の深さ。

応答

名前 型 説明
200 OK

WorkItemClassificationNode

成功した操作

セキュリティ

oauth2

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL (トークン 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

スコープ

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

応答のサンプル

{
  "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

応答のサンプル

{
  "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

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

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

名前 型 説明
links

object

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

TreeNodeStructureType

ノード構造の種類。

値 説明
area

エリアの種類。

iteration

イテレーションの種類。

TreeStructureGroup

分類ノード、領域、またはイテレーションの構造グループ。

値 説明
areas
iterations

WorkItemClassificationNode

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

名前 型 説明
_links

ReferenceLinks

関連する REST リソースへの参照をリンクします。

attributes

object

イテレーション ノードの開始日/終了日などのノード属性を持つディクショナリ。

children

WorkItemClassificationNode[]

フェッチされた子ノードの一覧。

hasChildren

boolean

分類ノードに子ノードがあるかどうかを示すフラグ。

id

integer (int32)

分類ノードの整数 ID。

identifier

string (uuid)

分類ノードの GUID ID。

name

string

分類ノードの名前。

path

string

分類ノードのパス。

structureType

TreeNodeStructureType

ノード構造の種類。

url

string