Admin - Profiles GetProfilesAsAdmin

Služba:

Power BI REST APIs

Verze rozhraní API:

v1.0

Vrátí seznam profilů instančních objektů pro organizaci.

Dovolení

Uživatel musí být správcem infrastruktury nebo se musí ověřit pomocí instančního objektu.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Omezení

Maximálně 200 požadavků za hodinu.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
$filter	query		string	Filtruje výsledky na základě logické podmínky pomocí id, displayName nebo servicePrincipalId. Podporuje pouze operátor eq.
$skip	query		integer int32	Přeskočí první n výsledků. Pomocí horní části můžete načíst výsledky nad rámec prvních 5 000.
$top	query		integer int32	Vrátí pouze první n výsledků. Tento parametr musí být v rozsahu od 1 do 5000.

Odpovědi

Name	Typ	Description
200 OK	AdminServicePrincipalProfiles	OK

Příklady

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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Definice

Name	Description
AdminServicePrincipalProfile	Profil instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.
AdminServicePrincipalProfiles	Obálka odpovědi Odata pro kolekci instančního profilu Power BI

AdminServicePrincipalProfile

Profil instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.

Name	Typ	Description
displayName	string	Název instančního profilu
id	string	ID profilu instančního objektu
servicePrincipalId	string	ID instančního objektu

AdminServicePrincipalProfiles

Obálka odpovědi Odata pro kolekci instančního profilu Power BI

Name	Typ	Description
@odata.context	string	Kontext OData
value	AdminServicePrincipalProfile[]	Kolekce profilu instančního objektu