Groups - Update Group User

Hizmet:

Power BI REST APIs

API Sürümü:

v1.0

Belirtilen çalışma alanı için belirtilen kullanıcı izinlerini Güncelleştirmeler.

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

PUT 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	Sorumlu 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 çok kiracılı Power BI Embedded çö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

Örnek isteği

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

İstek Gövdesi

{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

Örnek yanıt

Durum kodu:

200

Example

Örnek isteği

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

İstek Gövdesi

{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Örnek yanıt

Durum kodu:

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	Sorumlu türü
ServicePrincipalProfile	Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.

GroupUser

Object

Ç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	Sorumlu türü
profile	ServicePrincipalProfile	Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.
userType	string	Kullanıcının türü.

GroupUserAccessRight

Enumeration

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

Değer	Description
Admin	Çalışma alanı içeriği için yönetici hakları
Contributor	Çalışma alanı içeriğine erişimi okuma ve keşfetme (ReadExplore)
Member	Çalışma alanı içeriğine erişim haklarını okuma, yeniden paylaşma ve keşfetme (ReadReshareExplore)
None	Çalışma alanı içeriğine erişim yok
Viewer	Çalışma alanı içeriğine salt okunur (Okuma) erişimi

PrincipalType

Enumeration

Sorumlu türü

Değer	Description
App	Hizmet sorumlusu türü
Group	Grup sorumlusu türü
None	Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın.
User	Kullanıcı asıl türü

ServicePrincipalProfile

Object

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

Name	Tür	Description
displayName	string	Hizmet sorumlusu profil adı
id	string	Hizmet sorumlusu profil kimliği