Items - Delete Environment

Hizmet:: Environment

API Sürümü:: v1

Belirtilen ortamı siler.

İzinler

Çağıranın ortam için yazma izinlerine sahip olması gerekir.

Gerekli Temsilci Kapsamları

Environment.ReadWrite.All veya Item.ReadWrite.All

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	Evet

Arayüz

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Veri Akışı Adı	İçinde	Gerekli	Tür	Description
environmentId	path	True	string (uuid)	Ortam 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

Veri Akışı Adı Tür Description

200 OK

Veri Akışı Adı	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 environment example

Hard delete an environment example

Delete an environment example

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 200

Hard delete an environment example

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 200

Tanımlar

Veri Akışı Adı	Description
ErrorParameter	Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.

ErrorParameter

Nesne

Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.

Veri Akışı Adı	Tür	Description
message	string	Parametrenin anlamının insan tarafından okunabilen açıklaması.
name	string	Parametre tanımlayıcısı.
value	string	Parametre değeridir.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Veri Akışı Adı	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ı.

Veri Akışı Adı	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.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
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ı.

Veri Akışı Adı	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.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.