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	使用“id”、“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	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[]	服务主体配置文件集合