Admin - Profiles GetProfilesAsAdmin
傳回組織的服務主體配置檔案清單。
權限
使用者必須具有系統管理員許可權,或使用服務主體進行驗證。
必要範圍
Tenant.Read.All 或 Tenant.ReadWrite.All
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 |
確定 |
範例
Get a specific service principal profile by id using filter |
Get service principal profiles by their parent service |
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
{
"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
{
"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 |
---|---|
Admin |
Power BI 服務主體設定檔。 僅適用于Power BI Embedded多租使用者解決方案。 |
Admin |
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 |
服務主體設定檔集合 |