Admin - Profiles GetProfilesAsAdmin

Servicio:

Power BI REST APIs

Versión de la API:

v1.0

Devuelve una lista de perfiles de entidad de servicio para la organización.

Permisos

El usuario debe ser un administrador de Fabric o autenticarse mediante una entidad de servicio.

Ámbito requerido

Tenant.Read.All o Tenant.ReadWrite.All

Limitaciones

Máximo de 200 solicitudes por hora.

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

Con parámetros opcionales:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
$filter	query		string	Filtra los resultados en función de una condición booleana mediante "id", "displayName" o "servicePrincipalId". Solo admite el operador 'eq'.
$skip	query		integer int32	Omite los primeros n resultados. Use con top para capturar los resultados más allá de los primeros 5000.
$top	query		integer int32	Devuelve solo los primeros n resultados. Este parámetro debe estar en el intervalo de 1 a 5000.

Respuestas

Nombre	Tipo	Description
200 OK	AdminServicePrincipalProfiles	De acuerdo

Ejemplos

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

Solicitud de ejemplo

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

Respuesta de muestra

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

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre	Description
AdminServicePrincipalProfile	Un perfil de entidad de servicio de Power BI. Solo es relevante para solución multiinquilino de Power BI Embedded.
AdminServicePrincipalProfiles	Contenedor de respuesta de Odata para una colección de perfiles de entidad de servicio de Power BI.

AdminServicePrincipalProfile

Object

Un perfil de entidad de servicio de Power BI. Solo es relevante para solución multiinquilino de Power BI Embedded.

Nombre	Tipo	Description
displayName	string	El nombre del perfil de entidad de servicio
id	string	Identificador del perfil de la entidad de servicio
servicePrincipalId	string	Identificador de la entidad de servicio

AdminServicePrincipalProfiles

Object

Contenedor de respuesta de Odata para una colección de perfiles de entidad de servicio de Power BI.

Nombre	Tipo	Description
@odata.context	string	Contexto de OData
value	AdminServicePrincipalProfile[]	Colección de perfiles de entidad de servicio