Embed Token - Tiles GenerateTokenInGroup

Odwołanie

Usługa:: Power BI REST APIs

Wersja interfejsu API:: v1.0

Generuje token osadzania, aby wyświetlić określony kafelek z określonego obszaru roboczego.

Ważne

To wywołanie interfejsu API jest istotne tylko dla scenariusza osadzania dla klientów. Aby dowiedzieć się więcej na temat korzystania z tego interfejsu API, zobacz Zagadnienia dotyczące generowania tokenu osadzania.

Uprawnienia

W przypadku korzystania z jednostki usługi do uwierzytelniania zapoznaj się z tematem Osadzanie zawartości usługi Power BI przy użyciu jednostki usługi oraz zagadnienia i ograniczenia .
To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: profile jednostki usługi w usłudze Power BI Embedded.

Wymagany zakres

Wszystkie następujące elementy:

Dashboard.ReadWrite.All lub Dashboard.Read.All
Report.ReadWrite.All lub Report.Read.All
Dataset.ReadWrite.All lub Dataset.Read.All

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
dashboardId	path	True	string (uuid)	Identyfikator pulpitu nawigacyjnego
groupId	path	True	string (uuid)	Identyfikator obszaru roboczego
tileId	path	True	string (uuid)	Identyfikator kafelka

Treść żądania

Nazwa	Typ	Opis
accessLevel	TokenAccessLevel	Wymagany poziom dostępu do generowania tokenu osadzania
allowSaveAs	boolean	Czy osadzony raport można zapisać jako nowy raport. Wartość domyślna to `false`. Ma zastosowanie tylko podczas generowania tokenu osadzania dla osadzania raportu.
datasetId	string	Identyfikator zestawu danych używany do tworzenia raportu. Ma zastosowanie tylko podczas generowania tokenu osadzania na potrzeby tworzenia raportu.
identities	EffectiveIdentity[]	Lista tożsamości do użycia dla reguł zabezpieczeń na poziomie wiersza
lifetimeInMinutes	integer	Maksymalny okres istnienia tokenu w minutach, począwszy od momentu wygenerowania tokenu. Można użyć do skrócenia czasu wygaśnięcia tokenu, ale nie do jego rozszerzenia. Wartość musi być dodatnią liczbą całkowitą. Zero (0) jest równoważne wartości null i zostanie zignorowane, co spowoduje domyślny czas wygaśnięcia.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	EmbedToken	OK

Przykłady

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

Przykładowe żądanie

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

Treść żądania

{
  "accessLevel": "View",
  "identities": [
    {
      "username": "john@contoso.com",
      "roles": [
        "sales"
      ],
      "datasets": [
        "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
      ]
    }
  ]
}

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Treść żądania

{
  "accessLevel": "View",
  "identities": [
    {
      "datasets": [
        "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
      ],
      "identityBlob": {
        "value": "eyJ0eX....AAA="
      }
    }
  ]
}

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Treść żądania

{
  "accessLevel": "View",
  "identities": [
    {
      "username": "john@contoso.com",
      "customData": "john_contoso.com",
      "roles": [
        "sales"
      ],
      "datasets": [
        "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
      ]
    }
  ]
}

Przykładowa odpowiedź

Kod stanu:: 200

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

Definicje

Nazwa	Opis
EffectiveIdentity	Definiuje tożsamość i role użytkownika. Aby uzyskać więcej informacji, zobacz Zabezpieczenia na poziomie wiersza w usłudze Power BI Embedded.
EmbedToken	Token osadzania usługi Power BI
GenerateTokenRequest	Żądanie generowania tokenu w usłudze Power BI
IdentityBlob	Obiekt blob do określania tożsamości. Obsługiwane tylko w przypadku zestawów danych z połączeniem DirectQuery z usługą Azure SQL
TokenAccessLevel	Wymagany poziom dostępu do generowania tokenu osadzania

EffectiveIdentity

Objekt

Definiuje tożsamość i role użytkownika. Aby uzyskać więcej informacji, zobacz Zabezpieczenia na poziomie wiersza w usłudze Power BI Embedded.

