Work Items - Delete Work Items
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 |
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
POST https://dev.azure.com/{organization}/_apis/wit/workitemsdelete?api-version=7.1-preview.1
{
"ids": [
28,
29
],
"destroy": true,
"skipNotifications": true
}
Sample Response
Tanımlar
Name | Description |
---|---|
Reference |
REST başvuru bağlantıları koleksiyonunu temsil eden sınıf. |
Work |
bir iş öğesini açıklar. |
Work |
İş Öğesindeki bir açıklamanın belirli bir sürümüne başvuruyu temsil eder. |
Work |
Tam silinmiş iş öğesi nesnesi. İş öğesinin kendisini içerir. |
Work |
Bir iş öğesi kümesini silme yanıtını açıklar. |
Work |
Bir iş öğesi kümesini silme isteğini açıklar |
Work |
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 |
İlgili REST kaynaklarına bağlantı başvuruları. |
|
commentVersionRef |
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 |
İş öğ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 |
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 |
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. |
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin