Work Items - Delete

Service:

Work Item Tracking

API Version:

4.1

Exclui o item de trabalho especificado e o envia para a Lixeira, para que ele possa ser restaurado novamente, se necessário. Opcionalmente, se o parâmetro destroy tiver sido definido como true, ele destruirá o item de trabalho permanentemente.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
id	path	True	integer int32	ID do item de trabalho a ser excluído
organization	path	True	string	O nome da organização do Azure DevOps.
project	path		string	ID do projeto ou nome do projeto
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '4.1' para usar essa versão da api.
destroy	query		boolean	Parâmetro opcional, se definido como true, o item de trabalho é excluído permanentemente

Respostas

Nome	Tipo	Description
200 OK	WorkItemDelete	operação bem-sucedida

Segurança

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	Description
vso.work_write	Concede a capacidade de ler, criar e atualizar itens de trabalho e consultas, atualizar metadados do quadro, ler caminhos de área e iterações de outros itens de trabalho que acompanham metadados relacionados, executar consultas e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço.

Exemplos

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

Definições

Nome	Description
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
WorkItem	Descreve um item de trabalho.
WorkItemDelete	Objeto de item de trabalho excluído completo. Inclui o item de trabalho em si.
WorkItemRelation

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

WorkItem

Descreve um item de trabalho.

Nome	Tipo	Description
_links	ReferenceLinks	Vincular referências a recursos REST relacionados.
fields	object	Mapa de campos e valores para o item de trabalho.
id	integer	O ID do item de trabalho.
relations	WorkItemRelation[]	Relações do item de trabalho.
rev	integer	Número de revisão do item de trabalho.
url	string

WorkItemDelete

Objeto de item de trabalho excluído completo. Inclui o item de trabalho em si.

Nome	Tipo	Description
code	integer	O código http status para a operação de item de trabalho em uma solicitação em lote.
deletedBy	string	O usuário que excluiu o tipo de item de trabalho.
deletedDate	string	A data de exclusão do item de trabalho.
id	integer	ID do item de trabalho.
message	string	A mensagem de exceção para a operação de item de trabalho em uma solicitação em lote.
name	string	Nome ou título do item de trabalho.
project	string	Projeto pai do item de trabalho excluído.
resource	WorkItem	O objeto de item de trabalho que foi excluído.
type	string	Tipo de item de trabalho.
url	string	URL da API REST do recurso

WorkItemRelation

Nome	Tipo	Description
attributes	object	Coleção de atributos de link.
rel	string	Tipo de relação.
url	string	Url do link.