Work Items - Delete

Service:

Work Item Tracking

API Version:

6.0

Usuwa określony element roboczy i wysyła go do Kosza, aby można go było przywrócić, jeśli jest to wymagane. Opcjonalnie, jeśli parametr destroy został ustawiony na wartość true, spowoduje trwałe zniszczenie elementu roboczego. OSTRZEŻENIE: Jeśli parametr destroy ma wartość true, elementy robocze usunięte przez to polecenie NIE będą przechodzić do kosza i nie ma możliwości ich przywrócenia/odzyskania po usunięciu. Nie zaleca się używania tego parametru. Jeśli to zrobisz, użyj tego parametru z wyjątkową ostrożnością.

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

With optional parameters:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
id	path	True	integer int32	Identyfikator elementu roboczego do usunięcia
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
project	path		string	Identyfikator projektu lub nazwa projektu
api-version	query	True	string	Wersja interfejsu API do użycia. Należy ustawić wartość "6.0", aby używać tej wersji interfejsu API.
destroy	query		boolean	Opcjonalny parametr, jeśli ma wartość true, element roboczy zostanie trwale usunięty. Uwaga: akcja niszczenia jest TRWAŁA i nie można jej cofnąć.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	WorkItemDelete	operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa	Opis
vso.work_write	Umożliwia odczytywanie, tworzenie i aktualizowanie elementów roboczych i zapytań, aktualizowanie metadanych tablicy, ścieżki obszaru odczytu i iteracji innych metadanych powiązanych z elementami roboczymi, wykonywanie zapytań i odbieranie powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi.

Przykłady

Sample Request

HTTP

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

Sample Response

Status code:

204

Definicje

Nazwa	Opis
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
WorkItem	Opisuje element roboczy.
WorkItemCommentVersionRef	Reprezentuje odwołanie do określonej wersji komentarza dotyczącego elementu roboczego.
WorkItemDelete	Pełny usunięty obiekt elementu roboczego. Zawiera sam element roboczy.
WorkItemRelation

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Widok linków w trybie tylko do odczytu. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

WorkItem

Opisuje element roboczy.

Nazwa	Typ	Opis
_links	ReferenceLinks	Linki do powiązanych zasobów REST.
commentVersionRef	WorkItemCommentVersionRef	Odwołanie do określonej wersji komentarza dodanego/edytowanego/usuniętego w tej wersji.
fields	object	Mapa pól i wartości elementu roboczego.
id	integer	Identyfikator elementu roboczego.
relations	WorkItemRelation[]	Relacje elementu roboczego.
rev	integer	Numer poprawki elementu roboczego.
url	string

WorkItemCommentVersionRef

Reprezentuje odwołanie do określonej wersji komentarza dotyczącego elementu roboczego.

Nazwa	Typ	Opis
commentId	integer	Identyfikator przypisany do komentarza.
createdInRevision	integer	[Wewnętrzne] Poprawka elementu roboczego, w której ten komentarz został pierwotnie dodany.
isDeleted	boolean	[Wewnętrzne] Określa, czy komentarz został usunięty.
text	string	[Wewnętrzne] Tekst komentarza.
url	string
version	integer	Numer wersji.

WorkItemDelete

Pełny usunięty obiekt elementu roboczego. Zawiera sam element roboczy.

Nazwa	Typ	Opis
code	integer	Kod stanu HTTP operacji elementu roboczego w żądaniu wsadowym.
deletedBy	string	Użytkownik, który usunął typ elementu roboczego.
deletedDate	string	Data usunięcia elementu roboczego.
id	integer	Identyfikator elementu roboczego.
message	string	Komunikat o wyjątku operacji elementu roboczego w żądaniu wsadowym.
name	string	Nazwa lub tytuł elementu roboczego.
project	string	Nadrzędny projekt usuniętego elementu roboczego.
resource	WorkItem	Usunięty obiekt elementu roboczego.
type	string	Typ elementu roboczego.
url	string	Adres URL interfejsu API REST zasobu

WorkItemRelation

Nazwa	Typ	Opis
attributes	object	Kolekcja atrybutów łącza.
rel	string	Typ relacji.
url	string	Adres URL łącza.