Work Items - Delete

  • Başvuru
Hizmet:
Work Item Tracking
API Sürümü:
7.1

Belirtilen iş öğesini siler ve gerekirse geri yüklenebilmesi için Geri Dönüşüm Kutusu'na gönderir. İsteğe bağlı olarak, destroy parametresi true olarak ayarlandıysa, iş öğesini kalıcı olarak yok eder. UYARI: Destroy parametresi true olarak ayarlanırsa, bu komutla silinen iş öğeleri geri dönüşüm kutusuna GİDERİlMEYECEK ve silme işleminden sonra bunları geri yükleme/kurtarmanın hiçbir yolu yoktur. Bu parametrenin kullanılmaması önerilir. Bunu yaparsanız, lütfen bu parametreyi çok dikkatli kullanın.

DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?api-version=7.1
İsteğe bağlı parametrelerle: 
DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?destroy={destroy}&api-version=7.1

URI Parametreleri

Name İçinde Gerekli Tür Description
id
 path True

integer (int32)

Silinecek iş öğesinin kimliği
organization
 path True

string

Azure DevOps kuruluşunun adı.
project
 path

string

Proje kimliği veya proje adı
api-version
 query True

string

Kullanılacak API'nin sürümü. Bu, API'nin bu sürümünü kullanmak için '7.1' olarak ayarlanmalıdır.
destroy
 query

boolean

İsteğe bağlı parametresi true olarak ayarlanırsa, iş öğesi kalıcı olarak silinir. Lütfen unutmayın: Yok etme eylemi KALICIdır ve geri alınamaz.

Yanıtlar

Name Tür Description
200 OK

WorkItemDelete

başarılı işlem

Güvenlik

oauth2

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Belirteç URL'si: 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

Kapsamlar

Name Description
vso.work_write İş öğelerini ve sorgularını okuma, oluşturma ve güncelleştirme, pano meta verilerini güncelleştirme, okuma alanı ve yineleme yolları ile ilgili diğer iş öğesi izleme meta verilerini okuma, sorguları yürütme ve hizmet kancaları aracılığıyla iş öğesi olayları hakkında bildirim alma olanağı verir.

Örnekler

Örnek isteği

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

Örnek yanıt

Durum kodu:
204

Tanımlar

Name Description
ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
WorkItem

bir iş öğesini açıklar.
WorkItemCommentVersionRef

İş Öğesindeki bir açıklamanın belirli bir sürümüne başvuruyu temsil eder.
WorkItemDelete

Tam silinmiş iş öğesi nesnesi. İş öğesinin kendisini içerir.
WorkItemRelation
Object

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

Name Tür Description
links

object

Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak kullanıma açmak istiyoruz.

WorkItem

Object

bir iş öğesini açıklar.

Name Tür Description
_links

ReferenceLinks

Başvuruları ilgili REST kaynaklarına bağlayın.
commentVersionRef

WorkItemCommentVersionRef

Bu düzeltmede eklenen/düzenlenen/silinen açıklamanın belirli bir sürümüne başvuru.
fields

object

İş öğesi için alan ve değerlerin haritası.
id

integer (int32)

İş öğesi kimliği.
relations

WorkItemRelation[]

İş öğesinin ilişkileri.
rev

integer (int32)

İş öğesinin düzeltme numarası.
url

string

WorkItemCommentVersionRef

Object

İş Öğesindeki bir açıklamanın belirli bir sürümüne başvuruyu temsil eder.

Name Tür Description
commentId

integer (int32)

Açıklamaya atanan kimlik.
createdInRevision

integer (int32)

[İç] Bu açıklamanın ilk eklendiği iş öğesi düzeltmesi.
isDeleted

boolean

[İç] Açıklamanın silinip silinmeyeceğini belirtir.
text

string

[İç] Açıklamanın metni.
url

string

version

integer (int32)

Sürüm numarası.

WorkItemDelete

Object

Tam silinmiş iş öğesi nesnesi. İş öğesinin kendisini içerir.

Name Tür Description
code

integer (int32)

Bir toplu iş isteğindeki iş öğesi işleminin HTTP durum kodu.
deletedBy

string

İş öğesi türünü silmiş olan kullanıcı.
deletedDate

string

İş öğesi silme tarihi.
id

integer (int32)

İş öğesi kimliği.
message

string

Bir toplu iş isteğindeki iş öğesi işlemi için özel durum iletisi.
name

string

İş öğesinin adı veya başlığı.
project

string

Silinen iş öğesinin üst projesi.
resource

WorkItem

Silinen iş öğesi nesnesi.
type

string

İş öğesinin türü.
url

string

Kaynağın REST API URL'si

WorkItemRelation

Object
Name Tür Description
attributes

object

Bağlantı öznitelikleri koleksiyonu.
rel

string

İlişki türü.
url

string

Bağlantı URL'si.