Recyclebin - Restore Work Item

Obnoví odstraněnou pracovní položku z koše.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
id
path True

integer

int32

ID pracovní položky, která se má obnovit

organization
path True

string

Název organizace Azure DevOps.

project
path

string

ID projektu nebo název projektu

api-version
query True

string

Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavená na 7.1-preview.2.

Text požadavku

Name Typ Description
isDeleted

boolean

Nastaví hodnotu označující, zda je tato pracovní položka odstraněna.

Odpovědi

Name Typ Description
200 OK

WorkItemDelete

úspěšná operace

Zabezpečení

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

Name Description
vso.work_write Umožňuje číst, vytvářet a aktualizovat pracovní položky a dotazy, metadata aktualizačního panelu, oblast čtení a iterace cest k jiným metadatům souvisejícím se sledováním pracovních položek, spouštět dotazy a přijímat oznámení o událostech pracovních položek prostřednictvím služeb.

Příklady

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"
  }
}

Definice

Name Description
ReferenceLinks

Třída představující kolekci odkazů REST.

WorkItem

Popisuje pracovní položku.

WorkItemCommentVersionRef

Představuje odkaz na konkrétní verzi komentáře k pracovní položce.

WorkItemDelete

Úplný odstraněný objekt pracovní položky. Zahrnuje samotnou pracovní položku.

WorkItemDeleteUpdate

Popisuje žádost o aktualizaci odstraněné pracovní položky.

WorkItemRelation

Třída představující kolekci odkazů REST.

Name Typ Description
links

object

Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako jen pro čtení.

WorkItem

Popisuje pracovní položku.

Name Typ Description
_links

ReferenceLinks

Odkazy na související prostředky REST

commentVersionRef

WorkItemCommentVersionRef

Odkaz na konkrétní verzi komentáře přidaného, upraveného nebo odstraněného v této revizi

fields

object

Mapa polí a hodnot pro pracovní položku

id

integer

ID pracovní položky.

relations

WorkItemRelation[]

Vztahy pracovní položky.

rev

integer

Číslo revize pracovní položky.

url

string

WorkItemCommentVersionRef

Představuje odkaz na konkrétní verzi komentáře k pracovní položce.

Name Typ Description
commentId

integer

ID přiřazené ke komentáři.

createdInRevision

integer

[Interní] Revize pracovní položky, do které byl tento komentář původně přidán.

isDeleted

boolean

[Interní] Určuje, jestli byl komentář odstraněn.

text

string

[Interní] Text komentáře.

url

string

version

integer

Číslo verze.

WorkItemDelete

Úplný odstraněný objekt pracovní položky. Zahrnuje samotnou pracovní položku.

Name Typ Description
code

integer

Stavový kód HTTP pro operaci pracovní položky v dávkovém požadavku.

deletedBy

string

Uživatel, který odstranil typ pracovní položky.

deletedDate

string

Datum odstranění pracovní položky.

id

integer

ID pracovní položky.

message

string

Zpráva o výjimce pro operaci pracovní položky v dávkovém požadavku.

name

string

Název nebo název pracovní položky.

project

string

Nadřazený projekt odstraněné pracovní položky.

resource

WorkItem

Objekt pracovní položky, který byl odstraněn.

type

string

Typ pracovní položky.

url

string

ADRESA URL rozhraní REST API prostředku

WorkItemDeleteUpdate

Popisuje žádost o aktualizaci odstraněné pracovní položky.

Name Typ Description
isDeleted

boolean

Nastaví hodnotu označující, zda je tato pracovní položka odstraněna.

WorkItemRelation

Name Typ Description
attributes

object

Kolekce atributů odkazu.

rel

string

Typ relace.

url

string

Adresa URL odkazu.