共用方式為

Gateways - Get Datasource Users

服務:
Power BI REST APIs
API 版本:
v1.0

傳回有權存取指定資料來源的使用者清單。

權限

使用者必須具有閘道管理員權限。

必要範圍

Dataset.ReadWrite.All 或 Dataset.Read.All

局限性

不支援虛擬網路 （VNet） 閘道。 

GET https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}/users

URI 參數

名稱 位於 必要 類型 Description
datasourceId
 path True

string (uuid)

資料來源識別碼
gatewayId
 path True

string (uuid)

閘道 ID。 使用閘道叢集時，閘道 ID 是指叢集中的主要 （第一個） 閘道。 在這種情況下，閘道 ID 類似於閘道叢集 ID。

回應

名稱 類型 Description
200 OK

DatasourceUsers

OK

範例

Example

範例要求

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users

範例回覆

狀態碼:
200 
{
  "value": [
    {
      "datasourceAccessRight": "Read",
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "datasourceAccessRight": "ReadOverrideEffectiveIdentity",
      "displayName": "ContosoTestApp",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

定義

名稱 Description
DatasourceUser

具有資料來源存取權的 Power BI 使用者
DatasourceUserAccessRight

使用者對資料來源的存取權限 （權限層級）
DatasourceUsers

具有資料來源存取權之 Power BI 使用者清單的 OData 回應包裝函式
PrincipalType

主體類型
ServicePrincipalProfile

Power BI 服務主體設定檔。 僅與 Power BI Embedded 多租用戶解決方案相關。

DatasourceUser

Object

具有資料來源存取權的 Power BI 使用者

名稱 類型 Description
datasourceAccessRight

DatasourceUserAccessRight

使用者對資料來源的存取權限 （權限層級）
displayName

string

主體的顯示名稱
emailAddress

string

使用者的電子郵件地址
identifier

string

主體的物件識別碼
principalType

PrincipalType

主體類型
profile

ServicePrincipalProfile

Power BI 服務主體設定檔。 僅與 Power BI Embedded 多租用戶解決方案相關。

DatasourceUserAccessRight

列舉型別

使用者對資料來源的存取權限 （權限層級）

值 Description
None

沒有存取資料來源的權限。 僅適用於更新使用者權限時。
Read

使用者擁有的資料集具有資料來源的讀取權限
ReadOverrideEffectiveIdentity

使用者可以覆寫 Power BI Embedded 的有效身分識別。 僅適用於內部部署 Analysis Services 資料來源。

DatasourceUsers

Object

具有資料來源存取權之 Power BI 使用者清單的 OData 回應包裝函式

名稱 類型 Description
@odata.context

string

value

DatasourceUser[]

具有資料來源存取權的使用者清單

PrincipalType

列舉型別

主體類型

值 Description
None

沒有主體類型。 用於整個組織層級存取。
User

使用者主體類型
Group

群組主體類型
App

服務主體類型

ServicePrincipalProfile

Object

Power BI 服務主體設定檔。 僅與 Power BI Embedded 多租用戶解決方案相關。

名稱 類型 Description
displayName

string

服務主體設定檔名稱
id

string (uuid)

服務主體設定檔識別碼