Udostępnij za pośrednictwem


Work Items - Delete

Usuwa określony element roboczy i wysyła go do Kosza, aby można było go 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 jest ustawiony na wartość true, elementy robocze usunięte przez to polecenie nie będą przechodzić do kosza i nie ma możliwości przywrócenia/odzyskania ich po usunięciu. Zaleca się, aby nie używać 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=7.1-preview.3
DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?destroy={destroy}&api-version=7.1-preview.3

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. Powinno to być ustawione na wartość "7.1-preview.3", aby używać tej wersji interfejsu API.

destroy
query

boolean

Opcjonalny parametr, jeśli ustawiono wartość true, element roboczy zostanie trwale usunięty. Uwaga: akcja zniszczenia jest STAŁ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ń, metadanych tablicy aktualizacji, ścieżek obszaru odczytu i iteracji innych metadanych powiązanych elementów roboczych, wykonywania zapytań i odbierania powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi.

Przykłady

Sample Request

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

Sample Response

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

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

Nazwa Typ Opis
links

object

Czytelny widok linków. Ponieważ linki referencyjne są czytelne, chcemy uwidocznić je tylko jako tylko do odczytu.

WorkItem

Opisuje element roboczy.

Nazwa Typ Opis
_links

ReferenceLinks

Połącz odwołania 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ętrzny] Poprawka elementu roboczego, w której ten komentarz został pierwotnie dodany.

isDeleted

boolean

[Wewnętrzny] Określa, czy komentarz został usunięty.

text

string

[Wewnętrzny] 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 dla operacji elementu roboczego w żądaniu wsadowym.

name

string

Nazwa lub tytuł elementu roboczego.

project

string

Nadrzędny projekt usuniętego elementu roboczego.

resource

WorkItem

Obiekt elementu roboczego, który został usunięty.

type

string

Typ elementu roboczego.

url

string

Adres URL interfejsu API REST zasobu

WorkItemRelation

Nazwa Typ Opis
attributes

object

Kolekcja atrybutów linku.

rel

string

Typ relacji.

url

string

Adres URL łącza.