Admin - Profiles GetProfilesAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Возвращает список профилей субъектов-служб для организации.

Разрешения

Пользователь должен иметь права администратора или пройти проверку подлинности с помощью субъекта-службы.

Требуемая область

Tenant.Read.All или 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}

Параметры URI

Имя	В	Обязательно	Тип	Описание
$filter	query		string	Фильтрует результаты по логическому условию, используя "id", "displayName" или "servicePrincipalId". Поддерживает только оператор eq.
$skip	query		integer int32	Пропускает первые n результатов. Используйте с top для получения результатов после первых 5000.
$top	query		integer int32	Возвращает только первые n результатов. Этот параметр должен находиться в диапазоне от 1 до 5000.

Ответы

Имя	Тип	Описание
200 OK	AdminServicePrincipalProfiles	ОК

Примеры

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

Определения

Имя	Описание
AdminServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.
AdminServicePrincipalProfiles	Оболочка ответа Odata для коллекции профилей служба Power BI субъекта.

AdminServicePrincipalProfile

Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.

Имя	Тип	Описание
displayName	string	Имя профиля субъекта-службы
id	string	Идентификатор профиля субъекта-службы
servicePrincipalId	string	Идентификатор субъекта-службы

AdminServicePrincipalProfiles

Оболочка ответа Odata для коллекции профилей служба Power BI субъекта.

Имя	Тип	Описание
odata.context	string	Контекст OData
value	AdminServicePrincipalProfile[]	Коллекция профилей субъекта-службы