次の方法で共有

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

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

応答のサンプル

状態コード:
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"
}

定義

名前 説明
ReferenceLinks

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

ノード構造の種類。
TreeStructureGroup

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

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

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

名前 型 説明
links

object

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

TreeNodeStructureType

列挙

ノード構造の種類。

値 説明
area

エリアの種類。
iteration

イテレーションの種類。

TreeStructureGroup

列挙

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

値 説明
areas
iterations

WorkItemClassificationNode

Object

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

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