Recyclebin - Get
從回收站取得已刪除的工作專案。
GET https://dev.azure.com/{organization}/{project}/_apis/wit/recyclebin/{id}?api-version=7.1-preview.2
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
id
|
path | True |
integer int32 |
要傳回的工作專案識別碼 |
organization
|
path | True |
string |
Azure DevOps 組織的名稱。 |
project
|
path |
string |
專案識別碼或專案名稱 |
|
api-version
|
query | True |
string |
要使用的 API 版本。 這應該設定為 '7.1-preview.2',以使用此版本的 API。 |
回應
名稱 | 類型 | Description |
---|---|---|
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
名稱 | Description |
---|---|
vso.work | 授與讀取工作專案、查詢、面板、區域和反復專案路徑,以及其他工作專案追蹤相關中繼資料的能力。 同時授與執行查詢、搜尋工作專案,以及透過服務勾點接收工作專案事件的通知的能力。 |
範例
Sample Request
GET https://dev.azure.com/fabrikam/_apis/wit/recyclebin/72?api-version=7.1-preview.2
Sample Response
{
"id": "72",
"type": "WorkItem",
"Name": "72:First Workitem",
"Project": "Fabrikam-Fiber-Git",
"DeletedDate": "2015-01-07T18:13:01.807Z",
"DeletedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
"url": "https://dev.azure.com/fabrikam/_apis/wit/recycleBin/72?api-version=1.0",
"resource": {
"id": 72,
"rev": 1,
"fields": {
"System.AreaPath": "Fabrikam-Fiber-Git",
"System.TeamProject": "Fabrikam-Fiber-Git",
"System.IterationPath": "Fabrikam-Fiber-Git",
"System.WorkItemType": "Product Backlog Item",
"System.State": "New",
"System.Reason": "New backlog item",
"System.CreatedDate": "2015-01-07T18:13:01.807Z",
"System.CreatedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
"System.ChangedDate": "2015-01-07T18:13:01.807Z",
"System.ChangedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
"System.Title": "First Workitem",
"Microsoft.VSTS.Scheduling.Effort": 8,
"WEF_6CB513B6E70E43499D9FC94E5BBFB784_Kanban.Column": "New",
"System.Description": "Our authorization logic needs to allow for users with Microsoft accounts (formerly Live Ids) - http://msdn.microsoft.com/en-us/library/live/hh826547.aspx"
},
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/72"
},
"workItemUpdates": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/72/updates"
},
"workItemRevisions": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/72/revisions"
},
"workItemHistory": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/72/history"
},
"html": {
"href": "https://dev.azure.com/fabrikam/web/wi.aspx?pcguid=d81542e4-cdfa-4333-b082-1ae2d6c3ad16&id=72"
},
"workItemType": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItemTypes/Product%20Backlog%20Item"
},
"fields": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/fields"
}
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/72"
}
}
定義
名稱 | Description |
---|---|
Reference |
表示 REST 參考連結集合的類別。 |
Work |
描述工作專案。 |
Work |
表示工作專案上特定批註版本的參考。 |
Work |
完整刪除的工作專案物件。 包含工作專案本身。 |
Work |
ReferenceLinks
表示 REST 參考連結集合的類別。
名稱 | 類型 | Description |
---|---|---|
links |
object |
連結的唯讀檢視。 因為參考連結是唯讀的,所以我們只想要將它們公開為唯讀。 |
WorkItem
描述工作專案。
名稱 | 類型 | Description |
---|---|---|
_links |
連結相關 REST 資源的參考。 |
|
commentVersionRef |
此修訂中新增/編輯/刪除之批註特定版本的參考。 |
|
fields |
object |
工作專案的欄位和值對應。 |
id |
integer |
工作專案識別碼。 |
relations |
工作專案的關係。 |
|
rev |
integer |
工作專案的修訂編號。 |
url |
string |
WorkItemCommentVersionRef
表示工作專案上特定批註版本的參考。
名稱 | 類型 | Description |
---|---|---|
commentId |
integer |
指派給批註的識別碼。 |
createdInRevision |
integer |
[內部]最初新增此批註的工作專案修訂。 |
isDeleted |
boolean |
[內部]指定是否刪除批註。 |
text |
string |
[內部]批註的文字。 |
url |
string |
|
version |
integer |
版本號碼。 |
WorkItemDelete
完整刪除的工作專案物件。 包含工作專案本身。
名稱 | 類型 | Description |
---|---|---|
code |
integer |
批次要求中工作專案作業的 HTTP 狀態碼。 |
deletedBy |
string |
刪除工作專案類型的使用者。 |
deletedDate |
string |
工作專案刪除日期。 |
id |
integer |
工作專案識別碼。 |
message |
string |
批次要求中工作專案作業的例外狀況訊息。 |
name |
string |
工作專案的名稱或標題。 |
project |
string |
已刪除工作專案的父專案。 |
resource |
已刪除的工作專案物件。 |
|
type |
string |
工作專案的類型。 |
url |
string |
資源的 REST API URL |
WorkItemRelation
名稱 | 類型 | Description |
---|---|---|
attributes |
object |
連結屬性的集合。 |
rel |
string |
關聯性類型。 |
url |
string |
連結 URL。 |