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 |
成功作 |
安全性
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 |