Workspaces - Assign Workspace Encryption

Hizmet:: Core

API Sürümü:: v1

Çalışma alanına bir Customer-Managed Anahtarı (CMK) atar.
Çalışma alanı için CMK şifrelemesini etkinleştirir veya çalışma alanının şifreleme anahtarını döndürür.

İzinler

Çağıranın bir yönetici çalışma alanı rolü olmalıdır.

Gerekli Devredilen Kapsamlar

Çalışma Alanı.OkumaYazma.Tümü

Microsoft Entra destekli kimlikler

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

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

Arayüz

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/encryption/assign

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.

İstek Gövdesi

Name	Gerekli	Tür	Description
keyIdentifier	True	string	Azure Key Vault anahtar tanımlayıcısı. Bu sürümsüz anahtar URI'si olmalıdır.

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	Sık karşılaşılan hata kodları: UnknownError - Bir hata oluştu.

İ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

Sık karşılaşılan hata kodları:

UnknownError - Bir hata oluştu.

Örnekler

Assign workspace CMK encryption example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/encryption/assign

{
  "keyIdentifier": "https://westus07112025-cmktest1.vault.azure.net/keys/test2k/"
}

Örnek yanıt

Durum kodu:: 200

Tanımlar

Name	Description
AssignWorkspaceEncryptionRequest	Çalışma Alanı CMK Şifrelemesi Atama isteği yükü.
ErrorRelatedResource	Hata ile ilişkili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.

AssignWorkspaceEncryptionRequest

Nesne

Çalışma Alanı CMK Şifrelemesi Atama isteği yükü.

Name	Tür	Description
keyIdentifier	string	Azure Key Vault anahtar tanımlayıcısı. Bu sürümsüz anahtar URI'si olmalıdır.

ErrorRelatedResource

Nesne

Hata ile ilişkili 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 insan tarafından okunabilir bir temsilidir.
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 insan tarafından okunabilir bir temsilidir.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.