Recyclebin - Restore Work Item
削除された作業項目をごみ箱から復元します。
PATCH https://dev.azure.com/{organization}/{project}/_apis/wit/recyclebin/{id}?api-version=7.1-preview.2
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
id
|
path | True |
integer int32 |
復元する作業項目の ID |
organization
|
path | True |
string |
Azure DevOps 組織の名前です。 |
project
|
path |
string |
プロジェクト ID またはプロジェクト名 |
|
api-version
|
query | True |
string |
使う API のバージョン。 このバージョンの API を使用するには、これを '7.1-preview.2' に設定する必要があります。 |
要求本文
名前 | 型 | 説明 |
---|---|---|
isDeleted |
boolean |
この作業項目が削除されるかどうかを示す値を設定します。 |
応答
名前 | 型 | 説明 |
---|---|---|
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 | 作業項目とクエリの読み取り、作成、更新、ボード メタデータの更新、領域の読み取り、反復パスの他の作業項目追跡関連メタデータの実行、クエリの実行、サービス フックを介した作業項目イベントに関する通知の受信を行う機能を付与します。 |
例
Restore a work item
Sample Request
PATCH https://dev.azure.com/{organization}/_apis/wit/recyclebin/403?api-version=7.1-preview.2
{
"isDeleted": false
}
Sample Response
{
"id": 403,
"code": 200,
"type": "Bug",
"name": "Test bug to be deleted and then restored",
"project": "Fabrikam-Fiber-Git",
"deletedDate": "1/11/2017 11:18:16 PM",
"deletedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/403",
"resource": {
"id": 403,
"rev": 3,
"fields": {
"System.AreaPath": "Fabrikam-Fiber-Git",
"System.TeamProject": "Fabrikam-Fiber-Git",
"System.IterationPath": "Fabrikam-Fiber-Git\\Release 1\\Sprint 2",
"System.WorkItemType": "Bug",
"System.State": "New",
"System.Reason": "New defect reported",
"System.CreatedDate": "2017-01-11T23:14:16.37Z",
"System.CreatedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
"System.ChangedDate": "2017-01-11T23:18:16.03Z",
"System.ChangedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
"System.Title": "Test bug to be deleted and then restored",
"System.BoardColumn": "New",
"System.BoardColumnDone": false,
"Microsoft.VSTS.Common.StateChangeDate": "2017-01-11T23:14:16.37Z",
"Microsoft.VSTS.Common.Priority": 2,
"Microsoft.VSTS.Common.Severity": "3 - Medium",
"WEF_6CB513B6E70E43499D9FC94E5BBFB784_Kanban.Column": "New",
"WEF_6CB513B6E70E43499D9FC94E5BBFB784_Kanban.Column.Done": false,
"Microsoft.VSTS.Common.ValueArea": "Business"
},
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/403"
},
"workItemUpdates": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/403/updates"
},
"workItemRevisions": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/403/revisions"
},
"workItemHistory": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/403/history"
},
"html": {
"href": "https://dev.azure.com/fabrikam/web/wi.aspx?pcguid=d81542e4-cdfa-4333-b082-1ae2d6c3ad16&id=403"
},
"workItemType": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItemTypes/Bug"
},
"fields": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/fields"
}
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/403"
}
}
定義
名前 | 説明 |
---|---|
Reference |
REST 参照リンクのコレクションを表す クラス。 |
Work |
作業項目について説明します。 |
Work |
作業項目のコメントの特定のバージョンへの参照を表します。 |
Work |
完全に削除された作業項目オブジェクト。 作業項目自体が含まれます。 |
Work |
削除された作業項目の更新要求について説明します。 |
Work |
ReferenceLinks
REST 参照リンクのコレクションを表す クラス。
名前 | 型 | 説明 |
---|---|---|
links |
object |
リンクの読み取り時ビュー。 参照リンクは読み取り専用であるため、参照リンクは読み取り専用として公開する必要があります。 |
WorkItem
作業項目について説明します。
名前 | 型 | 説明 |
---|---|---|
_links |
関連する REST リソースへの参照をリンクします。 |
|
commentVersionRef |
このリビジョンで追加/編集/削除されたコメントの特定のバージョンへの参照。 |
|
fields |
object |
作業項目のフィールドと値のマップ。 |
id |
integer |
作業項目 ID。 |
relations |
作業項目の関係。 |
|
rev |
integer |
作業項目のリビジョン番号。 |
url |
string |
WorkItemCommentVersionRef
作業項目のコメントの特定のバージョンへの参照を表します。
名前 | 型 | 説明 |
---|---|---|
commentId |
integer |
コメントに割り当てられた ID。 |
createdInRevision |
integer |
[内部]このコメントが最初に追加された作業項目のリビジョン。 |
isDeleted |
boolean |
[内部]コメントが削除されたかどうかを指定します。 |
text |
string |
[内部]コメントのテキスト。 |
url |
string |
|
version |
integer |
バージョン番号。 |
WorkItemDelete
完全に削除された作業項目オブジェクト。 作業項目自体が含まれます。
名前 | 型 | 説明 |
---|---|---|
code |
integer |
バッチ要求での作業項目操作の HTTP 状態コード。 |
deletedBy |
string |
作業項目の種類を削除したユーザー。 |
deletedDate |
string |
作業項目の削除日。 |
id |
integer |
作業項目 ID。 |
message |
string |
バッチ要求での作業項目操作の例外メッセージ。 |
name |
string |
作業項目の名前またはタイトル。 |
project |
string |
削除された作業項目の親プロジェクト。 |
resource |
削除された作業項目オブジェクト。 |
|
type |
string |
作業項目の種類。 |
url |
string |
リソースの REST API URL |
WorkItemDeleteUpdate
削除された作業項目の更新要求について説明します。
名前 | 型 | 説明 |
---|---|---|
isDeleted |
boolean |
この作業項目が削除されるかどうかを示す値を設定します。 |
WorkItemRelation
名前 | 型 | 説明 |
---|---|---|
attributes |
object |
リンク属性のコレクション。 |
rel |
string |
関係の種類。 |
url |
string |
リンク URL。 |