Partilhar via


Profiles - Get Profiles

Retorna uma lista de perfis de entidade de serviço.

Retorna uma lista de perfis que pertencem ao chamador da entidade de serviço.

Limitações

Só pode ser chamado por uma entidade de serviço.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
$filter
query

string

Obter um perfil por DisplayName

$skip
query

integer

int32

Ignora os primeiros n resultados

$top
query

integer

int32

Retorna apenas os primeiros n resultados

Respostas

Nome Tipo Description
200 OK

ServicePrincipalProfiles

OK

Exemplos

Get a specific profile by displayName using filter
Get service principal profiles

Get a specific profile by displayName using filter

Sample Request

GET https://api.powerbi.com/v1.0/myorg/profiles?$filter=displayName%20eq%20'My%20new%20profile'

Sample Response

{
  "value": [
    {
      "id": "3b211778-e7a5-4d73-8187-f10824047724",
      "displayName": "My new profile"
    }
  ]
}

Get service principal profiles

Sample Request

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

Sample Response

{
  "value": [
    {
      "id": "3b211778-e7a5-4d73-8187-f10824047724",
      "displayName": "My new profile"
    }
  ]
}

Definições

Nome Description
ServicePrincipalProfile

Um perfil de entidade de serviço do Power BI. Relevante apenas para Power BI Embedded solução de várias locações.

ServicePrincipalProfiles

Wrapper de resposta Odata para uma coleção de perfil de serviço do Power BI principal.

ServicePrincipalProfile

Um perfil de entidade de serviço do Power BI. Relevante apenas para Power BI Embedded solução de várias locações.

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

ServicePrincipalProfiles

Wrapper de resposta Odata para uma coleção de perfil de serviço do Power BI principal.

Nome Tipo Description
odata.context

string

Contexto OData

value

ServicePrincipalProfile[]

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