Поделиться через

Admin - Profiles GetProfilesAsAdmin

  • Ссылка
Служба:
Power BI REST APIs
Версия API:
v1.0

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

Разрешения

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

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

Tenant.Read.All или Tenant.ReadWrite.All

Ограничения

Максимум 200 запросов в час.

GET https://api.powerbi.com/v1.0/myorg/admin/profiles
С использованием необязательных параметров: 
GET https://api.powerbi.com/v1.0/myorg/admin/profiles?$filter={$filter}&$top={$top}&$skip={$skip}

Параметры URI

Имя В Обязательно Тип Описание
$filter
 query

string

Фильтрует результаты на основе логического условия, используя идентификатор, displayName или servicePrincipalId. Поддерживает только оператор eq.
$skip
 query

integer

int32

Пропускает первые результаты n. Используйте в начале, чтобы получить результаты за пределами первого 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

Образец запроса

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

Пример ответа

Код состояния:
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

Образец запроса

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

Пример ответа

Код состояния:
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[]

Коллекция профилей субъекта-службы