Použití rozhraní REST API Power BI
Rozhraní REST API Power BI poskytují koncové body služby pro vkládání, správu, zásady správného řízení a uživatelské prostředky.
Pomocí rozhraní REST API Power BI můžete provést následující akce:
Správa obsahu Power BI
Provádění operací správy
Vložení obsahu Power BI
Poznámka
Některá rozhraní API Power BI odkazují na pracovní prostory jako skupiny. Všechny odkazy na skupiny znamenají, že pracujete s pracovními prostory.
Při přístupu k rozhraní REST API Power BI můžou datacentra zpracovávat datacentra v jiných oblastech než v domovské oblasti tenanta Power BI.
Oblasti
Pokud chcete používat rozhraní REST API Power BI, musíte zaregistrovat aplikaci Azure Active Directory (Azure AD) v Azure. Aplikace Azure AD vytváří oprávnění k prostředkům REST Power BI a umožňuje přístup k rozhraním REST API Power BI. Informace o registraci aplikace najdete v tématu Registrace aplikace Azure AD pro použití s power BI.
Po registraci aplikace Azure AD ji můžete ověřit pomocí Azure AD (verze 1.0; ADAL) nebo Microsoft Identity Platform (v2.0; Koncové body MSAL. Další informace o tom, jak tyto metody ověřování fungují, najdete v tématu Proč aktualizovat platformu Microsoft Identity Platform (v2.0)?
Další informace o přístupových oprávněních Power BI najdete v tématu Oprávnění a souhlas v koncovém bodu Microsoft Identity Platform.
Použití instančního objektu
Obory se nevyžadují, pokud používáte instanční objekt. Jakmile povolíte použití instančního objektu s Power BI, oprávnění AD aplikace se už neprojeví. Při použití instančního objektu se oprávnění aplikace spravují prostřednictvím portálu pro správu Power BI. Další informace najdete v tématu Povolení nastavení správce služby Power BI.
Přidání oborů
Pokud chcete do aplikace Azure AD přidat oprávnění, postupujte takto:
Otevřete aplikaci v Azure.
Vlevo v části Spravovatvyberte oprávnění rozhraní API.
Vyberte Přidat oprávnění.
V okně Vyžadovat oprávnění rozhraní API vyberte služby Power BI .
Vyberte Delegovaná oprávnění. Zobrazí se seznam rozhraní API.
Rozbalte rozhraní API, ke které chcete přidat oprávnění, a vyberte oprávnění, která do něj chcete přidat.
Vyberte Přidat oprávnění.
Odebrání oborů
Pokud chcete odebrat oprávnění z aplikace Azure AD, postupujte takto:
Otevřete aplikaci v Azure.
Vlevo v části Spravovatvyberte oprávnění rozhraní API.
Vyberte místní nabídku (tři tečky oprávnění).
Vyberte Odebrat oprávnění.
Škrcení
Power BI využívá omezování k zajištění optimálního výkonu a spolehlivosti. Aby se zabránilo nadměrnému využití prostředků od jednotlivých uživatelů, Power BI omezuje počet volání rozhraní API v časovém intervalu na uživatele.
Když uživatel odešle řadu požadavků, které během časového intervalu překročí předem určený limit, Power BI na krátkou dobu omezí všechny další žádosti od tohoto uživatele.
Když aplikace dochází k omezování, Power BI vrátí stavový kód HTTP 429 (Příliš mnoho požadavků) s Retry-After hlavičkou HTTP v odpovědi, což udává, kolik sekund musí volající aplikace čekat před vytvořením nového požadavku.
Stahování napříč geografickými oblastmi
Operace, které zahrnují stahování souborů v jiné oblasti než v oblasti, ve které se volání spustilo, může trvat déle, než se čekalo.
Skupiny operací REST
Tato tabulka obsahuje seznam skupin operací rozhraní REST API Power BI.
Poznámka
Ke správě kapacit power BI Embedded použijte rozhraní REST APIPower BI Embedded Azure Resource Manageru.
| Skupina operací | Popis |
|---|---|
| správce | Operace pro práci s úlohami správy |
| Apps | Operace pro práci s aplikacemi |
| dostupné funkce | Operace, které vracejí dostupné funkce. |
| kapacity | Operace pro práci s kapacitami |
| řídicí panely | Operace pro práci s řídicími panely |
| účty úložiště toku dat | Operace pro práci s účty úložiště toku dat |
| toků dat | Operace pro práci s toky dat |
| datových sad | Operace pro práci s datovými sadami |
| tokenu pro vložení | Operace pro práci s tokeny pro vložení |
| brány | Operace pro práci s bránami |
| skupiny | Operace pro práci se skupinami |
| Importy | Operace pro práci s importy |
| kanálů | Operace pro práci s kanály nasazení |
| nabízených datových sad | Operace pro práci s datovými sadami nabízených oznámení |
| sestav | Operace pro práci se sestavami |
| aplikace šablon | Operace pro práci s aplikacemi šablon |
| uživatelé | Operace pro práci s uživateli |