Admin - Profiles GetProfilesAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Retourne une liste de profils de principal de service pour l’organisation.

Autorisations

L’utilisateur doit disposer de droits d’administrateur ou s’authentifier à l’aide d’un principal de service.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

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

With optional parameters:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
$filter	query		string	Filtre les résultats en fonction d’une condition booléenne, à l’aide de « id », « displayName » ou « servicePrincipalId ». Prend uniquement en charge l’opérateur « eq ».
$skip	query		integer int32	Ignore les n premiers résultats. Utilisez avec le haut pour extraire les résultats au-delà des 5 000 premières.
$top	query		integer int32	Retourne uniquement les n premiers résultats. Ce paramètre doit se trouver dans la plage de 1 à 5 000.

Réponses

Nom	Type	Description
200 OK	AdminServicePrincipalProfiles	Ok

Exemples

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

Sample Request

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

Sample Response

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

Sample Request

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

Sample Response

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

Définitions

Nom	Description
AdminServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
AdminServicePrincipalProfiles	Wrapper de réponse Odata pour une collection de profils principaux service Power BI.

AdminServicePrincipalProfile

Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.

Nom	Type	Description
displayName	string	Nom du profil principal de service
id	string	ID de profil du principal de service
servicePrincipalId	string	ID du principal de service

AdminServicePrincipalProfiles

Wrapper de réponse Odata pour une collection de profils principaux service Power BI.

Nom	Type	Description
odata.context	string	Contexte OData
value	AdminServicePrincipalProfile[]	Collection de profils de principal de service