Freigeben über

Recyclebin - Get

  • Referenz
Dienst:
Work Item Tracking
API-Version:
7.1

Ruft eine gelöschte Arbeitsaufgabe aus dem Papierkorb ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
id
 path True

integer (int32)

ID der zurückzugebenden Arbeitsaufgabe
organization
 path True

string

Der Name der Azure DevOps-Organisation.
project
 path

string

Projekt-ID oder Projektname
api-version
 query True

string

Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.

Antworten

Name Typ Beschreibung
200 OK

WorkItemDelete

Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-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

Bereiche

Name Beschreibung
vso.work Gewährt die Möglichkeit, Arbeitsaufgaben, Abfragen, Boards, Flächen- und Iterationspfade und andere Metadaten zur Nachverfolgung von Arbeitsaufgaben zu lesen. Gewährt außerdem die Möglichkeit, Abfragen auszuführen, Arbeitsaufgaben zu durchsuchen und Benachrichtigungen über Arbeitsaufgabenereignisse über Dienst-Hooks zu erhalten.

Beispiele

Beispielanforderung

GET https://dev.azure.com/fabrikam/_apis/wit/recyclebin/72?api-version=7.1

Beispiel für eine Antwort

Statuscode:
200 
{
  "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"
  }
}

Definitionen

Name Beschreibung
ReferenceLinks

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
WorkItem

Beschreibt eine Arbeitsaufgabe.
WorkItemCommentVersionRef

Stellt den Verweis auf eine bestimmte Version eines Kommentars zu einer Arbeitsaufgabe dar.
WorkItemDelete

Vollständig gelöschtes Arbeitsaufgabenobjekt. Enthält die Arbeitsaufgabe selbst.
WorkItemRelation
Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

Name Typ Beschreibung
links

object

Die schreibgeschützte Ansicht der Links. Da Referenzlinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

WorkItem

Objekt

Beschreibt eine Arbeitsaufgabe.

Name Typ Beschreibung
_links

ReferenceLinks

Verknüpfen Sie Verweise auf verwandte REST-Ressourcen.
commentVersionRef

WorkItemCommentVersionRef

Verweisen Sie auf eine bestimmte Version des Kommentars, der in dieser Überarbeitung hinzugefügt/bearbeitet/gelöscht wurde.
fields

object

Zuordnung von Feld und Werten für die Arbeitsaufgabe.
id

integer (int32)

Die Arbeitsaufgaben-ID.
relations

WorkItemRelation[]

Beziehungen der Arbeitsaufgabe.
rev

integer (int32)

Revisionsnummer der Arbeitsaufgabe.
url

string

WorkItemCommentVersionRef

Objekt

Stellt den Verweis auf eine bestimmte Version eines Kommentars zu einer Arbeitsaufgabe dar.

Name Typ Beschreibung
commentId

integer (int32)

Die dem Kommentar zugewiesene ID.
createdInRevision

integer (int32)

[Intern] Die Überarbeitung der Arbeitsaufgabe, in der dieser Kommentar ursprünglich hinzugefügt wurde.
isDeleted

boolean

[Intern] Gibt an, ob ein Kommentar gelöscht wurde.
text

string

[Intern] Der Text des Kommentars.
url

string

version

integer (int32)

Die Versionsnummer.

WorkItemDelete

Objekt

Vollständig gelöschtes Arbeitsaufgabenobjekt. Enthält die Arbeitsaufgabe selbst.

Name Typ Beschreibung
code

integer (int32)

Der HTTP-Statuscode für den Arbeitsaufgabenvorgang in einer Batchanforderung.
deletedBy

string

Der Benutzer, der den Arbeitsaufgabentyp gelöscht hat.
deletedDate

string

Das Löschdatum der Arbeitsaufgabe.
id

integer (int32)

Arbeitselement-ID.
message

string

Die Ausnahmemeldung für den Arbeitsaufgabenvorgang in einer Batchanforderung.
name

string

Name oder Titel der Arbeitsaufgabe.
project

string

Übergeordnetes Projekt der gelöschten Arbeitsaufgabe.
resource

WorkItem

Das Arbeitselementobjekt, das gelöscht wurde.
type

string

Art der Arbeitsaufgabe.
url

string

REST-API-URL der Ressource

WorkItemRelation

Objekt
Name Typ Beschreibung
attributes

object

Sammlung von Verknüpfungsattributen.
rel

string

Beziehungstyp.
url

string

Link-URL.