Admin - Profiles GetProfilesAsAdmin

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