Recyclebin - Get Deleted Work Items

从回收站获取工作项,其 ID 已在参数中指定

GET https://dev.azure.com/{organization}/{project}/_apis/wit/recyclebin?ids={ids}&api-version=7.1-preview.2

URI 参数

名称 必需 类型 说明
organization
path True

string

Azure DevOps 组织的名称。

project
path

string

项目 ID 或项目名称

api-version
query True

string

要使用的 API 版本。 应将其设置为“7.1-preview.2”才能使用此版本的 API。

ids
query True

string

array (int32)

要返回的已删除工作项的 ID 的逗号分隔列表

响应

名称 类型 说明
200 OK

WorkItemDeleteReference[]

成功的操作

安全性

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 授予读取工作项、查询、板、区域和迭代路径以及其他工作项跟踪相关元数据的能力。 此外,还允许通过服务挂钩执行查询、搜索工作项和接收有关工作项事件的通知。

示例

Sample Request

GET https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/recyclebin?ids=92,93,102&api-version=7.1-preview.2

Sample Response

[
  {
    "id": "92",
    "code": 200,
    "type": "Bug",
    "name": "Bug 92",
    "project": "My Project",
    "deletedDate": "1/31/2017 9:21:14 PM",
    "deletedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
    "url": "https://dev.azure.com/fabrikam/_apis/wit/recycleBin/92"
  },
  {
    "id": "93",
    "code": 200,
    "type": "User Story",
    "name": "User Story 93",
    "project": "My Project",
    "deletedDate": "1/31/2017 9:31:00 PM",
    "deletedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
    "url": "https://dev.azure.com/fabrikam/_apis/wit/recycleBin/93"
  },
  {
    "id": "102",
    "code": 200,
    "type": "Bug",
    "name": "Bug 102",
    "project": "My Project",
    "deletedDate": "12/30/2016 8:25:15 PM",
    "deletedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
    "url": "https://dev.azure.com/fabrikam/_apis/wit/recycleBin/102"
  }
]

定义

WorkItemDeleteReference

对已删除的工作项的引用。

名称 类型 说明
code

integer

批处理请求中工作项操作的 HTTP 状态代码。

deletedBy

string

删除工作项类型的用户。

deletedDate

string

工作项删除日期。

id

integer

工作项 ID。

message

string

批处理请求中工作项操作的异常消息。

name

string

工作项的名称或标题。

project

string

已删除工作项的父项目。

type

string

工作项的类型。

url

string

资源的 REST API URL