Brug Power BI SDK med tjenesteprincipalprofiler

  • Artikel

I denne artikel forklares det, hvordan du bruger SDK'et med tjenesteprincipalprofiler. Der er to måder at oprette forbindelse mellem en Power BI-klient og en tjenesteprincipalprofil på. Du kan:

Når klienten er knyttet til en profil, kan du hente den aktuelle tjenesteprincipalprofil fra Power BI-klienten.

Opret en Power BI-klient med en tjenesteprincipalprofil

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

Når du opretter en Power BI-klient med profilobjekt-id'et, har X-PowerBI-profile-id alle API-kald, der bruger klienten, i anmodningsheaderen.

Eksempler:

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

Angiv profil ved API-anmodningsopkald

Du kan også angive profil-id'et i API-anmodningen ved hjælp customHeaders af egenskaben i API'ens overbelastede PowerBIClient-metode WithHttpMessagesAsync.

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);

Eksempel

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

I det foregående kodeeksempel er profilheaderen ikke en del af klientens standardheadere, fordi koden ikke tilføjer profilheaderen. Du skal angive profilheaderen for hver API-anmodning.

Sørg for at undgå dubletter. Hvis du f.eks. opretter en klient med et profilobjekt-id og derefter angiver headeren med API-anmodningen, resulterer det i uautoriserede fejl.

Hent den aktuelle tjenesteprincipalprofil fra Power BI-klienten

Hvis du vil hente den aktuelle tjenesteprincipalprofil fra SDK-klienten, skal du kalde GetServicePrincipalProfileObjectId.

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

Overvejelser og begrænsninger

Der er ingen understøttelse af tjenesteprincipalprofiler med Azure Analysis Services (AAS) i liveforbindelsestilstand.

Relateret indhold

Tjenesteprincipalprofiler i Power BI Embedded