Workspaces - Add Workspace Role Assignment

Hizmet:: Core

API Sürümü:: v1

Çalışma alanı rol ataması ekler.
İstek gövdesi için gereken asıl kullanıcı nesne kimliğini almak için bkz. Kullanıcı nesne kimliğini bulma.

İzinler

Çağıranın üye veya daha yüksek çalışma alanı rolü olmalıdır.
Üyeler, daha düşük izinlere sahip üyeler veya diğerleri ekleyebilir. Daha fazla bilgi için bkz. çalışma alanı rolleri.

Gerekli Temsilci Kapsamları

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

Sınırlamalar

Her çalışma alanı, çalışma alanı rollerindeki (Yönetici, Üye, Katkıda Bulunan, Görüntüleyici) en fazla 1.000 kullanıcı veya grupla sınırlıdır. Bir grup içindeki kullanıcı sayısı sınırlı değildir. Sınırlama, dış konukları da kapsar.

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

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

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
principal	True	Principal: UserPrincipal ServicePrincipalPrincipal GroupPrincipal ServicePrincipalProfilePrincipal EntireTenantPrincipal	Müdür.
role	True	WorkspaceRole	Sorumlunun çalışma alanı rolü.

Yanıtlar

Name Tür Description

201 Created

Name	Tür	Description
201 Created	WorkspaceRoleAssignment	Başarıyla oluşturuldu. Üst Bilgiler Location: string
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ı: UnknownError - Bir hata oluştu.

WorkspaceRoleAssignment

Başarıyla oluşturuldu.

Üst Bilgiler

Location: string

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ı:

UnknownError - Bir hata oluştu.

Örnekler

Add workspace role assignment example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff512/roleAssignments

{
  "principal": {
    "id": "8eedb1b0-3af8-4b17-8e7e-663e61e12211",
    "type": "User"
  },
  "role": "Member"
}

Örnek yanıt

Durum kodu:: 201

Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff512/roleAssignments/8eedb1b0-3af8-4b17-8e7e-663e61e12211

{
  "id": "8eedb1b0-3af8-4b17-8e7e-663e61e12211",
  "principal": {
    "id": "8eedb1b0-3af8-4b17-8e7e-663e61e12211",
    "type": "User"
  },
  "role": "Member"
}

Tanımlar

Name	Description
AddWorkspaceRoleAssignmentRequest	Çalışma alanı rolü atama isteği yükü ekleyin.
EntireTenantPrincipal	Kiracı sorumlusunu temsil eder
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
GroupDetails	Belirli ayrıntıları gruplandırma. Sorumlu türü `Group`olduğunda geçerlidir.
GroupPrincipal	Bir güvenlik grubunu temsil eder.
GroupType	Grubun türü. Zaman içinde ek grup türleri eklenebilir.
PrincipalType	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.
ServicePrincipalDetails	Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü `ServicePrincipal`olduğunda geçerlidir.
ServicePrincipalPrincipal	Microsoft Entra hizmet sorumlusunu temsil eder.
ServicePrincipalProfileDetails	Hizmet sorumlusu profili ayrıntıları. Sorumlu türü `ServicePrincipalProfile`olduğunda geçerlidir.
ServicePrincipalProfilePrincipal	Hizmet sorumlusu profilini temsil eder.
UserDetails	Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü `User`olduğunda geçerlidir.
UserPrincipal	Microsoft Entra kullanıcı sorumlusunu temsil eder.
WorkspaceRole	Çalışma alanı rolü. Zaman içinde ek çalışma alanı rolleri eklenebilir.
WorkspaceRoleAssignment	Çalışma alanı rol atama nesnesi.

AddWorkspaceRoleAssignmentRequest

Nesne

Çalışma alanı rolü atama isteği yükü ekleyin.

Name	Tür	Description
principal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Müdür.
role	WorkspaceRole	Sorumlunun çalışma alanı rolü.

EntireTenantPrincipal

Nesne

Kiracı sorumlusunu temsil eder

