Work Items - Create

服务:

Work Item Tracking

API 版本:

4.1

创建单个工作项。

POST https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/${type}?api-version=4.1

具有可选参数:

POST https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/${type}?validateOnly={validateOnly}&bypassRules={bypassRules}&suppressNotifications={suppressNotifications}&api-version=4.1

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
project	path	True	string	项目 ID 或项目名称
type	path	True	string	要创建的工作项的工作项类型
api-version	query	True	string	要使用的 API 版本。 应将其设置为“4.1”才能使用此版本的 API。
bypassRules	query		boolean	不要对此更新强制实施工作项类型规则
suppressNotifications	query		boolean	请勿针对此更改触发任何通知
validateOnly	query		boolean	指示是否只想在不保存工作项的情况下验证更改

请求正文

Media Types: "application/json-patch+json"

名称	类型	说明
from	string	移动/复制操作的复制路径。
op	Operation	修补操作
path	string	操作的路径
value	object	操作的值。 这是基元或 JToken。

响应

名称	类型	说明
200 OK	WorkItem	成功的操作

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 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_write	授予读取、创建和更新工作项和查询、更新板元数据、读取区域和迭代路径等工作项跟踪相关元数据、执行查询以及通过服务挂钩接收有关工作项事件的通知的能力。

示例

Create work item

示例请求

HTTP

POST https://dev.azure.com/fabrikam/{project}/_apis/wit/workitems/${type}?api-version=4.1

[
  {
    "op": "add",
    "path": "/fields/System.Title",
    "from": null,
    "value": "Sample task"
  }
]

示例响应

状态代码:

200

{
  "id": 131489,
  "rev": 1,
  "fields": {
    "System.AreaPath": "CustomProcessPrj",
    "System.TeamProject": "CustomProcessPrj",
    "System.IterationPath": "CustomProcessPrj",
    "System.WorkItemType": "Task",
    "System.State": "New",
    "System.Reason": "New",
    "System.CreatedDate": "2017-10-06T01:04:51.57Z",
    "System.CreatedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
    "System.ChangedDate": "2017-10-06T01:04:51.57Z",
    "System.ChangedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
    "System.Title": "Sample task",
    "Microsoft.VSTS.Common.StateChangeDate": "2017-10-06T01:04:51.57Z",
    "Microsoft.VSTS.Common.Priority": 2
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489"
    },
    "workItemUpdates": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489/updates"
    },
    "workItemRevisions": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489/revisions"
    },
    "workItemHistory": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489/history"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/wi.aspx?pcguid=20cda608-32f0-4e6e-9b7c-8def7b38d15a&id=131489"
    },
    "workItemType": {
      "href": "https://dev.azure.com/fabrikam/aaee31d9-14cf-48b9-a92b-3f1446c13f80/_apis/wit/workItemTypes/Task"
    },
    "fields": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/fields"
    }
  },
  "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489"
}

定义

名称	说明
JsonPatchDocument	JSON 修补程序操作的 JSON 模型
Operation	修补操作
ReferenceLinks	表示 REST 引用链接集合的类。
WorkItem	描述工作项。
WorkItemRelation

JsonPatchDocument

Object

JSON 修补程序操作的 JSON 模型

名称	类型	说明
from	string	移动/复制操作的复制路径。
op	Operation	修补操作
path	string	操作的路径
value	object	操作的值。 这是基元或 JToken。

Operation

Enumeration

修补操作

值	说明
add
copy
move
remove
replace
test

ReferenceLinks

Object

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

名称	类型	说明
links	object	链接的只读视图。 由于引用链接是只读的，因此我们只想将其公开为只读。

WorkItem

Object

描述工作项。

名称	类型	说明
_links	ReferenceLinks	将引用链接到相关的 REST 资源。
fields	object	工作项的字段和值的映射。
id	integer	工作项 ID。
relations	WorkItemRelation[]	工作项的关系。
rev	integer	工作项的修订号。
url	string

WorkItemRelation

Object

名称	类型	说明
attributes	object	链接属性的集合。
rel	string	关系类型。
url	string	链接 URL。