Classification Nodes - Create Or Update
新規の分類ノードを作成するか、既存の分類ノードを更新します。
POST https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=7.1-preview.2URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Azure DevOps 組織の名前です。 |
|
project
|
path | True |
string |
プロジェクト ID またはプロジェクト名 |
|
structure
|
path | True |
分類ノード、領域、または反復の構造グループ。 |
|
|
path
|
path |
string |
分類ノードのパス。 |
|
|
api-version
|
query | True |
string |
使う API のバージョン。 このバージョンの API を使用するには、これを '7.1-preview.2' に設定する必要があります。 |
要求本文
| 名前 | 型 | 説明 |
|---|---|---|
| _links |
関連する REST リソースへの参照をリンクします。 |
|
| attributes |
object |
イテレーション ノードの開始日/終了日などのノード属性を持つディクショナリ。 |
| children |
フェッチされた子ノードの一覧。 |
|
| hasChildren |
boolean |
分類ノードに子ノードがあるかどうかを示すフラグ。 |
| id |
integer |
分類ノードの整数 ID。 |
| identifier |
string |
分類ノードの GUID ID。 |
| name |
string |
分類ノードの名前。 |
| path |
string |
分類ノードのパス。 |
| structureType |
ノード構造の種類。 |
|
| url |
string |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 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
| 名前 | 説明 |
|---|---|
| vso.work_write | 作業項目とクエリの読み取り、作成、更新、ボード メタデータの更新、読み取り領域とイテレーション パス、関連するメタデータの追跡、クエリの実行、サービス フックを介した作業項目イベントに関する通知の受信を行う機能を付与します。 |
例
| Create an area |
| Create an iteration |
| Move an area node |
| Move an iteration node |
Create an area
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=7.1-preview.2
{
"name": "Web"
}
Sample Response
{
"id": 126391,
"identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
"name": "Web",
"structureType": "area",
"hasChildren": false,
"path": "\\fabrikam\\fiber\\tfvc\\area",
"_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"
}Create an iteration
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Iterations?api-version=7.1-preview.2
{
"name": "Final Iteration",
"attributes": {
"startDate": "2014-10-27T00:00:00Z",
"finishDate": "2014-10-31T00:00:00Z"
}
}
Sample Response
{
"id": 126392,
"identifier": "8dbed14a-c1b6-46e8-8540-8118c4ea29ae",
"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"
}Move an area node
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=7.1-preview.2
{
"id": 126391
}
Sample Response
{
"id": 126391,
"identifier": "d01a1947-781a-4328-95be-960b90d04fe3",
"name": "Website team",
"structureType": "area",
"hasChildren": false,
"path": "\\fabrikam\\fiber\\tfvc\\area",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area/Website%20team"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area/Website%20team"
}Move an iteration node
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/{structureGroup}?api-version=7.1-preview.2
{
"id": 126392
}
Sample Response
{
"id": 126392,
"identifier": "81f373b4-93cb-4c2b-99e6-1308ea5d1adc",
"name": "Ultimate iteration",
"structureType": "iteration",
"hasChildren": false,
"path": "\\fabrikam\\fiber\\tfvc\\iteration",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration/Ultimate%20iteration"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration/Ultimate%20iteration"
}定義
| 名前 | 説明 |
|---|---|
|
Reference |
REST 参照リンクのコレクションを表す クラス。 |
|
Tree |
ノード構造の種類。 |
|
Tree |
分類ノード、領域、または反復の構造グループ。 |
|
Work |
作業項目追跡用の分類ノードを定義します。 |
ReferenceLinks
REST 参照リンクのコレクションを表す クラス。
| 名前 | 型 | 説明 |
|---|---|---|
| links |
object |
リンクの読み取り専用ビュー。 参照リンクは読み取り専用であるため、参照リンクは読み取り専用として公開する必要があります。 |
TreeNodeStructureType
ノード構造の種類。
| 名前 | 型 | 説明 |
|---|---|---|
| area |
string |
エリアの種類。 |
| iteration |
string |
イテレーションの種類。 |
TreeStructureGroup
分類ノード、領域、または反復の構造グループ。
| 名前 | 型 | 説明 |
|---|---|---|
| areas |
string |
|
| iterations |
string |
WorkItemClassificationNode
作業項目追跡用の分類ノードを定義します。
| 名前 | 型 | 説明 |
|---|---|---|
| _links |
関連する REST リソースへの参照をリンクします。 |
|
| attributes |
object |
イテレーション ノードの開始日/終了日などのノード属性を持つディクショナリ。 |
| children |
フェッチされた子ノードの一覧。 |
|
| hasChildren |
boolean |
分類ノードに子ノードがあるかどうかを示すフラグ。 |
| id |
integer |
分類ノードの整数 ID。 |
| identifier |
string |
分類ノードの GUID ID。 |
| name |
string |
分類ノードの名前。 |
| path |
string |
分類ノードのパス。 |
| structureType |
ノード構造の種類。 |
|
| url |
string |
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示