Classification Nodes - Update

  • 参考
Service:
Work Item Tracking
API Version:
4.1

更新现有分类节点。

PATCH https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=4.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 版本。 应将其设置为“4.1”才能使用此版本的 API。

请求正文

名称 类型 说明
_links

ReferenceLinks

将引用链接到相关的 REST 资源。
attributes

object

具有迭代节点的开始/完成日期等节点属性的字典。
children

WorkItemClassificationNode[]

提取的子节点列表。
hasChildren

boolean

指示分类节点是否具有任何子节点的标志。
id

integer

分类节点的整数 ID。
identifier

string

分类节点的 GUID ID。
name

string

分类节点的名称。
structureType

TreeNodeStructureType

节点结构类型。
url

string

响应

名称 类型 说明
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_write 授予读取、创建和更新工作项和查询、更新板元数据、读取区域和迭代路径等工作项跟踪相关元数据、执行查询以及通过服务挂钩接收有关工作项事件的通知的能力。

示例

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

Change an iteration's dates

Sample Request

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

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

Sample Response

Status code:
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

Sample Request

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

{
  "name": "Website team"
}

Sample Response

Status code:
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

Sample Request

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

{
  "name": "Ultimate iteration"
}

Sample Response

Status code:
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"
}

定义

名称 说明
ReferenceLinks

表示 REST 引用链接集合的类。
TreeNodeStructureType

节点结构类型。
TreeStructureGroup

分类节点、区域或迭代的结构组。
WorkItemClassificationNode

定义用于工作项跟踪的分类节点。

表示 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

分类节点的名称。
structureType

TreeNodeStructureType

节点结构类型。
url

string