Classification Nodes - Update

Service:
Work Item Tracking
API バージョン:
5.0

既存の分類ノードを更新します。

PATCH https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=5.0

URI パラメーター

Name / 必須 型 説明
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 を使用するには、これを '5.0' に設定する必要があります。

要求本文

Name 型 説明
_links

ReferenceLinks

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

object

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

WorkItemClassificationNode[]

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

boolean

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

integer

分類ノードの整数 ID。
identifier

string

分類ノードの GUID ID。
name

string

分類ノードの名前。
structureType

TreeNodeStructureType

ノード構造の種類。
url

string

応答

Name 型 説明
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

スコープ

Name 説明
vso.work_write 作業項目とクエリの読み取り、作成、更新、ボード メタデータの更新、領域の読み取り、反復パスの他の作業項目追跡関連メタデータの実行、クエリの実行、サービス フックを介した作業項目イベントに関する通知の受信を行う機能を付与します。

例

Change an iteration's dates
Rename an area
Rename an iteration

Change an iteration's dates

要求のサンプル

PATCH https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Iterations?api-version=5.0

{
  "attributes": {
    "startDate": "2015-01-26T00:00:00Z",
    "finishDate": "2015-01-30T00:00:00Z"
  }
}

応答のサンプル

状態コード:
200 
{
  "id": 126392,
  "identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "attributes": {
    "startDate": "2015-01-26T00:00:00Z",
    "finishDate": "2015-01-30T00:00:00Z"
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Ultimate%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/Ultimate%20iteration"
}

Rename an area

要求のサンプル

PATCH https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=5.0

{
  "name": "Website team"
}

応答のサンプル

状態コード:
200 
{
  "id": 126391,
  "identifier": "25450731-5178-4044-84f0-0a0ebdef0c33",
  "name": "Website team",
  "structureType": "area",
  "hasChildren": false,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Website%20team"
    },
    "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/Website%20team"
}

Rename an iteration

要求のサンプル

PATCH https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Iterations?api-version=5.0

{
  "name": "Ultimate iteration"
}

応答のサンプル

状態コード:
200 
{
  "id": 126392,
  "identifier": "8677aa7d-2f4a-4f53-8f0f-b84a23997f70",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Ultimate%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/Ultimate%20iteration"
}

定義

Name 説明
ReferenceLinks

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

ノード構造の種類。
TreeStructureGroup

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

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

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

Name 型 説明
links

object

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

TreeNodeStructureType

列挙

ノード構造の種類。

値 説明
area

エリアの種類。
iteration

イテレーションの種類。

TreeStructureGroup

列挙

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

値 説明
areas
iterations

WorkItemClassificationNode

Object

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

Name 型 説明
_links

ReferenceLinks

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

object

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

WorkItemClassificationNode[]

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

boolean

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

integer

分類ノードの整数 ID。
identifier

string

分類ノードの GUID ID。
name

string

分類ノードの名前。
structureType

TreeNodeStructureType

ノード構造の種類。
url

string