Share via


Recyclebin - Get

Ruft ein gelöschtes Arbeitselement aus dem Papierkorb ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
id
path True

integer

int32

ID des zurückzugebenden Arbeitselements

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-preview.2" festgelegt werden, um diese Version der API zu verwenden.

Antworten

Name Typ Beschreibung
200 OK

WorkItemDelete

Erfolgreicher Vorgang

Sicherheit

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 Beschreibung
vso.work Ermöglicht das Lesen von Arbeitselementen, Abfragen, Boards, Bereichs- und Iterationspfaden und anderen Metadaten zur Nachverfolgung von Arbeitselementen. Außerdem können Sie Abfragen ausführen, Arbeitselemente durchsuchen und Benachrichtigungen über Arbeitselementereignisse über Diensthaken empfangen.

Beispiele

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

Definitionen

Name Beschreibung
ReferenceLinks

Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.

WorkItem

Beschreibt ein Arbeitselement.

WorkItemCommentVersionRef

Stellt den Verweis auf eine bestimmte Version eines Kommentars für ein Arbeitselement dar.

WorkItemDelete

Vollständig gelöschtes Arbeitselementobjekt. Schließt das Arbeitselement selbst ein.

WorkItemRelation

Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Name Typ Beschreibung
links

object

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

WorkItem

Beschreibt ein Arbeitselement.

Name Typ Beschreibung
_links

ReferenceLinks

Verknüpfen Sie Verweise auf verwandte REST-Ressourcen.

commentVersionRef

WorkItemCommentVersionRef

Verweis 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 das Arbeitselement.

id

integer

Die Arbeitselement-ID.

relations

WorkItemRelation[]

Beziehungen des Arbeitselements.

rev

integer

Revisionsnummer des Arbeitselements.

url

string

WorkItemCommentVersionRef

Stellt den Verweis auf eine bestimmte Version eines Kommentars für ein Arbeitselement dar.

Name Typ Beschreibung
commentId

integer

Die dem Kommentar zugewiesene ID.

createdInRevision

integer

[Intern] Die Arbeitselementrevision, in der dieser Kommentar ursprünglich hinzugefügt wurde.

isDeleted

boolean

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

text

string

[Intern] Der Text des Kommentars.

url

string

version

integer

Die Versionsnummer.

WorkItemDelete

Vollständig gelöschtes Arbeitselementobjekt. Schließt das Arbeitselement selbst ein.

Name Typ Beschreibung
code

integer

Der HTTP-status Code für Arbeitselementvorgang in einer Batchanforderung.

deletedBy

string

Der Benutzer, der den Arbeitselementtyp gelöscht hat.

deletedDate

string

Das Löschdatum des Arbeitselements.

id

integer

Arbeitselement-ID.

message

string

Die Ausnahmemeldung für den Arbeitselementvorgang in einer Batchanforderung.

name

string

Name oder Titel des Arbeitselements.

project

string

Übergeordnetes Projekt des gelöschten Arbeitselements.

resource

WorkItem

Das Arbeitselementobjekt, das gelöscht wurde.

type

string

Typ des Arbeitselements.

url

string

REST-API-URL der Ressource

WorkItemRelation

Name Typ Beschreibung
attributes

object

Sammlung von Linkattributen.

rel

string

Beziehungstyp.

url

string

Link-URL.