Work Items - Delete

Service:

Work Item Tracking

API Version:

5.0

必要に応じて復元できるように、指定した作業項目を削除してごみ箱に送信します。 必要に応じて、destroy パラメーターが true に設定されている場合、作業項目は完全に破棄されます。

DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?api-version=5.0

With optional parameters:

DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?destroy={destroy}&api-version=5.0

URI パラメーター

名前	/	必須	型	説明
id	path	True	integer int32	削除する作業項目の ID
organization	path	True	string	Azure DevOps 組織の名前です。
project	path		string	プロジェクト ID またはプロジェクト名
api-version	query	True	string	使う API のバージョン。 このバージョンの API を使用するには、これを '5.0' に設定する必要があります。
destroy	query		boolean	省略可能なパラメーター。true に設定すると、作業項目は完全に削除されます

応答

名前	型	説明
200 OK	WorkItemDelete	正常な操作

セキュリティ

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

例

Sample Request

HTTP

DELETE https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/workitems/{id}?api-version=5.0

Sample Response

Status code:

204

定義

名前	説明
ReferenceLinks	REST 参照リンクのコレクションを表す クラス。
WorkItem	作業項目について説明します。
WorkItemDelete	完全に削除された作業項目オブジェクト。 作業項目自体が含まれます。
WorkItemRelation

ReferenceLinks

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

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

WorkItem

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

名前	型	説明
_links	ReferenceLinks	関連する REST リソースへの参照をリンクします。
fields	object	作業項目のフィールドと値のマップ。
id	integer	作業項目 ID。
relations	WorkItemRelation[]	作業項目の関係。
rev	integer	作業項目のリビジョン番号。
url	string

WorkItemDelete

完全に削除された作業項目オブジェクト。 作業項目自体が含まれます。

名前	型	説明
code	integer	バッチ要求での作業項目操作の HTTP 状態コード。
deletedBy	string	作業項目の種類を削除したユーザー。
deletedDate	string	作業項目の削除日。
id	integer	作業項目 ID。
message	string	バッチ要求での作業項目操作の例外メッセージ。
name	string	作業項目の名前またはタイトル。
project	string	削除された作業項目の親プロジェクト。
resource	WorkItem	削除された作業項目オブジェクト。
type	string	作業項目の種類。
url	string	リソースの REST API URL

WorkItemRelation

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