Admin - Profiles GetProfilesAsAdmin
Gibt eine Liste von Dienstprinzipalprofilen für die Organisation zurück.
Berechtigungen
Der Benutzer muss über Administratorrechte verfügen oder sich mit einem Dienstprinzipal authentifizieren.
Erforderlicher Bereich
Tenant.Read.All oder Tenant.ReadWrite.All
GET https://api.powerbi.com/v1.0/myorg/admin/profiles
GET https://api.powerbi.com/v1.0/myorg/admin/profiles?$filter={$filter}&$top={$top}&$skip={$skip}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
$filter
|
query |
string |
Filtert die Ergebnisse basierend auf einer booleschen Bedingung mithilfe von "id", "displayName" oder "servicePrincipalId". Unterstützt nur den Operator "eq". |
|
$skip
|
query |
integer int32 |
Überspringt die ersten n Ergebnisse. Verwenden Sie mit top, um Ergebnisse über die ersten 5000 hinaus abzurufen. |
|
$top
|
query |
integer int32 |
Gibt nur die ersten n Ergebnisse zurück. Dieser Parameter muss im Bereich von 1 bis 5000 liegen. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK |
Beispiele
Get a specific service principal profile by id using filter |
Get service principal profiles by their parent service |
Get a specific service principal profile by id using filter
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/profiles?$filter=id%20eq%20'3b211778-e7a5-4d73-8187-f10824047724'
Sample Response
{
"value": [
{
"id": "3b211778-e7a5-4d73-8187-f10824047724",
"displayName": "My new profile",
"servicePrincipalId": "12345678-e7a5-4d73-8187-f10824041234"
}
]
}
Get service principal profiles by their parent servicePrincipalId using filter
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/profiles?$filter=servicePrincipalId%20eq%20'12345678-e7a5-4d73-8187-f10824041234'
Sample Response
{
"value": [
{
"id": "3b211778-e7a5-4d73-8187-f10824047724",
"displayName": "My new profile",
"servicePrincipalId": "12345678-e7a5-4d73-8187-f10824041234"
},
{
"id": "43211778-e7a5-4d73-8187-f10824044321",
"displayName": "My new profile2",
"servicePrincipalId": "12345678-e7a5-4d73-8187-f10824041234"
}
]
}
Definitionen
Name | Beschreibung |
---|---|
Admin |
Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung. |
Admin |
Odata-Antwortwrapper für eine Power BI-Dienst Prinzipalprofilsammlung. |
AdminServicePrincipalProfile
Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.
Name | Typ | Beschreibung |
---|---|---|
displayName |
string |
Der Dienstprinzipalprofilname |
id |
string |
Die Dienstprinzipalprofil-ID |
servicePrincipalId |
string |
Die Dienstprinzipal-ID |
AdminServicePrincipalProfiles
Odata-Antwortwrapper für eine Power BI-Dienst Prinzipalprofilsammlung.
Name | Typ | Beschreibung |
---|---|---|
odata.context |
string |
OData-Kontext |
value |
Die Dienstprinzipalprofilsammlung |