Admin - Profiles GetProfilesAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Vrátí seznam profilů instančního objektu pro organizaci.

Oprávnění

Uživatel musí mít práva správce nebo se musí ověřit pomocí instančního objektu.

Požadovaný obor

Tenant.Read.All nebo 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 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ích n výsledků. Pokud chcete načíst výsledky nad rámec prvních 5000, použijte s horní.
$top	query		integer int32	Vrátí pouze prvních n výsledků. Tento parametr musí být v rozsahu 1–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

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

Definice

Name	Description
AdminServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
AdminServicePrincipalProfiles	Obálka odpovědi Odata pro kolekci služba Power BI hlavního profilu.

AdminServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

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

AdminServicePrincipalProfiles

Obálka odpovědi Odata pro kolekci služba Power BI hlavního profilu.

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