Share via

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

名稱 位於 必要 類型 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

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

定義

名稱 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[]

服務主體設定檔集合