Aracılığıyla paylaş

Admin - Groups AddUserAsAdmin

  • Başvuru
Hizmet:
Power BI REST APIs
API Sürümü:
v1.0

Belirtilen çalışma alanına kullanıcı izinleri verir.

Bu API çağrısı yalnızca kullanıcı, güvenlik grubu, M365 grubu ve hizmet sorumlusu eklemeyi destekler.

İzinler

Kullanıcının yönetici haklarına (Office 365 Genel Yönetici veya Power BI Hizmet Yöneticisi gibi) sahip olması gerekir.

Gerekli Kapsam

Tenant.ReadWrite.All

Sınırlamalar

Saatte en fazla 200 istek. 

POST https://api.powerbi.com/v1.0/myorg/admin/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

Add security group to workspace example
Add service principal to workspace example
Add user to group example

Add security group to workspace example

Örnek isteği

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
İstek Gövdesi
{
  "identifier": "ece007fa-2f19-4df1-bdd5-539881ec5f83",
  "principalType": "Group",
  "groupUserAccessRight": "Member"
}

Örnek yanıt

Durum kodu:
200

Add service principal to workspace example

Örnek isteği

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
İstek Gövdesi
{
  "identifier": "84c468ad-12f1-471e-af6f-0999da422391",
  "principalType": "App",
  "groupUserAccessRight": "Viewer"
}

Örnek yanıt

Durum kodu:
200

Add user to group example

Örnek isteği

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/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

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