Items - Delete Item

Hizmet:: Core

API Sürümü:: v1

Belirtilen öğeyi siler.
Bu API bir dizi öğe türü için desteklenir, desteklenen öğe türlerini ve tanım yapısı hakkındaki bilgileri Öğe yönetimine genel bakış. Varsayılan davranış, desteklenen öğe türleri için öğeyi geçici olarak silmektir.

Uyarı

Geçici olarak silinen öğeler, her çalışma alanında izin verilen en fazla öğe sayısına doğru sayılır.

İzinler

Geçici silme için çağıranın öğe için yazma izinlerine sahip olması gerekir. Arayan, sabit/kalıcı silme için atanmış çalışma alanı Yöneticisi rolüne sahip olmalıdır.

Gerekli Temsilci Kapsamları

Öğe API'leri için şu kapsam türlerini kullanın:

Genel kapsam: Item.ReadWrite.All
Belirli kapsam: itemType. ReadWrite.All (örneğin: Notebook.ReadWrite.All)

Kapsamlar hakkında daha fazla bilgi için kapsamlar makalesine bakın.

Microsoft Entra destekli kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik	Destek
Kullanıcı	Evet
Hizmet sorumlusu ve yönetilen kimlikler	Çağrıdaki öğe türü desteklendiğinde. Aramanızın desteklenip desteklenmediğini görmek için çağırdığınız öğe türü için ilgili API'yi denetleyin. Örneğin, anlamsal modeller desteklenir.

Arayüz

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}

İsteğe bağlı parametrelerle:

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}?hardDelete={hardDelete}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
itemId	path	True	string (uuid)	Öğe kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.
hardDelete	query		boolean	Sabit silme gerçekleştirilip gerçekleştirilmeyeceğini belirtir. olarak ayarlandığında `true`, öğe kalıcı olarak silinir ve kurtarılamaz. Olarak ayarlandığında `false` veya belirtilmediğinde, öğe türü destekliyorsa öğe geçici olarak silinir.

Yanıtlar

Name Tür Description

200 OK

Name	Tür	Description
200 OK		İstek başarıyla tamamlandı.
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir `Retry-After` üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: ItemNotFound - İstenen öğe bulunamadı. InsufficientWorkspaceRole - Kullanıcının yeterli çalışma alanı rolü yok. FeatureNotAvailable - Bunun nedeni geçici silme özelliğinin kullanılamaması olabilir. UnsupportedItemType - Bunun nedeni istenen öğe türü tarafından desteklenmeyen geçici silme özelliği olabilir. TenantSwitchDisabled - Bunun nedeni geçici silme özelliğinin kiracı yöneticisi tarafından devre dışı bırakılması olabilir. InvalidTargetItemStateForSoftDeletion - Öğe geçici silme için geçersiz durumda. InvalidParentItemStateForSoftDeletion - Öğenin üst öğesi Etkin durumda değil.

İstek başarıyla tamamlandı.

429 Too Many Requests

ErrorResponse

Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür.

Üst Bilgiler

Retry-After: integer

Other Status Codes

ErrorResponse

Yaygın hata kodları:

ItemNotFound - İstenen öğe bulunamadı.
InsufficientWorkspaceRole - Kullanıcının yeterli çalışma alanı rolü yok.
FeatureNotAvailable - Bunun nedeni geçici silme özelliğinin kullanılamaması olabilir.
UnsupportedItemType - Bunun nedeni istenen öğe türü tarafından desteklenmeyen geçici silme özelliği olabilir.
TenantSwitchDisabled - Bunun nedeni geçici silme özelliğinin kiracı yöneticisi tarafından devre dışı bırakılması olabilir.
InvalidTargetItemStateForSoftDeletion - Öğe geçici silme için geçersiz durumda.
InvalidParentItemStateForSoftDeletion - Öğenin üst öğesi Etkin durumda değil.

Örnekler

Delete an item example

Hard delete an item example

Delete an item example

Örnek isteği

HTTP

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715

Örnek yanıt

Durum kodu:: 200

Hard delete an item example

Örnek isteği

HTTP

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715?hardDelete=True

Örnek yanıt

Durum kodu:: 200

Tanımlar

Name	Description
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.