Work Items - Delete

Service:

Work Item Tracking

API Version:

4.1

Löscht das angegebene Arbeitselement und sendet es an den Papierkorb, damit es bei Bedarf wiederhergestellt werden kann. Wenn der Destroy-Parameter auf true festgelegt wurde, wird das Arbeitselement optional dauerhaft zerstört.

DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?api-version=4.1

With optional parameters:

DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?destroy={destroy}&api-version=4.1

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
id	path	True	integer int32	ID des zu löschenden 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 "4.1" festgelegt werden, um diese Version der API zu verwenden.
destroy	query		boolean	Optionaler Parameter, wenn auf "true" festgelegt, wird das Arbeitselement endgültig gelöscht.

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_write	Ermöglicht das Lesen, Erstellen und Aktualisieren von Arbeitselementen und Abfragen, Aktualisieren von Boardmetadaten, Lesebereichs- und Iterationspfaden für andere Metadaten zur Nachverfolgung von Arbeitselementen, Ausführen von Abfragen und das Empfangen von Benachrichtigungen über Arbeitselementereignisse über Diensthaken.

Beispiele

Sample Request

HTTP

DELETE https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/workitems/{id}?api-version=4.1

Sample Response

Status code:

204

Definitionen

Name	Beschreibung
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
WorkItem	Beschreibt ein Arbeitselement.
WorkItemDelete	Vollständig gelöschtes Arbeitselementobjekt. Schließt das Arbeitselement selbst ein.
WorkItemRelation

ReferenceLinks

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.
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

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.