Partilhar via

Admin - Profiles GetProfilesAsAdmin

  • Referência
Serviço:
Power BI REST APIs
Versão da API:
v1.0

Retorna uma lista de perfis de entidade de serviço para a organização.

Permissões

O usuário deve ser um administrador do Fabric ou autenticar usando uma entidade de serviço.

Escopo necessário

Tenant.Read.All ou Tenant.ReadWrite.All

Limitações

Máximo de 200 solicitações por hora.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
$filter
 query

string

Filtra os resultados com base em uma condição booliana, usando 'id', 'displayName' ou 'servicePrincipalId'. Dá suporte apenas ao operador 'eq'.
$skip
 query

integer

int32

Ignora os primeiros n resultados. Use com a parte superior para buscar resultados além dos primeiros 5000.
$top
 query

integer

int32

Retorna apenas os primeiros n resultados. Esse parâmetro deve estar no intervalo de 1 a 5000.

Respostas

Nome Tipo Description
200 OK

AdminServicePrincipalProfiles

OKEY

Exemplos

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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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"
    }
  ]
}

Definições

Nome Description
AdminServicePrincipalProfile

Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários do Power BI Embedded.
AdminServicePrincipalProfiles

Wrapper de resposta Odata para uma coleção de perfis de entidade de serviço do Power BI.

AdminServicePrincipalProfile

Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários do Power BI Embedded.

Nome Tipo Description
displayName

string

O nome do perfil da entidade de serviço
id

string

A ID do perfil da entidade de serviço
servicePrincipalId

string

A ID da entidade de serviço

AdminServicePrincipalProfiles

Wrapper de resposta Odata para uma coleção de perfis de entidade de serviço do Power BI.

Nome Tipo Description
odata.context

string

Contexto OData
value

AdminServicePrincipalProfile[]

A coleção de perfis da entidade de serviço