Za pomocą interfejsów API REST usługi Power BI
Interfejsy API REST usługi Power BI zapewniają punkty końcowe usługi na potrzeby 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
Uwaga
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 zawartość żądania i odpowiedzi oraz dane mogą być przetwarzane przez centra danych w regionach innych niż region macierzysty dzierżawy usługi Power BI.
Zakresy
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 do 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 Azure AD do użycia z usługą Power BI.
Po zarejestrowaniu aplikacji Azure AD można ją uwierzytelnić przy użyciu Azure AD (wersja 1.0; ADAL) lub Platforma tożsamości 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ć Platforma tożsamości Microsoft (wersja 2.0)?
Aby dowiedzieć się więcej o uprawnieniach dostępu w usłudze Power BI, zobacz Uprawnienia i zgoda w punkcie końcowym platformy tożsamości firmy Microsoft.
Korzystanie z 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ługa Power BI.
Dodawanie zakresów
Aby dodać uprawnienia do aplikacji Azure AD, wykonaj następujące kroki:
Otwórz aplikację na platformie Azure.
Po lewej stronie w obszarze Zarządzanie wybierz pozycję Uprawnienia interfejsu API.
Wybierz pozycję Dodaj uprawnienie.
W oknie Żądanie uprawnień interfejsu API wybierz pozycję Usługa Power BI.
Wybierz pozycję Uprawnienia delegowane. Zostanie wyświetlona lista interfejsów API.
Rozwiń interfejs API, do którego chcesz dodać uprawnienia, a następnie wybierz uprawnienia, które chcesz dodać do niego.
Wybierz pozycję Dodaj uprawnienia.
Usuwanie zakresów
Aby usunąć uprawnienia z aplikacji Azure AD, wykonaj następujące kroki:
Otwórz aplikację na platformie Azure.
Po lewej stronie w obszarze Zarządzanie wybierz pozycję Uprawnienia interfejsu API.
Wybierz menu Kontekst (wielokropek uprawnień).
Wybierz pozycję Usuń uprawnienie.
Ograniczanie przepływności
Usługa Power BI używa ograniczania przepustowości do utrzymania optymalnej wydajności i niezawodności. Aby zapobiec nadmiernemu zużytkowaniu zasobów przez 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 wykonaniem nowego żądania.
Grupy operacji REST
Ta tabela zawiera listę grup operacji interfejsu API REST usługi Power BI.
Uwaga
Aby zarządzać Power BI Embedded pojemnościami, użyj interfejsów API REST Power BI Embedded Azure Resource Manager.
| Grupa operacji | Opis |
|---|---|
| Administracja | Operacje pracy z zadaniami administracyjnymi. |
| Aplikacje | Operacje 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. |
| Token osadzania | Operacje pracy z tokenami osadzania. |
| Bramy | Operacje pracy z bramami. |
| Grupy | Operacje pracy z grupami. |
| Przywozu | Operacje pracy z importami. |
| Pipelines | Operacje pracy z potokami wdrażania. |
| Wypychanie zestawów danych | Operacje pracy z zestawami danych wypychania. |
| Raporty | Operacje pracy z raportami. |
| Aplikacje szablonów | Operacje pracy z aplikacjami szablonów. |
| Użytkownicy | Operacje pracy z użytkownikami. |