Embed Token - Reports GenerateTokenForCreateInGroup
Vygeneruje token pro vložení, který umožní vytvoření sestavy v zadaném pracovním prostoru na základě zadané datové sady.
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.
Důležité
Toto volání rozhraní API je relevantní jenom pro scénář vkládání pro vaše zákazníky . Další informace o použití tohoto rozhraní API najdete v tématu Důležité informace o generování tokenu pro vložení.
Oprávnění
- Pokud k ověřování používáte instanční objekt, přečtěte si téma Vložení obsahu Power BI s instančním objektem a Důležité informace a omezení.
- Toto volání rozhraní API může volat profil instančního objektu. Další informace najdete v tématu Profily instančních objektů v Power BI Embedded.
Požadovaný obor
Všechno z tohoto:
- Content.Create
- Report.ReadWrite.All nebo Report.Read.All
- Dataset.ReadWrite.All nebo Dataset.Read.All
Omezení
U sestav Azure Analysis Services nebo místních živých připojení Analysis Services nemusí generování tokenu pro vložení se zabezpečením na úrovni řádků několik minut po volání rozhraní API rebind report fungovat.
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports/GenerateToken
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
group
|
path | True |
string uuid |
ID pracovního prostoru |
Text požadavku
Name | Typ | Description |
---|---|---|
accessLevel |
Požadovaná úroveň přístupu pro generování tokenů pro vložení |
|
allowSaveAs |
boolean |
Určuje, zda lze vloženou sestavu uložit jako novou sestavu. Výchozí hodnota je |
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 |
Seznam identit, které se mají použít pro pravidla zabezpečení na úrovni řádků |
|
lifetimeInMinutes |
integer |
Maximální životnost tokenu v minutách od 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ímu času vypršení platnosti. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
Příklady
Generate an embed token for report creation based on a specified dataset example
Sample Request
POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/GenerateToken
{
"accessLevel": "Create",
"datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}
Sample Response
{
"token": "H4sI....AAA=",
"tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
"expiration": "2018-07-29T17:58:19Z"
}
Generate an embed token for report creation based on a specified dataset example. The embed token uses an effective identity.
Sample Request
POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/GenerateToken
{
"accessLevel": "Create",
"datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"identities": [
{
"username": "john@contoso.com",
"roles": [
"sales"
],
"datasets": [
"cfafbeb1-8037-4d0c-896e-a46fb27ff229"
]
}
]
}
Sample Response
{
"token": "H4sI....AAA=",
"tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
"expiration": "2018-07-29T17:58:19Z"
}
Definice
Name | Description |
---|---|
Effective |
Definuje identitu a role uživatele. Další informace najdete v tématu Zabezpečení na úrovni řádků s Power BI Embedded. |
Embed |
Token power BI pro vložení |
Generate |
Žádost o vygenerování tokenu Power BI |
Identity |
Objekt blob pro zadání identity. Podporováno pouze u datových sad s připojením DirectQuery k Azure SQL |
Token |
Požadovaná úroveň přístupu pro generování tokenů pro vložení |
EffectiveIdentity
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ý, umožní auditování 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ů. Podporuje se 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 |
Objekt blob, který určuje identitu. Podporuje se pouze pro datové sady 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 kromě |
username |
string |
Efektivní uživatelské jméno v rámci 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ů |
EmbedToken
Token power BI pro vložení
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 je možné ID tokenu použít ke korelaci operací, které token používají, s operací generování. |
GenerateTokenRequest
Žádost o vygenerování tokenu Power BI
Name | Typ | Description |
---|---|---|
accessLevel |
Požadovaná úroveň přístupu pro generování tokenů pro vložení |
|
allowSaveAs |
boolean |
Určuje, zda lze vloženou sestavu uložit jako novou sestavu. Výchozí hodnota je |
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 |
Seznam identit, které se mají použít pro pravidla zabezpečení na úrovni řádků |
|
lifetimeInMinutes |
integer |
Maximální životnost tokenu v minutách od 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ímu času vypršení platnosti. |
IdentityBlob
Objekt blob pro zadání identity. Podporováno pouze u datových sad s připojením DirectQuery k Azure SQL
Name | Typ | Description |
---|---|---|
value |
string |
Přístupový token OAuth 2.0 pro Azure SQL |
TokenAccessLevel
Požadovaná úroveň přístupu pro generování tokenů pro vložení
Name | Typ | Description |
---|---|---|
Create |
string |
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 |
string |
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 |
string |
Označuje, že vygenerovaný token pro vložení uděluje oprávnění jen pro zobrazení. |