Admin - Profiles GetProfilesAsAdmin

Usługa:

Power BI REST APIs

Wersja interfejsu API:

v1.0

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

Uprawnienia

Użytkownik musi być administratorem sieci szkieletowej lub uwierzytelniać się przy użyciu jednostki usługi.

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

Ograniczenia

Maksymalna liczba żądań na godzinę wynosi 200.

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

Z parametrami opcjonalnymi:

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 należeć do zakresu 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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 jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.
AdminServicePrincipalProfiles	Otoka odpowiedzi Odata dla kolekcji profilu jednostki usługi Power BI.

AdminServicePrincipalProfile

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.

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 profilu jednostki usługi Power BI.

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