Recyclebin - Get Deleted Work Items

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

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

URI 参数

名称 必需 类型 说明
organization
path True

string

Azure DevOps 组织的名称。

project
path

string

项目 ID 或项目名称

api-version
query True

string

要使用的 API 版本。 这应设置为“7.1”才能使用此版本的 API。

ids
query True

string (array (int32))

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

响应

名称 类型 说明
200 OK

WorkItemDeleteReference[]

成功作

安全性

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

示例

示例请求

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

示例响应

[
  {
    "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 (int32)

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

deletedBy

string

删除工作项类型的用户。

deletedDate

string

工作项删除日期。

id

integer (int32)

工作项 ID。

message

string

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

name

string

工作项的名称或标题。

project

string

已删除工作项的父项目。

type

string

工作项的类型。

url

string

资源的 REST API URL