Work Items - Create

リファレンス

サービス:: Work Item Tracking

API バージョン:: 7.1-preview.3

1 つの作業項目を作成します。

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

省略可能なパラメーターを含む:

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

URI パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前です。
project	path	True	string	プロジェクト ID またはプロジェクト名
type	path	True	string	作成する作業項目の作業項目の種類
api-version	query	True	string	使う API のバージョン。このバージョンの API を使用するには、これを '7.1-preview.3' に設定する必要があります。
$expand	query		WorkItemExpand	作業項目属性の展開パラメーター。使用できるオプションは{なし、リレーション、フィールド、リンク、すべて}です。
bypassRules	query		boolean	この更新プログラムで作業項目の種類の規則を適用しないでください
suppressNotifications	query		boolean	この変更に関する通知は一切発生しません
validateOnly	query		boolean	作業項目を保存せずに変更のみを検証するかどうかを指定する

要求本文

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

名前	型	説明
from	string	移動/コピー操作のコピー元のパス。
op	Operation	パッチ操作
path	string	操作のパス。配列の場合、0 から始まるインデックスを使用して、配列内の位置を指定できます (例: /menus/0/name)。配列の末尾に挿入するインデックスの代わりに "-" 文字を使用できます (例: /biscuits/-)。
value	object	操作の値。これはプリミティブまたは JToken です。

応答

名前	型	説明
200 OK	WorkItem	成功した操作

セキュリティ

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_write	作業項目とクエリの読み取り、作成、更新、ボードメタデータの更新、読み取り領域とイテレーションパス、関連するメタデータの追跡、クエリの実行、サービスフックを介した作業項目イベントに関する通知の受信を行う機能を付与します。

例

Create work item

要求のサンプル

HTTP

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

[
  {
    "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": {
      "displayName": "Jamal Hartnett",
      "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "_links": {
        "avatar": {
          "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
        }
      },
      "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "uniqueName": "fabrikamfiber4@hotmail.com",
      "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
    },
    "System.ChangedDate": "2017-10-06T01:04:51.57Z",
    "System.ChangedBy": {
      "displayName": "Jamal Hartnett",
      "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "_links": {
        "avatar": {
          "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
        }
      },
      "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "uniqueName": "fabrikamfiber4@hotmail.com",
      "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
    },
    "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	作業項目について説明します。
WorkItemCommentVersionRef	作業項目のコメントの特定のバージョンへの参照を表します。
WorkItemExpand	作業項目属性の展開パラメーター。使用可能なオプションは{なし、リレーション、フィールド、リンク、すべて} です。
WorkItemRelation

JsonPatchDocument

Object

JSON パッチ操作の JSON モデル

名前	型	説明
from	string	移動/コピー操作のコピー元のパス。
op	Operation	パッチ操作
path	string	操作のパス。配列の場合、0 から始まるインデックスを使用して、配列内の位置を指定できます (例: /menus/0/name)。配列の末尾に挿入するインデックスの代わりに "-" 文字を使用できます (例: /biscuits/-)。
value	object	操作の値。これはプリミティブまたは JToken です。

Operation

列挙

パッチ操作

値	説明
add
copy
move
remove
replace
test

ReferenceLinks

Object

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

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

WorkItem

Object

作業項目について説明します。

名前	型	説明
_links	ReferenceLinks	関連する REST リソースへの参照をリンクします。
commentVersionRef	WorkItemCommentVersionRef	このリビジョンで追加/編集/削除されたコメントの特定のバージョンへの参照。
fields	object	作業項目のフィールドと値のマップ。
id	integer	作業項目 ID。
relations	WorkItemRelation[]	作業項目の関係。
rev	integer	作業項目のリビジョン番号。
url	string

WorkItemCommentVersionRef

Object

作業項目のコメントの特定のバージョンへの参照を表します。

名前	型	説明
commentId	integer	コメントに割り当てられた ID。
createdInRevision	integer	[Internal]このコメントが最初に追加された作業項目のリビジョン。
isDeleted	boolean	[Internal]コメントが削除されたかどうかを指定します。
text	string	[Internal]コメントのテキスト。
url	string
version	integer	バージョン番号。

WorkItemExpand

列挙

作業項目属性の展開パラメーター。使用可能なオプションは{なし、リレーション、フィールド、リンク、すべて} です。

値	説明
all	すべて展開します。
fields	フィールド作業項目が展開されます。
links	作業項目の展開をリンクします。
none	既定の動作。
relations	リレーション作業項目が展開されます。

WorkItemRelation

Object

名前	型	説明
attributes	object	リンク属性のコレクション。
rel	string	関係の種類。
url	string	リンク URL。

次の方法で共有

Work Items - Create

URI パラメーター

要求本文

応答

セキュリティ

oauth2

スコープ

例

Create work item

要求のサンプル

応答のサンプル

定義

JsonPatchDocument

Operation

ReferenceLinks

WorkItem

WorkItemCommentVersionRef

WorkItemExpand

WorkItemRelation

その他のリソース