Admin - Profiles GetProfilesAsAdmin

Dienst:

Power BI REST APIs

API-Version:

v1.0

Gibt eine Liste der Dienstprinzipalprofile für die Organisation zurück.

Erlaubnisse

Der Benutzer muss ein Fabric-Administrator sein oder sich mit einem Dienstprinzipal authentifizieren.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Begrenzungen

Maximal 200 Anforderungen pro Stunde.

GET https://api.powerbi.com/v1.0/myorg/admin/profiles

Mit optionalen Parametern:

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. Wird mit oben verwendet, um Ergebnisse über die ersten 5000 abzurufen.
$top	query		integer int32	Gibt nur die ersten n Ergebnisse zurück. Dieser Parameter muss sich im Bereich von 1-5000 befinden.

Antworten

Name	Typ	Beschreibung
200 OK	AdminServicePrincipalProfiles	OKAY

Beispiele

Get a specific service principal profile by id using filter

Get service principal profiles by their parent servicePrincipalId using filter

Get a specific service principal profile by id using filter

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/admin/profiles?$filter=id%20eq%20'3b211778-e7a5-4d73-8187-f10824047724'

Beispiel für eine Antwort

Statuscode:

200

{
  "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

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/admin/profiles?$filter=servicePrincipalId%20eq%20'12345678-e7a5-4d73-8187-f10824041234'

Beispiel für eine Antwort

Statuscode:

200

{
  "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
AdminServicePrincipalProfile	Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.
AdminServicePrincipalProfiles	Odata-Antwortwrapper für eine Power BI-Dienstprinzipalprofilsammlung.

AdminServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

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

Name	Typ	Beschreibung
odata.context	string	OData-Kontext
value	AdminServicePrincipalProfile[]	Die Dienstprinzipalprofilsammlung