Sdílet prostřednictvím

Použití sady Power BI SDK s profily instančních objektů

  • Článek

Tento článek vysvětluje, jak používat sadu SDK s profily instančního objektu. Existují dva způsoby připojení klienta Power BI k profilu instančního objektu. Můžete provádět následující akce:

Jakmile je klient přidružený k profilu, můžete z klienta Power BI získat aktuální profil instančního objektu.

Vytvoření klienta Power BI s profilem instančního objektu

var profileObjectId = new Guid("81f24a6d-7ebb-4478-99c7-2c36f7870a26"); 
var powerBIclient = new PowerBIClient(credentials, profileObjectId: profileObjectId);

Když vytvoříte klienta Power BI s ID objektu profilu, každé volání rozhraní API, které používá klienta, má X-PowerBI-profile-id v hlavičce požadavku.

Příklad:

GET https://powerbiapi.analysis-df.windows.net/v1.0/myorg/groups


Authorization: Bearer eyJ0eXAiO.....5U_g
X-PowerBI-profile-id: 81f24a6d-7ebb-4478-99c7-2c36f7870a26

Nastavení profilu volání požadavku rozhraní API

Alternativně můžete zadat ID profilu v požadavku rozhraní API pomocí customHeaders vlastnosti v přetížené metodě WithHttpMessagesAsyncPowerBIClient rozhraní API .

var powerBIclient = new PowerBIClient(credentials); 
var profileHeader = new Dictionary<string, List<string>>(); 
profileHeader.Add("X-PowerBI-profile-id", new List<string> { "81f24a6d-7ebb-4478-99c7-2c36f7870a26" }); 
var groups = await powerBIclient.Groups.GetGroupsWithHttpMessagesAsync(customHeaders: profileHeader);

Příklad:

GET https://powerbiapi.analysis-df.windows.net/v1.0/myorg/groups 

Authorization: Bearer eyJ0eXAiO.....5U_g 
X-PowerBI-profile-id: 81f24a6d-7ebb-4478-99c7-2c36f7870a26

V předchozí ukázce kódu není hlavička profilu součástí výchozích hlaviček klienta, protože kód nepřidá hlavičku profilu. Musíte zadat hlavičku profilu s každým požadavkem rozhraní API.

Ujistěte se, že se vyhnete duplikacím. Například vytvoření klienta s ID objektu profilu a zadání hlavičky s požadavkem rozhraní API způsobí neoprávněné chyby.

Získání aktuálního profilu instančního objektu z klienta Power BI

Pokud chcete načíst aktuální profil instančního objektu z klienta sady SDK, zavolejte GetServicePrincipalProfileObjectId.

var profileObjectId = new Guid("81f24a6d-7ebb-4478-99c7-2c36f7870a26"); 
var powerBIclient = new PowerBIClient(credentials, profileObjectId: profileObjectId); 
var currentProfileObjectId = powerBIclient.GetServicePrincipalProfileObjectId();

Úvahy a omezení

V režimu živého připojení není k dispozici žádná podpora profilů instančních objektů ve službě Azure Analysis Services (AAS).

Související obsah

Profily instančního objektu v Power BI Embedded