Name	Tür	Description
displayName	string	Sorumlunun görünen adı.
id	string (uuid)	Sorumlunun kimliği.
type	string: EntireTenant	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

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ı.

GroupDetails

Nesne

Belirli ayrıntıları gruplandırma. Sorumlu türü Groupolduğunda geçerlidir.

Name	Tür	Description
groupType	GroupType	Grubun türü. Zaman içinde ek grup türleri eklenebilir.

GroupPrincipal

Nesne

Bir güvenlik grubunu temsil eder.

Name	Tür	Description
displayName	string	Sorumlunun görünen adı.
groupDetails	GroupDetails	Belirli ayrıntıları gruplandırma. Sorumlu türü `Group`olduğunda geçerlidir.
id	string (uuid)	Sorumlunun kimliği.
type	string: Group	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

GroupType

Numaralandırma

Grubun türü. Zaman içinde ek grup türleri eklenebilir.

Değer	Description
Unknown	Asıl grup türü bilinmiyor.
SecurityGroup	Sorumlu bir güvenlik grubudur.
DistributionList	Sorumlu bir dağıtım listesidir.

PrincipalType

Numaralandırma

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

Değer	Description
User	Sorumlu bir Microsoft Entra kullanıcı sorumlusudur.
ServicePrincipal	Sorumlu bir Microsoft Entra hizmet sorumlusudur.
Group	Sorumlu bir güvenlik grubudur.
ServicePrincipalProfile	Sorumlu bir hizmet sorumlusu profilidir.
EntireTenant	Sorumlu, tüm kiracı kullanıcılarını temsil eder.

ServicePrincipalDetails

Nesne

Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü ServicePrincipalolduğunda geçerlidir.

Name	Tür	Description
aadAppId	string (uuid)	Hizmet sorumlusunun Microsoft Entra AppId değeridir.

ServicePrincipalPrincipal

Nesne

Microsoft Entra hizmet sorumlusunu temsil eder.

Name	Tür	Description
displayName	string	Sorumlunun görünen adı.
id	string (uuid)	Sorumlunun kimliği.
servicePrincipalDetails	ServicePrincipalDetails	Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü `ServicePrincipal`olduğunda geçerlidir.
type	string: ServicePrincipal	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

ServicePrincipalProfileDetails

Nesne

Hizmet sorumlusu profili ayrıntıları. Sorumlu türü ServicePrincipalProfileolduğunda geçerlidir.

Name	Tür	Description
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Hizmet sorumlusu profilinin üst sorumlusu.

ServicePrincipalProfilePrincipal

Nesne

Hizmet sorumlusu profilini temsil eder.

Name	Tür	Description
displayName	string	Sorumlunun görünen adı.
id	string (uuid)	Sorumlunun kimliği.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Hizmet sorumlusu profili ayrıntıları. Sorumlu türü `ServicePrincipalProfile`olduğunda geçerlidir.
type	string: ServicePrincipalProfile	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

UserDetails

Nesne

Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü Userolduğunda geçerlidir.

Name	Tür	Description
userPrincipalName	string	Kullanıcı asıl adı.

UserPrincipal

Nesne

Microsoft Entra kullanıcı sorumlusunu temsil eder.

Name	Tür	Description
displayName	string	Sorumlunun görünen adı.
id	string (uuid)	Sorumlunun kimliği.
type	string: User	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.
userDetails	UserDetails	Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü `User`olduğunda geçerlidir.

WorkspaceRole

Numaralandırma

Çalışma alanı rolü. Zaman içinde ek çalışma alanı rolleri eklenebilir.

Değer	Description
Admin	Çalışma alanına yönetici erişimi sağlar.
Member	Çalışma alanına üyelik erişimini etkinleştirir.
Contributor	Çalışma alanına katkı sağlar.
Viewer	Çalışma alanının görüntülenmesini sağlar.

WorkspaceRoleAssignment

Nesne

Çalışma alanı rol atama nesnesi.

Name	Tür	Description
id	string (uuid)	Çalışma alanı rol atama kimliği.
principal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Müdür.
role	WorkspaceRole	Sorumlunun çalışma alanı rolü.