Work Items - Delete Work Items

Başvuru

Service:: Work Item Tracking

API Version:: 7.1-preview.1

Belirtilen iş öğelerini 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: Yok etme 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.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/workitemsdelete?api-version=7.1-preview.1

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
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 sürümü. Api'nin bu sürümünü kullanmak için bu değer '7.1-preview.1' olarak ayarlanmalıdır.

İstek Gövdesi

Name	Tür	Description
destroy	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.
ids	integer[]	İstenen iş öğesi kimlikleri
skipNotifications	boolean	İsteğe bağlı parametre, true olarak ayarlanırsa bildirimler devre dışı bırakılır.

Yanıtlar

Name	Tür	Description
200 OK	WorkItemDeleteBatch	başarılı işlem

Güvenlik

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	İş öğelerini ve sorgularını okuma, oluşturma ve güncelleştirme, pano meta verilerini güncelleştirme, alan ve yineleme yollarını diğer iş öğesi izlemeyle ilgili meta verileri izleme, sorguları yürütme ve hizmet kancaları aracılığıyla iş öğesi olayları hakkında bildirim alma olanağı verir.

Örnekler

Sample Request

HTTP

POST https://dev.azure.com/{organization}/_apis/wit/workitemsdelete?api-version=7.1-preview.1

{
  "ids": [
    28,
    29
  ],
  "destroy": true,
  "skipNotifications": true
}

Sample Response

Status code:: 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.
WorkItemDeleteBatch	Bir iş öğesi kümesini silme yanıtını açıklar.
WorkItemDeleteBatchRequest	Bir iş öğesi kümesini silme isteğini açıklar
WorkItemRelation

ReferenceLinks

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 göstermek istiyoruz.

WorkItem

bir iş öğesini açıklar.

Name	Tür	Description
_links	ReferenceLinks	İlgili REST kaynaklarına bağlantı başvuruları.
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	İş öğesi kimliği.
relations	WorkItemRelation[]	İş öğesinin ilişkileri.
rev	integer	İş öğesinin düzeltme numarası.
url	string

WorkItemCommentVersionRef

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

Name	Tür	Description
commentId	integer	Açıklamaya atanan kimlik.
createdInRevision	integer	[İç] Bu açıklamanın başlangıçta eklendiği iş öğesi düzeltmesi.
isDeleted	boolean	[İç] Açıklamanın silinip silinmeyeceğini belirtir.
text	string	[İç] Açıklama metni.
url	string
version	integer	Sürüm numarası.

WorkItemDelete

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

Name	Tür	Description
code	integer	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	İş öğ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

WorkItemDeleteBatch

Bir iş öğesi kümesini silme yanıtını açıklar.

Name	Tür	Description
results	WorkItemDelete[]	Her iş öğesi için sonuçların listesi

WorkItemDeleteBatchRequest

Bir iş öğesi kümesini silme isteğini açıklar

Name	Tür	Description
destroy	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.
ids	integer[]	İstenen iş öğesi kimlikleri
skipNotifications	boolean	İsteğe bağlı parametre, true olarak ayarlanırsa bildirimler devre dışı bırakılır.

WorkItemRelation

Name	Tür	Description
attributes	object	Bağlantı öznitelikleri koleksiyonu.
rel	string	İlişki türü.
url	string	Bağlantı URL'si.

Aracılığıyla paylaş