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

Power BI 服务主体配置文件集合的 Odata 响应包装器。

AdminServicePrincipalProfile

Power BI 服务主体配置文件。 仅适用于Power BI Embedded多租户解决方案。

名称 类型 说明
displayName

string

服务主体配置文件名称
id

string

服务主体配置文件 ID
servicePrincipalId

string

服务主体 ID

AdminServicePrincipalProfiles

Power BI 服务主体配置文件集合的 Odata 响应包装器。

名称 类型 说明
odata.context

string

OData 上下文
value

AdminServicePrincipalProfile[]

服务主体配置文件集合