Work Items - Delete
Odstraní zadanou pracovní položku a odešle ji do koše, aby ji bylo možné v případě potřeby obnovit zpět. Volitelně pokud je parametr destroy nastaven na hodnotu true, pracovní položku trvale zničí. UPOZORNĚNÍ: Pokud je parametr destroy nastavený na hodnotu true, pracovní položky odstraněné tímto příkazem NEPŘEJDOU do koše a po odstranění neexistuje žádný způsob, jak je obnovit nebo obnovit. Tento parametr se doporučuje NEPOUŽÍVAT. Pokud ano, používejte tento parametr s mimořádnou opatrností.
DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?api-version=6.0
DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?destroy={destroy}&api-version=6.0
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
id
|
path | True |
integer int32 |
ID pracovní položky, která má být odstraněna |
organization
|
path | True |
string |
Název organizace Azure DevOps. |
project
|
path |
string |
ID projektu nebo název projektu |
|
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít. Tato verze rozhraní API by měla být nastavená na hodnotu 6.0. |
destroy
|
query |
boolean |
Volitelný parametr, pokud je nastavená hodnota true, pracovní položka se trvale odstraní. Poznámka: Akce zničení je PERMANENT A nelze ji vrátit zpět. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
úspěšná operace |
Zabezpečení
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
Name | Description |
---|---|
vso.work_write | Uděluje možnost číst, vytvářet a aktualizovat pracovní položky a dotazy, metadata aktualizačního panelu, oblast čtení a iterace cest k jiným metadatům souvisejícím se sledováním pracovních položek, spouštět dotazy a přijímat oznámení o událostech pracovních položek prostřednictvím zachytávání služeb. |
Příklady
Sample Request
DELETE https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/workitems/{id}?api-version=6.0
Sample Response
Definice
Name | Description |
---|---|
Reference |
Třída představující kolekci odkazů REST. |
Work |
Popisuje pracovní položku. |
Work |
Představuje odkaz na konkrétní verzi komentáře k pracovní položce. |
Work |
Zcela odstraněný objekt pracovní položky Zahrnuje samotnou pracovní položku. |
Work |
ReferenceLinks
Třída představující kolekci odkazů REST.
Name | Typ | Description |
---|---|---|
links |
object |
Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako odkazy jen pro čtení. |
WorkItem
Popisuje pracovní položku.
Name | Typ | Description |
---|---|---|
_links |
Odkazy na související prostředky REST. |
|
commentVersionRef |
Odkaz na konkrétní verzi komentáře přidaného, upraveného nebo odstraněného v této revizi |
|
fields |
object |
Mapa pole a hodnot pro pracovní položku |
id |
integer |
ID pracovní položky. |
relations |
Vztahy pracovní položky. |
|
rev |
integer |
Číslo revize pracovní položky. |
url |
string |
WorkItemCommentVersionRef
Představuje odkaz na konkrétní verzi komentáře k pracovní položce.
Name | Typ | Description |
---|---|---|
commentId |
integer |
ID přiřazené ke komentáři. |
createdInRevision |
integer |
[Interní] Revize pracovní položky, do které byl tento komentář původně přidán. |
isDeleted |
boolean |
[Interní] Určuje, jestli byl komentář odstraněn. |
text |
string |
[Interní] Text komentáře |
url |
string |
|
version |
integer |
Číslo verze. |
WorkItemDelete
Zcela odstraněný objekt pracovní položky Zahrnuje samotnou pracovní položku.
Name | Typ | Description |
---|---|---|
code |
integer |
Stavový kód HTTP pro operaci pracovní položky v dávkovém požadavku. |
deletedBy |
string |
Uživatel, který odstranil typ pracovní položky. |
deletedDate |
string |
Datum odstranění pracovní položky. |
id |
integer |
ID pracovní položky. |
message |
string |
Zpráva o výjimce pro operaci pracovní položky v dávkovém požadavku. |
name |
string |
Název nebo název pracovní položky |
project |
string |
Nadřazený projekt odstraněné pracovní položky. |
resource |
Objekt pracovní položky, který byl odstraněn. |
|
type |
string |
Typ pracovní položky. |
url |
string |
Adresa URL rozhraní REST API prostředku |
WorkItemRelation
Name | Typ | Description |
---|---|---|
attributes |
object |
Kolekce atributů odkazu. |
rel |
string |
Typ relace. |
url |
string |
Adresa URL odkazu. |
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro