共用方式為

Embed Token - Tiles GenerateTokenInGroup

  • 參考
Service:
Power BI REST APIs
API Version:
v1.0

產生內嵌權杖，以從指定的工作區檢視指定的圖格。

重要

此 API 呼叫僅與 客戶案例的內嵌 相關。 若要深入瞭解如何使用此 API，請參閱 產生內嵌權杖時的考慮。

權限

必要範圍

下列所有專案：

  • Dashboard.ReadWrite.All 或 Dashboard.Read.All
  • Report.ReadWrite.All 或 Report.Read.All
  • Dataset.ReadWrite.All 或 Dataset.Read.All

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dashboards/{dashboardId}/tiles/{tileId}/GenerateToken

URI 參數

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

string

uuid

儀表板識別碼
groupId
 path True

string

uuid

工作區識別碼
tileId
 path True

string

uuid

磚識別碼

要求本文

名稱 類型 Description
accessLevel

TokenAccessLevel

內嵌權杖產生所需的存取層級
allowSaveAs

boolean

是否可以將內嵌報表儲存為新的報表。 預設值是 false。 只有在產生報表內嵌的內嵌權杖時才適用。
datasetId

string

用於建立報表的資料集識別碼。 只有在產生用於建立報表的內嵌權杖時，才適用。
identities

EffectiveIdentity[]

用於資料列層級安全性規則的身分識別清單
lifetimeInMinutes

integer

權杖的存留期上限，以分鐘為單位，從產生權杖的時間開始。 可用來縮短權杖的到期時間，但不能加以擴充。 其值必須為正整數。 零 (0) 相當於 null，而且會忽略，導致預設到期時間。

回應

名稱 類型 Description
200 OK

EmbedToken

確定

範例

Generate a tile embed token using an effective identity example
Generate a tile embed token using an effective identity with an identity blob example
Generate a tile embed token using an effective identity with custom data for Azure Analysis Services example

Generate a tile embed token using an effective identity example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dashboards/69ffaa6c-b36d-4d01-96f5-1ed67c64d4af/tiles/312fbfe9-2eda-44e0-9ed0-ab5dc571bb4b/GenerateToken
Request Body
{
  "accessLevel": "View",
  "identities": [
    {
      "username": "john@contoso.com",
      "roles": [
        "sales"
      ],
      "datasets": [
        "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
      ]
    }
  ]
}

Sample Response

Status code:
200 
{
  "token": "H4sI....AAA=",
  "tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
  "expiration": "2018-07-29T17:58:19Z"
}

Generate a tile embed token using an effective identity with an identity blob example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dashboards/69ffaa6c-b36d-4d01-96f5-1ed67c64d4af/tiles/312fbfe9-2eda-44e0-9ed0-ab5dc571bb4b/GenerateToken
Request Body
{
  "accessLevel": "View",
  "identities": [
    {
      "datasets": [
        "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
      ],
      "identityBlob": {
        "value": "eyJ0eX....AAA="
      }
    }
  ]
}

Sample Response

Status code:
200 
{
  "token": "H4sI....AAA=",
  "tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
  "expiration": "2018-07-29T17:58:19Z"
}

Generate a tile embed token using an effective identity with custom data for Azure Analysis Services example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dashboards/69ffaa6c-b36d-4d01-96f5-1ed67c64d4af/tiles/312fbfe9-2eda-44e0-9ed0-ab5dc571bb4b/GenerateToken
Request Body
{
  "accessLevel": "View",
  "identities": [
    {
      "username": "john@contoso.com",
      "customData": "john_contoso.com",
      "roles": [
        "sales"
      ],
      "datasets": [
        "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
      ]
    }
  ]
}

Sample Response

Status code:
200 
{
  "token": "H4sI....AAA=",
  "tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
  "expiration": "2018-07-29T17:58:19Z"
}

定義

名稱 Description
EffectiveIdentity

定義使用者身分識別和角色。 如需詳細資訊，請參閱資料列層級安全性與Power BI Embedded。
EmbedToken

Power BI 內嵌權杖
GenerateTokenRequest

Power BI 產生權杖要求
IdentityBlob

用於指定身分識別的 Blob。 僅支援具有與 Azure SQL 之 DirectQuery 連線的資料集
TokenAccessLevel

內嵌權杖產生所需的存取層級

EffectiveIdentity

定義使用者身分識別和角色。 如需詳細資訊，請參閱資料列層級安全性與Power BI Embedded。

名稱 類型 Description
auditableContext

string

EffectiveIdentity 可稽核的內容。 如果提供此參數且不是空的，則會啟用 EffectiveIdentity 的稽核，並將其值設定為稽核記錄中的使用者名稱。 否則，會從 GenerateToken 稽核記錄中省略 EffectiveIdentity 內容。
customData

string

用來套用資料列層級安全性規則的自訂資料。 僅支援與Azure Analysis Services模型和雲端模型的即時連線。
datasets

string[]

套用此身分識別的資料集陣列
identityBlob

IdentityBlob

指定 身分識別的 Blob。 僅支援具有與 Azure SQL 之 DirectQuery 連線的資料集。
reports

string[]

套用此身分識別的報表陣列。 僅支援編頁報表。
roles

string[]

套用 RLS 規則的權杖內，資料列層級安全性 (RLS) 角色的陣列。 身分識別最多可以包含 50 個角色。 角色可以包含除了 以外的 , 任何字元，而且其長度不能超過 50 個字元。
username

string

套用資料列層級安全性規則之權杖內的有效使用者名稱。 針對內部部署模型，使用者名稱可以包含英數位元或下列任何字元 . 、 - 、 ^!_# 、 ~ 、、 。 \\@ 針對雲端模型，使用者名稱可以包含任何 ASCII 字元。 針對任一模型，使用者名稱長度不能超過 256 個字元，而且使用者名稱不應包含空格。

EmbedToken

Power BI 內嵌權杖

名稱 類型 Description
expiration

string

權杖到期的日期和時間 (UTC)

token

string

內嵌權杖
tokenId

string

唯一的權杖識別碼。 透過稽核記錄，權杖識別碼可用來將使用權杖與產生作業的作業相互關聯。

GenerateTokenRequest

Power BI 產生權杖要求

名稱 類型 Description
accessLevel

TokenAccessLevel

內嵌權杖產生所需的存取層級
allowSaveAs

boolean

是否可以將內嵌報表儲存為新的報表。 預設值是 false。 只有在產生報表內嵌的內嵌權杖時才適用。
datasetId

string

用於建立報表的資料集識別碼。 只有在產生用於建立報表的內嵌權杖時，才適用。
identities

EffectiveIdentity[]

用於資料列層級安全性規則的身分識別清單
lifetimeInMinutes

integer

權杖的存留期上限，以分鐘為單位，從產生權杖的時間開始。 可用來縮短權杖的到期時間，但不能加以擴充。 其值必須為正整數。 零 (0) 相當於 null，而且會忽略，導致預設到期時間。

IdentityBlob

用於指定身分識別的 Blob。 僅支援具有與 Azure SQL 之 DirectQuery 連線的資料集

名稱 類型 Description
value

string

適用于 Azure SQL 的 OAuth 2.0 存取權杖

TokenAccessLevel

內嵌權杖產生所需的存取層級

名稱 類型 Description
Create

string

表示產生的內嵌權杖會授與建立許可權。 只有在產生用於建立報表的內嵌權杖時，才適用。
Edit

string

表示產生的內嵌權杖會授與檢視和編輯許可權。 只有在產生報表內嵌的內嵌權杖時才適用。
View

string

指出產生的內嵌權杖授與僅限檢視許可權