Sdílet prostřednictvím


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:

  1. Otevřete aplikaci v Azure.

  2. Na levé straně v části Spravovat vyberte Oprávnění rozhraní API.

  3. Vyberte Přidat oprávnění.

  4. V okně Vyžádat oprávnění rozhraní API vyberte Služba Power BI.

  5. Vyberte Delegovaná oprávnění. Zobrazí se seznam rozhraní API.

  6. Rozbalte rozhraní API, ke které chcete přidat oprávnění, a vyberte oprávnění, která chcete přidat.

  7. Vyberte Přidat oprávnění.

Odebrání oborů

Pokud chcete odebrat oprávnění z aplikace Azure AD, postupujte takto:

  1. Otevřete aplikaci v Azure.

  2. Na levé straně v části Spravovat vyberte Oprávnění rozhraní API.

  3. Vyberte místní nabídku (tři tečky oprávnění).

  4. 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.

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

Další kroky