Work Items - Delete

Referenz

Service:: Work Item Tracking

API Version:: 5.0

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=5.0

With optional parameters:

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

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 "5.0" festgelegt werden, um diese Version der API zu verwenden.
destroy	query		boolean	Optionaler Parameter, wenn auf TRUE festgelegt, wird das Arbeitselement dauerhaft 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 im Zusammenhang mit der Nachverfolgung von Arbeitselementen, Ausführen von Abfragen und das Empfangen von Benachrichtigungen zu Arbeitselementereignissen über Diensthooks.

Beispiele

Sample Request

HTTP

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

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ützter Sind, möchten wir sie nur als schreibgeschützter Link verfügbar machen.

WorkItem

Beschreibt ein Arbeitselement.

Name	Typ	Beschreibung
_links	ReferenceLinks	Links zu verwandten 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 den 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.

Freigeben über