Items - Delete Map

Hizmet:
Map
API Sürümü:
v1

Belirtilen Eşlemeyi siler.

Permissions

Çağıranın Eşleme için yazma izinlerine sahip olması gerekir.

Gerekli Temsilci Kapsamları

Item.ReadWrite.All

Microsoft Entra destekli kimlikler

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

Kimlik Support
User Yes
Hizmet sorumlusu ve yönetilen kimlikler Yes

Arayüz

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/maps/{mapId}
İsteğe bağlı parametrelerle: 
DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/maps/{mapId}?hardDelete={hardDelete}

URI Parametreleri

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

string (uuid)

Harita 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

İ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 a Map example
Hard delete a Map example

Delete a Map example

Örnek isteği

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

Örnek yanıt

Durum kodu:
200

Hard delete a Map example

Örnek isteği

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/maps/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ı.
isRetriable

boolean

True olduğunda istek yeniden denenebilir. Varsa gecikmeyi Retry-After belirlemek için yanıt üst bilgisini kullanın.
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ı.