Admin - Profiles GetProfilesAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Zwraca listę profilów jednostki usługi dla organizacji.

Uprawnienia

Użytkownik musi mieć uprawnienia administratora lub uwierzytelnić się przy użyciu jednostki usługi.

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

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

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/profiles?$filter={$filter}&$top={$top}&$skip={$skip}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
$filter	query		string	Filtruje wyniki na podstawie warunku logicznego, używając wartości "id", "displayName" lub "servicePrincipalId". Obsługuje tylko operator "eq".
$skip	query		integer int32	Pomija pierwsze n wyników. Użyj funkcji z góry, aby pobrać wyniki poza pierwszym 5000.
$top	query		integer int32	Zwraca tylko pierwsze n wyników. Ten parametr musi znajdować się w zakresie od 1 do 5000.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AdminServicePrincipalProfiles	OK

Przykłady

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

Sample Request

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

Sample Response

Status code:

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

Sample Request

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

Sample Response

Status code:

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"
    }
  ]
}

Definicje

Nazwa	Opis
AdminServicePrincipalProfile	Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
AdminServicePrincipalProfiles	Otoka odpowiedzi Odata dla kolekcji profilów głównych usługa Power BI.

AdminServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

Nazwa	Typ	Opis
displayName	string	Nazwa profilu jednostki usługi
id	string	Identyfikator profilu jednostki usługi
servicePrincipalId	string	Identyfikator jednostki usługi

AdminServicePrincipalProfiles

Otoka odpowiedzi Odata dla kolekcji profilów głównych usługa Power BI.

Nazwa	Typ	Opis
odata.context	string	Kontekst OData
value	AdminServicePrincipalProfile[]	Kolekcja profilów jednostki usługi