Admin - Profiles GetProfilesAsAdmin

服務:

Power BI REST APIs

API 版本:

v1.0

傳回組織的服務主體配置檔清單。

權限

用戶必須是網狀架構系統管理員，或使用服務主體進行驗證。

必要範圍

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 參數

名稱	位於	必要	類型	Description
$filter	query		string	使用 'id'、'displayName' 或 'servicePrincipalId' 根據布爾條件篩選結果。 僅支援 『eq』 運算子。
$skip	query		integer int32	略過前 n 個結果。 搭配 top 來擷取前 5000 個以上的結果。
$top	query		integer int32	只傳回前 n 個結果。 此參數的範圍必須是 1-5000。

回應

名稱	類型	Description
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"
    }
  ]
}

定義

名稱	Description
AdminServicePrincipalProfile	Power BI 服務主體配置檔。 僅與 Power BI Embedded 多租使用者解決方案相關。
AdminServicePrincipalProfiles	Power BI 服務主體配置檔集合的 Odata 回應包裝函式。

AdminServicePrincipalProfile

Power BI 服務主體配置檔。 僅與 Power BI Embedded 多租使用者解決方案相關。

名稱	類型	Description
displayName	string	服務主體配置檔名稱
id	string	服務主體配置檔識別碼
servicePrincipalId	string	服務主體標識碼

AdminServicePrincipalProfiles

Power BI 服務主體配置檔集合的 Odata 回應包裝函式。

名稱	類型	Description
odata.context	string	OData 內容
value	AdminServicePrincipalProfile[]	服務主體配置檔集合