Pomocí 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 prostředky uživatelů.
Pomocí rozhraní REST API Power BI můžete provádět 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 označují pracovní prostory jako skupiny. Jakýkoli odkaz na skupiny znamená, že pracujete s pracovními prostory.
Při přístupu k rozhraní REST API Power BI můžou data a obsah požadavků a odpovědí zpracovávat datová centra v jiných oblastech, než je domovská oblast vašeho tenanta Power BI.
Obory
Pokud chcete používat rozhraní REST API Power BI, musíte v Azure zaregistrovat aplikaci Azure Active Directory (Azure AD). 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 se u ní můžete ověřit pomocí Azure AD (v1.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 na 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žba Power BI.
Přidání oborů
Pokud chcete do aplikace Azure AD přidat oprávnění, postupujte takto:
Otevřete aplikaci v Azure.
Na levé straně v části Spravovat vyberte Oprávnění rozhraní API.
Vyberte Přidat oprávnění.
V okně Vyžádat oprávnění rozhraní API vyberte Služba 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á 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.
Na levé straně v části Spravovat vyberte Oprávnění rozhraní API.
Vyberte místní nabídku (tři tečky oprávnění).
Vyberte Odebrat oprávnění.
Throttling
Power BI používá omezování k udržení optimálního výkonu a spolehlivosti. Aby se zabránilo nadměrnému používání 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 během časového intervalu odešle několik požadavků, které překročí předem stanovený limit, Power BI na krátkou dobu omezí všechny další požadavky od tohoto uživatele.
Když u aplikací dochází k omezování, vrátí Power BI stavový kód HTTP 429 (Příliš mnoho požadavků) s Retry-After hlavičkou HTTP v odpovědi, která označuje, kolik sekund musí volající aplikace čekat, než odešle nový požadavek.
Skupiny operací REST
Tato tabulka uvádí skupiny operací rozhraní REST API Power BI.
Poznámka
Ke správě Power BI Embedded kapacit použijte rozhraní REST API Power BI Embedded Azure Resource Manager.
| Skupina operací | Description |
|---|---|
| Správce | Operace pro práci s úlohami správy |
| Aplikace | Operace pro práci s aplikacemi. |
| Dostupné funkce | Operace, které vracejí dostupné funkce. |
| Capacities | 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 |
| Toky dat | Operace pro práci s toky dat |
| Datové sady | Operace pro práci s datovými sadami |
| Vložený token | Operace pro práci s tokeny vložení |
| Brány | Operace pro práci s bránami |
| Skupiny | Operace pro práci se skupinami |
| Dovoz | Operace pro práci s importy |
| Pipelines | Operace pro práci s kanály nasazení |
| Datové sady nabízených oznámení | Operace pro práci s datovými sadami nabízených oznámení |
| Sestavy | Operace pro práci se sestavami |
| Aplikace šablon | Operace pro práci s aplikacemi šablon |
| Uživatelé | Operace pro práci s uživateli |