Nazwa	Typ	Opis
auditableContext	string	Kontekst z możliwością inspekcji EffectiveIdentity. Jeśli ten parametr jest podany i nie jest pusty, włączy inspekcję elementu EffectiveIdentity, a jego wartość zostanie ustawiona na nazwę użytkownika w rekordzie inspekcji. W przeciwnym razie kontekst EffectiveIdentity zostanie pominięty z rekordu inspekcji GenerateToken.
customData	string	niestandardowych danych używanych do stosowania reguł zabezpieczeń na poziomie wiersza. Obsługiwane tylko w przypadku połączeń na żywo z modelami usług Azure Analysis Services i modelami w chmurze.
datasets	string[]	Tablica zestawów danych, dla których ta tożsamość ma zastosowanie
identityBlob	IdentityBlob	Obiekt blob określający tożsamość . Obsługiwane tylko w przypadku zestawów danych z połączeniem DirectQuery z usługą Azure SQL.
reports	string[]	Tablica raportów, dla których ta tożsamość ma zastosowanie. Obsługiwane tylko w przypadku raportów podzielonych na strony.
roles	string[]	Tablica ról zabezpieczeń na poziomie wiersza w tokenie, który stosuje reguły zabezpieczeń na poziomie wiersza. Tożsamość może zawierać maksymalnie 50 ról. Rola może zawierać dowolny znak z wyjątkiem `,`, a jego długość nie może przekraczać 50 znaków.
username	string	Obowiązująca nazwa użytkownika w tokenie, który stosuje reguły zabezpieczeń na poziomie wiersza. W przypadku modelu lokalnego nazwa użytkownika może zawierać alfanumeryczne lub dowolne z następujących znaków `.`, `-`, `_`, `!`, `#`, `^`, `~`, `\\`, `@`. W przypadku modeli w chmurze nazwa użytkownika może zawierać dowolny znak ASCII. W przypadku obu modeli długość nazwy użytkownika nie może przekraczać 256 znaków, a nazwa użytkownika nie powinna zawierać spacji.

EmbedToken

Objekt

Token osadzania usługi Power BI

Nazwa	Typ	Opis
expiration	string (date-time)	Data i godzina wygaśnięcia tokenu (UTC)
token	string	Token osadzania
tokenId	string (uuid)	Unikatowy identyfikator tokenu. Za pomocą dzienników inspekcji identyfikator tokenu może służyć do korelowania operacji używających tokenu z operacją generowania.

GenerateTokenRequest

Objekt

Żądanie generowania tokenu w usłudze Power BI

Nazwa	Typ	Opis
accessLevel	TokenAccessLevel	Wymagany poziom dostępu do generowania tokenu osadzania
allowSaveAs	boolean	Czy osadzony raport można zapisać jako nowy raport. Wartość domyślna to `false`. Ma zastosowanie tylko podczas generowania tokenu osadzania dla osadzania raportu.
datasetId	string	Identyfikator zestawu danych używany do tworzenia raportu. Ma zastosowanie tylko podczas generowania tokenu osadzania na potrzeby tworzenia raportu.
identities	EffectiveIdentity[]	Lista tożsamości do użycia dla reguł zabezpieczeń na poziomie wiersza
lifetimeInMinutes	integer	Maksymalny okres istnienia tokenu w minutach, począwszy od momentu wygenerowania tokenu. Można użyć do skrócenia czasu wygaśnięcia tokenu, ale nie do jego rozszerzenia. Wartość musi być dodatnią liczbą całkowitą. Zero (0) jest równoważne wartości null i zostanie zignorowane, co spowoduje domyślny czas wygaśnięcia.

IdentityBlob

Objekt

Obiekt blob do określania tożsamości. Obsługiwane tylko w przypadku zestawów danych z połączeniem DirectQuery z usługą Azure SQL

Nazwa	Typ	Opis
value	string	Token dostępu OAuth 2.0 dla usługi Azure SQL

TokenAccessLevel

Wyliczanie

Wymagany poziom dostępu do generowania tokenu osadzania

Wartość	Opis
Create	Wskazuje, że wygenerowany token osadzania przyznaje uprawnienie do tworzenia. Ma zastosowanie tylko podczas generowania tokenu osadzania na potrzeby tworzenia raportu.
Edit	Wskazuje, że wygenerowany token osadzania przyznaje uprawnienia do wyświetlania i edytowania. Ma zastosowanie tylko podczas generowania tokenu osadzania dla osadzania raportu.
View	Wskazuje, że wygenerowane token osadzania przyznaje uprawnienia tylko do wyświetlania

Udostępnij za pośrednictwem

Embed Token - Tiles GenerateTokenInGroup

Uprawnienia

Wymagany zakres

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

Generate a tile embed token using an effective identity example

Przykładowe żądanie

Przykładowa odpowiedź

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

Przykładowe żądanie

Przykładowa odpowiedź

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

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

EffectiveIdentity

EmbedToken

GenerateTokenRequest

IdentityBlob

TokenAccessLevel

Dodatkowe zasoby