Admin - Profiles GetProfilesAsAdmin

Servizio:

Power BI REST APIs

Versione API:

v1.0

Restituisce un elenco di profili entità servizio per l'organizzazione.

Autorizzazioni

L'utente deve essere un amministratore di Fabric o eseguire l'autenticazione usando un'entità servizio.

Ambito obbligatorio

Tenant.Read.All o Tenant.ReadWrite.All

Limitazioni

Massimo 200 richieste all'ora.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
$filter	query		string	Filtra i risultati in base a una condizione booleana, usando 'id', 'displayName' o 'servicePrincipalId'. Supporta solo l'operatore 'eq'.
$skip	query		integer int32	Ignora i primi n risultati. Usare con la parte superiore per recuperare i risultati oltre i primi 5000.
$top	query		integer int32	Restituisce solo i primi n risultati. Questo parametro deve essere compreso nell'intervallo di 1-5000.

Risposte

Nome	Tipo	Descrizione
200 OK	AdminServicePrincipalProfiles	OK

Esempio

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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
AdminServicePrincipalProfile	Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
AdminServicePrincipalProfiles	Wrapper di risposta Odata per una raccolta di profili dell'entità servizio di Power BI.

AdminServicePrincipalProfile

Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

Nome	Tipo	Descrizione
displayName	string	Nome del profilo dell'entità servizio
id	string	ID del profilo dell'entità servizio
servicePrincipalId	string	ID entità servizio

AdminServicePrincipalProfiles

Wrapper di risposta Odata per una raccolta di profili dell'entità servizio di Power BI.

Nome	Tipo	Descrizione
odata.context	string	Contesto OData
value	AdminServicePrincipalProfile[]	Raccolta di profili dell'entità servizio