Aracılığıyla paylaş

Groups - Update Group User

  • Başvuru
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