Work Items - Delete
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.0DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?destroy={destroy}&api-version=5.0URI-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 |
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_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
Beispielanforderung
DELETE https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/workitems/{id}?api-version=5.0
Beispiel für eine Antwort
Definitionen
| Name | Beschreibung |
|---|---|
|
Reference |
Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt. |
|
Work |
Beschreibt ein Arbeitselement. |
|
Work |
Vollständig gelöschtes Arbeitselementobjekt. Schließt das Arbeitselement selbst ein. |
|
Work |
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 |
Links zu verwandten REST-Ressourcen. |
|
| fields |
object |
Zuordnung von Feld und Werten für das Arbeitselement. |
| id |
integer |
Die Arbeitselement-ID. |
| relations |
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 |
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. |