Power BI SDK:n käyttäminen palvelun pääprofiilien kanssa
Tässä artikkelissa kerrotaan, miten SDK:ta käytetään palvelun päänimiprofiilien kanssa. Power BI -asiakas voidaan yhdistää palvelun pääprofiiliin kahdella tavalla. Voit tehdä seuraavia toimintoja:
Kun asiakas on liitetty profiiliin, voit hakea nykyisen palvelun pääprofiilin Power BI -asiakkaalta.
Power BI -asiakasohjelman luominen palvelun pääprofiililla
var profileObjectId = new Guid("81f24a6d-7ebb-4478-99c7-2c36f7870a26");
var powerBIclient = new PowerBIClient(credentials, profileObjectId: profileObjectId);
Kun luot Power BI -asiakasohjelman profiiliobjektitunnuksella, jokaisen asiakasta käyttävän ohjelmointirajapintakutsun X-PowerBI-profile-id pyynnön otsikossa on -tunnus.
Esimerkkejä:
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
Profiilin määrittäminen ohjelmointirajapinnan pyyntökutsulle
Vaihtoehtoisesti voit määrittää profiilitunnuksen API-pyynnössä käyttämällä - customHeaders ominaisuutta ohjelmointirajapinnan ylikuormittetun PowerBIClient-menetelmän avulla 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);
Esimerkiksi
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
Edellisessä koodiesimerkissä profiilin otsikko ei ole osa asiakkaan oletusotsikoita, koska koodi ei lisää profiilin otsikkoa. Sinun on määritettävä profiilin otsikko jokaisen ohjelmointirajapintapyynnön yhteydessä.
Varmista, että vältät päällekkäisyydet. Esimerkiksi asiakasohjelman luominen profiiliobjektitunnuksella ja otsikon määrittäminen ohjelmointirajapintapyynnöllä aiheuttaa valtuuttamattomia virheitä.
Hae nykyinen palvelun päänimiprofiili Power BI -asiakkaalta
Jos haluat noutaa nykyisen palvelun pääprofiilin SDK-asiakkaalta, kutsu GetServicePrincipalProfileObjectId.
var profileObjectId = new Guid("81f24a6d-7ebb-4478-99c7-2c36f7870a26");
var powerBIclient = new PowerBIClient(credentials, profileObjectId: profileObjectId);
var currentProfileObjectId = powerBIclient.GetServicePrincipalProfileObjectId();
Huomioitavat asiat ja rajoitukset
Azure Analysis Servicesin (AAS) palvelun pääprofiilien reaaliaikaisessa yhteystilassa ei tueta.