Sdílet prostřednictvím

Embed Token - Datasets GenerateTokenInGroup

  • Reference
Služba:
Power BI REST APIs
Verze rozhraní API:
v1.0

Vygeneruje token pro vložení na základě zadané datové sady ze zadaného pracovního prostoru.

Tip

Pokud chcete vytvořit tokeny pro vložení, doporučujeme použít nejnovější rozhraní API vygenerovat token. Generování tokenu podporuje další funkce, například vytvoření tokenu pro více položek.

Poznámka

Token pro vložení můžete použít k vložení Q&A do vaší aplikace.

Důležité

Toto volání rozhraní API je relevantní pouze pro scénář vložení pro vaše zákazníky . Další informace o používání tohoto rozhraní API najdete v tématu Důležité informace o generování tokenu pro vložení.

Oprávnění

Požadovaný obor

Dataset.ReadWrite.All nebo Dataset.Read.All

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/GenerateToken

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
datasetId
 path True

string

ID datové sady
groupId
 path True

string

uuid

ID pracovního prostoru

Text požadavku

Name Typ Description
accessLevel

TokenAccessLevel

Požadovaná úroveň přístupu pro generování tokenů pro vložení
allowSaveAs

boolean

Určuje, jestli lze vloženou sestavu uložit jako novou sestavu. Výchozí hodnota je false. Platí pouze v případě, že vygenerujete token pro vložení sestavy.
datasetId

string

ID datové sady použité k vytvoření sestavy Platí pouze v případě, že vygenerujete token pro vložení pro vytvoření sestavy.
identities

EffectiveIdentity[]

Seznam identit, které se mají použít pro pravidla zabezpečení na úrovni řádků
lifetimeInMinutes

integer

Maximální životnost tokenu v minutách počínaje časem jeho vygenerování. Dá se použít ke zkrácení doby vypršení platnosti tokenu, ale ne k jejímu prodloužení. Hodnota musí být kladné celé číslo. Nula (0) je ekvivalentní hodnotě null a bude ignorována, což vede k výchozí době vypršení platnosti.

Odpovědi

Name Typ Description
200 OK

EmbedToken

OK

Příklady

Example

Ukázkový požadavek

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/GenerateToken
Text požadavku
{
  "accessLevel": "View"
}

Ukázková odpověď

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

Definice

Name Description
EffectiveIdentity

Definuje identitu a role uživatele. Další informace najdete v tématu Zabezpečení na úrovni řádků s Power BI Embedded.
EmbedToken

Token pro vložení Power BI
GenerateTokenRequest

Žádost o vygenerování tokenu Power BI
IdentityBlob

Objekt blob pro zadání identity. Podporováno pouze pro datové sady s připojením DirectQuery k Azure SQL
TokenAccessLevel

Požadovaná úroveň přístupu pro generování tokenů pro vložení

EffectiveIdentity

Object

Definuje identitu a role uživatele. Další informace najdete v tématu Zabezpečení na úrovni řádků s Power BI Embedded.

Name Typ Description
auditableContext

string

Auditovatelný kontext EffectiveIdentity. Pokud je tento parametr zadaný a není prázdný, povolí auditování hodnoty EffectiveIdentity a jeho hodnota se nastaví na uživatelské jméno v záznamu auditu. V opačném případě se kontext EffectiveIdentity ze záznamu auditu GenerateToken vynechá.
customData

string

Vlastní data , která se používají k použití pravidel zabezpečení na úrovni řádků. Podporováno pouze pro živé připojení k modelům Azure Analysis Services a cloudovým modelům.
datasets

string[]

Pole datových sad, pro které se tato identita vztahuje
identityBlob

IdentityBlob

Objekt blob, který určuje identitu. Podporováno pouze u datových sad s připojením DirectQuery k Azure SQL.
reports

string[]

Pole sestav, pro které se tato identita vztahuje. Podporováno pouze pro stránkované sestavy.
roles

string[]

Pole rolí zabezpečení na úrovni řádků (RLS) v rámci tokenu, který používá pravidla zabezpečení na úrovni řádků. Identita může obsahovat až 50 rolí. Role může obsahovat libovolný znak s výjimkou ,a její délka nesmí překročit 50 znaků.
username

string

Platné uživatelské jméno v tokenu, který používá pravidla zabezpečení na úrovni řádků. V případě místního modelu může uživatelské jméno obsahovat alfanumerické znaky nebo některý z následujících znaků ., -, _, , !#, ^~, \\, . @ U cloudových modelů může uživatelské jméno obsahovat libovolný znak ASCII. U obou modelů nesmí délka uživatelského jména překročit 256 znaků a uživatelské jméno by nemělo obsahovat mezery.

EmbedToken

Object

Token pro vložení Power BI

Name Typ Description
expiration

string

Datum a čas (UTC) vypršení platnosti tokenu
token

string

Token pro vložení
tokenId

string

Jedinečné ID tokenu. Prostřednictvím protokolů auditu lze ID tokenu použít ke korelaci operací, které token používají, s operací generování.

GenerateTokenRequest

Object

Žádost o vygenerování tokenu Power BI

Name Typ Description
accessLevel

TokenAccessLevel

Požadovaná úroveň přístupu pro generování tokenů pro vložení
allowSaveAs

boolean

Určuje, jestli lze vloženou sestavu uložit jako novou sestavu. Výchozí hodnota je false. Platí pouze v případě, že vygenerujete token pro vložení sestavy.
datasetId

string

ID datové sady použité k vytvoření sestavy Platí pouze v případě, že vygenerujete token pro vložení pro vytvoření sestavy.
identities

EffectiveIdentity[]

Seznam identit, které se mají použít pro pravidla zabezpečení na úrovni řádků
lifetimeInMinutes

integer

Maximální životnost tokenu v minutách počínaje časem jeho vygenerování. Dá se použít ke zkrácení doby vypršení platnosti tokenu, ale ne k jejímu prodloužení. Hodnota musí být kladné celé číslo. Nula (0) je ekvivalentní hodnotě null a bude ignorována, což vede k výchozí době vypršení platnosti.

IdentityBlob

Object

Objekt blob pro zadání identity. Podporováno pouze pro datové sady s připojením DirectQuery k Azure SQL

Name Typ Description
value

string

Přístupový token OAuth 2.0 pro Azure SQL

TokenAccessLevel

Enumeration

Požadovaná úroveň přístupu pro generování tokenů pro vložení

Hodnota Description
Create

Označuje, že vygenerovaný token pro vložení uděluje oprávnění k vytvoření. Platí pouze v případě, že vygenerujete token pro vložení pro vytvoření sestavy.
Edit

Označuje, že vygenerovaný token pro vložení uděluje oprávnění k zobrazení a úpravám. Platí pouze v případě, že vygenerujete token pro vložení sestavy.
View

Označuje, že vygenerovaný token pro vložení uděluje oprávnění jen pro zobrazení.