Aracılığıyla paylaş

Groups - Add Group User

  • Başvuru
Service:
Power BI REST APIs
API Version:
v1.0

Belirtilen kullanıcıya belirtilen çalışma alanı için belirtilen izinleri verir.

İzinler

Bu API çağrısı bir hizmet sorumlusu profili tarafından çağrılabilir. Daha fazla bilgi için bkz. Power BI Embedded hizmet sorumlusu profilleri.

Gerekli Kapsam

Workspace.ReadWrite.All

Sınırlamalar

  • Çalışma alanlarının kullanıcı izinlerinin güncelleştirilmesi zaman alır ve API çağrıları kullanılırken hemen kullanılamayabilir. Kullanıcı izinlerini yenilemek için Kullanıcı İzinlerini Yenile API çağrısını kullanın. 

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users

URI Parametreleri

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

string

uuid

Çalışma alanı kimliği

İstek Gövdesi

Name Gerekli Tür Description
groupUserAccessRight True

GroupUserAccessRight

Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)
identifier True

string

Sorumlunun tanımlayıcısı
principalType True

PrincipalType

Asıl tür
displayName

string

Sorumlunun görünen adı
emailAddress

string

Kullanıcının e-posta adresi
graphId

string

Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.
profile

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir.
userType

string

Kullanıcının türü.

Yanıtlar

Name Tür Description
200 OK

Tamam

Örnekler

Assign administrator user access rights to a service principal example
Example

Assign administrator user access rights to a service principal example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Request Body
{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

Sample Response

Status code:
200

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Request Body
{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Sample Response

Status code:
200

Tanımlar

Name Description
GroupUser

Çalışma alanına erişimi olan bir Power BI kullanıcısı
GroupUserAccessRight

Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)
PrincipalType

Asıl tür
ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir.

GroupUser

Çalışma alanına erişimi olan bir Power BI kullanıcısı

Name Tür Description
displayName

string

Sorumlunun görünen adı
emailAddress

string

Kullanıcının e-posta adresi
graphId

string

Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.
groupUserAccessRight

GroupUserAccessRight

Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)
identifier

string

Sorumlunun tanımlayıcısı
principalType

PrincipalType

Asıl tür
profile

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir.
userType

string

Kullanıcının türü.

GroupUserAccessRight

Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)

Name Tür Description
Admin

string

Çalışma alanı içeriği için yönetici hakları
Contributor

string

Çalışma alanı içeriğine okuma ve keşfetme (ReadExplore) erişimi
Member

string

Çalışma alanı içeriğine erişim haklarını okuma, yeniden paylaşma ve keşfetme (ReadReshareExplore)
None

string

Çalışma alanı içeriğine erişim yok
Viewer

string

Çalışma alanı içeriğine salt okunur (Okuma) erişimi

PrincipalType

Asıl tür

Name Tür Description
App

string

Hizmet sorumlusu türü
Group

string

Grup sorumlusu türü
None

string

Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın.
User

string

Kullanıcı asıl türü

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir.

Name Tür Description
displayName

string

Hizmet sorumlusu profil adı
id

string

Hizmet sorumlusu profil kimliği