Work Items - Delete

Service:

Work Item Tracking

API Version:

4.1

Elimina l'elemento di lavoro specificato e lo invia al Cestino, in modo che possa essere ripristinato, se necessario. Facoltativamente, se il parametro destroy è stato impostato su true, l'elemento di lavoro viene eliminato definitivamente.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
id	path	True	integer int32	ID dell'elemento di lavoro da eliminare
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
project	path		string	ID progetto o nome del progetto
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '4.1' per usare questa versione dell'API.
destroy	query		boolean	Parametro facoltativo, se impostato su true, l'elemento di lavoro viene eliminato definitivamente

Risposte

Nome	Tipo	Descrizione
200 OK	WorkItemDelete	operazione riuscita

Sicurezza

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

Nome	Descrizione
vso.work_write	Concede la possibilità di leggere, creare e aggiornare elementi di lavoro e query, aggiornare i metadati della scheda, l'area di lettura e le iterazioni dei percorsi di altri metadati correlati al rilevamento degli elementi di lavoro, eseguire query e ricevere notifiche sugli eventi degli elementi di lavoro tramite hook del servizio.

Esempio

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

Definizioni

Nome	Descrizione
ReferenceLinks	Classe per rappresentare una raccolta di collegamenti di riferimento REST.
WorkItem	Descrive un elemento di lavoro.
WorkItemDelete	Oggetto elemento di lavoro eliminato completo. Include l'elemento di lavoro stesso.
WorkItemRelation

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome	Tipo	Descrizione
links	object	Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

WorkItem

Descrive un elemento di lavoro.

Nome	Tipo	Descrizione
_links	ReferenceLinks	Collegare i riferimenti alle risorse REST correlate.
fields	object	Mappa di campi e valori per l'elemento di lavoro.
id	integer	ID elemento di lavoro.
relations	WorkItemRelation[]	Relazioni dell'elemento di lavoro.
rev	integer	Numero di revisione dell'elemento di lavoro.
url	string

WorkItemDelete

Oggetto elemento di lavoro eliminato completo. Include l'elemento di lavoro stesso.

Nome	Tipo	Descrizione
code	integer	Codice di stato HTTP per l'operazione dell'elemento di lavoro in una richiesta batch.
deletedBy	string	Utente che ha eliminato il tipo di elemento di lavoro.
deletedDate	string	Data di eliminazione dell'elemento di lavoro.
id	integer	ID elemento di lavoro.
message	string	Messaggio di eccezione per l'operazione dell'elemento di lavoro in una richiesta batch.
name	string	Nome o titolo dell'elemento di lavoro.
project	string	Progetto padre dell'elemento di lavoro eliminato.
resource	WorkItem	Oggetto elemento di lavoro eliminato.
type	string	Tipo di elemento di lavoro.
url	string	URL DELL'API REST della risorsa

WorkItemRelation

Nome	Tipo	Descrizione
attributes	object	Raccolta di attributi di collegamento.
rel	string	Tipo di relazione.
url	string	URL di collegamento.