Korzystanie z interfejsów API REST usługi Power BI
Interfejsy API REST usługi Power BI zapewniają punkty końcowe usługi do osadzania, administrowania, ładu i zasobów użytkowników.
Za pomocą interfejsów API REST usługi Power BI można wykonać następujące czynności:
Zarządzanie zawartością usługi Power BI
Wykonywanie operacji administracyjnych
Osadzanie zawartości usługi Power BI
Nuta
Niektóre interfejsy API usługi Power BI odnoszą się do obszarów roboczych jako grup. Każde odwołanie do grup oznacza, że pracujesz z obszarami roboczymi.
Podczas uzyskiwania dostępu do interfejsu API REST usługi Power BI twoje żądanie i zawartość odpowiedzi oraz dane mogą być przetwarzane przez centra danych w regionach innych niż region macierzysty dzierżawy usługi Power BI.
Zakresów
Aby korzystać z interfejsów API REST usługi Power BI, musisz zarejestrować aplikację usługi Azure Active Directory (Azure AD) na platformie Azure. Aplikacja usługi Azure AD ustanawia uprawnienia dla zasobów REST usługi Power BI i umożliwia dostęp do interfejsów API REST usługi Power BI. Aby dowiedzieć się, jak zarejestrować aplikację, zobacz Rejestrowanie aplikacji usługi Azure AD do użycia z usługą Power BI.
Po zarejestrowaniu aplikacji usługi Azure AD można ją uwierzytelnić przy użyciu usługi Azure AD (wersja 1.0; ADAL) lub platforma tożsamości firmy Microsoft (wersja 2.0; Punkty końcowe biblioteki MSAL. Aby dowiedzieć się więcej na temat sposobu działania tych metod uwierzytelniania, zobacz Dlaczego warto zaktualizować platformę tożsamości firmy Microsoft (wersja 2.0)?
Aby uzyskać więcej informacji na temat uprawnień dostępu do usługi Power BI, zobacz Uprawnienia i zgoda w punkcie końcowym platformy tożsamości firmy Microsoft.
Używanie jednostki usługi
Zakresy nie są wymagane, jeśli używasz jednostki usługi. Po włączeniu jednostki usługi do użycia z usługą Power BI uprawnienia usługi AD aplikacji nie będą już obowiązywać. W przypadku korzystania z jednostki usługi uprawnienia aplikacji są zarządzane za pośrednictwem portalu administracyjnego usługi Power BI. Aby uzyskać więcej informacji, zobacz Włączanie ustawień administratora usługi Power BI.
Dodawanie zakresów
Aby dodać uprawnienia do aplikacji usługi Azure AD, wykonaj następujące kroki:
Otwórz aplikację na platformie Azure.
Po lewej stronie w obszarze Zarządzajwybierz pozycję uprawnienia interfejsu API .
Wybierz pozycję Dodaj uprawnienie.
W oknie Zażądaj uprawnień interfejsu API wybierz pozycję usługi Power BI.
Wybierz Uprawnienia delegowane. Zostanie wyświetlona lista interfejsów API.
Rozwiń interfejs API, do którego chcesz dodać uprawnienia, i wybierz uprawnienia, do których chcesz dodać.
Wybierz pozycję Dodaj uprawnienia.
Usuwanie zakresów
Aby usunąć uprawnienia z aplikacji usługi Azure AD, wykonaj następujące kroki:
Otwórz aplikację na platformie Azure.
Po lewej stronie w obszarze Zarządzajwybierz pozycję uprawnienia interfejsu API .
Wybierz menu kontekstowe (wielokropek uprawnień).
Wybierz pozycję Usuń uprawnienie.
Dławienie
Usługa Power BI używa ograniczania przepustowości, aby zachować optymalną wydajność i niezawodność. Aby zapobiec nadmiernemu użyciu zasobów od pojedynczych użytkowników, usługa Power BI ogranicza liczbę wywołań interfejsu API w przedziale czasu na użytkownika.
Gdy użytkownik wysyła liczbę żądań przekraczających wstępnie określony limit w przedziale czasu, usługa Power BI ogranicza wszelkie dalsze żądania od tego użytkownika przez krótki czas.
Gdy w aplikacjach występuje ograniczanie przepustowości, usługa Power BI zwraca kod stanu HTTP 429 (zbyt wiele żądań) z nagłówkiem HTTP Retry-After w odpowiedzi wskazującą, ile sekund aplikacja wywołująca musi czekać przed utworzeniem nowego żądania.
Pobieranie między regionami geograficznymi
Operacje obejmujące pobieranie plików w innym regionie niż region, w którym wykonano wywołanie, mogą trwać dłużej niż oczekiwano.
Grupy operacji REST
W tej tabeli wymieniono grupy operacji interfejsu API REST usługi Power BI.
Nuta
Aby zarządzać pojemnościami usługi Power BI Embedded, użyj interfejsów API REST usługi Power BI Embedded usługi Azure Resource Manager.
| Grupa operacji | Opis |
|---|---|
| administratora | Operacje pracy z zadaniami administracyjnymi. |
| Apps | Operacje na potrzeby pracy z aplikacjami. |
| dostępne funkcje | Operacje zwracające dostępne funkcje. |
| pojemności | Operacje pracy z pojemnościami. |
| Pulpity nawigacyjne | Operacje pracy z pulpitami nawigacyjnymi. |
| konta magazynu przepływu danych | Operacje pracy z kontami magazynu przepływu danych. |
| przepływy danych | Operacje pracy z przepływami danych. |
| zestawy danych | Operacje pracy z zestawami danych. |
| osadzania tokenu | Operacje pracy z tokenami osadzania. |
| bram | Operacje pracy z bramami. |
| grupy | Operacje pracy z grupami. |
| importuje | Operacje pracy z importami. |
| potoków | Operacje na potrzeby pracy z potokami wdrażania. |
| wypychanie zestawów danych | Operacje pracy z zestawami danych wypychania. |
| Raporty | Operacje na potrzeby pracy z raportami. |
| Template Apps | Operacje pracy z aplikacjami szablonów. |
| użytkownicy | Operacje na potrzeby pracy z użytkownikami. |