Admin - Reports GetReportsInGroupAsAdmin

Usługa:: Power BI REST APIs

Wersja interfejsu API:: v1.0

Zwraca listę raportów z określonego obszaru roboczego.

Uprawnienia

Użytkownik musi być administratorem sieci szkieletowej lub uwierzytelniać się przy użyciu jednostki usługi.
Uprawnienia delegowane są obsługiwane.

W przypadku uruchamiania w ramach uwierzytelniania podstawowego usługi aplikacji nie może mieć żadnych premii wymaganych przez administratora dla usługi Power BI ustawionych w witrynie Azure Portal.

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego delegowanego tokenu dostępu administratora. Nie może być obecny, gdy jest używane uwierzytelnianie za pośrednictwem jednostki usługi.

Ograniczenia

Maksymalna liczba żądań na godzinę wynosi 200.

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/reports

Z parametrami opcjonalnymi:

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/reports?$filter={$filter}&$top={$top}&$skip={$skip}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
groupId	path	True	string (uuid)	Identyfikator obszaru roboczego
$filter	query		string	Zwraca podzbiór wyników na podstawie warunku parametru zapytania filtru Odata.
$skip	query		integer (int32)	Pomija pierwsze n wyników
$top	query		integer (int32)	Zwraca tylko pierwsze n wyników

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AdminReports	OK

Przykłady

Example

Przykładowe zapytanie

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports

Przykładowa odpowiedź

Kod stanu:: 200

{
  "value": [
    {
      "datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "id": "5b218778-e7a5-4d73-8187-f10824047715",
      "name": "SalesMarketing",
      "webUrl": "https://app.powerbi.com/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/5b218778-e7a5-4d73-8187-f10824047715",
      "embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715&groupId=f089354e-8366-4e18-aea3-4cb4a3a50b48"
    }
  ]
}

Definicje

Nazwa	Opis
AdminReport	Raport usługi Power BI zwrócony przez interfejsy API administratora. Interfejs API zwraca podzestaw następujących właściwości raportu. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.
AdminReports	Otoka odpowiedzi OData dla kolekcji raportów administratora usługi Power BI
PrincipalType	Typ podmiotu zabezpieczeń
ReportUser	Wpis prawa dostępu użytkownika usługi Power BI dla raportu
ReportUserAccessRight	Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)
ServicePrincipalProfile	Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.
Subscription	Subskrypcja poczty e-mail dla elementu usługi Power BI (na przykład raportu lub pulpitu nawigacyjnego)
SubscriptionUser	Użytkownik subskrypcji poczty e-mail usługi Power BI

AdminReport

Sprzeciwiać się

Raport usługi Power BI zwrócony przez interfejsy API administratora. Interfejs API zwraca podzestaw następujących właściwości raportu. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.

Nazwa	Typ	Opis
appId	string	Identyfikator aplikacji zwrócony tylko wtedy, gdy raport należy do aplikacji
createdBy	string	Właściciel raportu. Dostępne tylko dla raportów utworzonych po czerwcu 2019 r.
createdDateTime	string (date-time)	Data i godzina utworzenia raportu
datasetId	string	Identyfikator zestawu danych raportu
description	string	Opis raportu
embedUrl	string	Adres URL osadzania raportu
format	string	Typ formatu definicji raportu. W przypadku usługi PowerBIReport: PbIR PBIR —starsza wersja W przypadku raportu podzielonego na strony: `RDL`
id	string (uuid)	Identyfikator raportu
isOwnedByMe	boolean	Wskazuje, czy bieżący użytkownik ma możliwość modyfikowania lub tworzenia kopii raportu.
modifiedBy	string	Ostatni użytkownik, który zmodyfikował raport
modifiedDateTime	string (date-time)	Data i godzina ostatniej modyfikacji raportu
name	string	Nazwa raportu. Raporty aplikacji zaczynają się od prefiksu [App].
originalReportObjectId	string (uuid)	Rzeczywisty identyfikator raportu po opublikowaniu obszaru roboczego jako aplikacja.
reportType	enum: PaginatedReport PowerBIReport	Typ raportu
subscriptions	Subscription[]	(Pusta wartość) Szczegóły subskrypcji elementu usługi Power BI (takie jak raport lub pulpit nawigacyjny). Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o subskrypcji raportu usługi Power BI można pobrać przy użyciu Pobierz subskrypcje raportów jako wywołanie interfejsu API administratora.
users	ReportUser[]	(Pusta wartość) Szczegóły dostępu użytkownika dla raportu usługi Power BI. Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o użytkowniku w raporcie usługi Power BI można pobrać przy użyciu wywołania interfejsu API administratora Pobierz użytkowników raportów lub wywołania interfejsu API PostWorkspaceInfo z parametrem `getArtifactUsers`.
webUrl	string	Internetowy adres URL raportu
workspaceId	string (uuid)	Identyfikator obszaru roboczego (GUID) raportu. Ta właściwość zostanie zwrócona tylko w getReportsAsAdmin.

AdminReports

Sprzeciwiać się

Otoka odpowiedzi OData dla kolekcji raportów administratora usługi Power BI

Nazwa	Typ	Opis
@odata.context	string	Kontekst OData
value	AdminReport[]	Kolekcja raportów

PrincipalType

Wyliczenie

Typ podmiotu zabezpieczeń

Wartość	Opis
None	Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.
User	Typ podmiotu zabezpieczeń użytkownika
Group	Typ podmiotu zabezpieczeń grupy
App	Typ jednostki usługi

ReportUser

Sprzeciwiać się

Wpis prawa dostępu użytkownika usługi Power BI dla raportu

Nazwa	Typ	Opis
displayName	string	Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress	string	Adres e-mail użytkownika
graphId	string	Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratorów.
identifier	string	Identyfikator podmiotu zabezpieczeń
principalType	PrincipalType	Typ podmiotu zabezpieczeń
profile	ServicePrincipalProfile	Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.
reportUserAccessRight	ReportUserAccessRight	Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)
userType	string	Typ użytkownika.

ReportUserAccessRight

Wyliczenie

Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)

Wartość	Opis
None	Brak uprawnień do zawartości w raporcie
Read	Przyznaje dostęp do odczytu zawartości w raporcie
ReadWrite	Udziela dostępu do odczytu i zapisu do zawartości w raporcie
ReadReshare	Udziela dostępu do odczytu i udostępniania dalej zawartości w raporcie
ReadCopy	Przyznaje dostęp do odczytu i kopiowania zawartości w raporcie
Owner	Udziela dostępu do odczytu, zapisu i udostępniania dalej do zawartości w raporcie

ServicePrincipalProfile

Sprzeciwiać się

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.

Nazwa	Typ	Opis
displayName	string	Nazwa profilu jednostki usługi
id	string (uuid)	Identyfikator profilu jednostki usługi

Subscription

Sprzeciwiać się

Subskrypcja poczty e-mail dla elementu usługi Power BI (na przykład raportu lub pulpitu nawigacyjnego)

Nazwa	Typ	Opis
artifactDisplayName	string	Nazwa subskrybowanego elementu usługi Power BI (na przykład raportu lub pulpitu nawigacyjnego)
artifactId	string (uuid)	Identyfikator subskrybowanego elementu usługi Power BI (na przykład raportu lub pulpitu nawigacyjnego)
artifactType	string	Typ elementu usługi Power BI (na przykład `Report`, `Dashboard`lub `Dataset`)
attachmentFormat	string	Format raportu dołączonego do subskrypcji poczty e-mail
endDate	string (date-time)	Data i godzina zakończenia subskrypcji poczty e-mail
frequency	string	Częstotliwość subskrypcji poczty e-mail
id	string (uuid)	Identyfikator subskrypcji
isEnabled	boolean	Czy subskrypcja poczty e-mail jest włączona
linkToContent	boolean	Czy link subskrypcji istnieje w subskrypcji poczty e-mail
previewImage	boolean	Czy zrzut ekranu raportu istnieje w subskrypcji poczty e-mail
startDate	string (date-time)	Data i godzina rozpoczęcia subskrypcji poczty e-mail
subArtifactDisplayName	string	Nazwa strony subskrybowanego elementu usługi Power BI, jeśli jest to raport.
title	string	Nazwa aplikacji
users	SubscriptionUser[]	Szczegóły poszczególnych subskrybentów poczty e-mail. W przypadku używania wywołania interfejsu API Pobierz subskrypcje użytkowników jako administrator zwracana wartość jest pustą tablicą (null). Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o subskrypcji w raporcie lub pulpicie nawigacyjnym usługi Power BI można pobrać przy użyciu Pobierz subskrypcje raportów jako administrator lub Pobierz subskrypcje pulpitu nawigacyjnego jako wywołania interfejsu API administratora.

SubscriptionUser

Sprzeciwiać się

Użytkownik subskrypcji poczty e-mail usługi Power BI

Nazwa	Typ	Opis
displayName	string	Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress	string	Adres e-mail użytkownika
graphId	string	Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratorów.
identifier	string	Identyfikator podmiotu zabezpieczeń
principalType	PrincipalType	Typ podmiotu zabezpieczeń
profile	ServicePrincipalProfile	Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.
userType	string	Typ użytkownika.

Udostępnij przez

Admin - Reports GetReportsInGroupAsAdmin

Uprawnienia

Wymagany zakres

Ograniczenia

Parametry identyfikatora URI

Odpowiedzi

Przykłady

Example

Przykładowe zapytanie

Przykładowa odpowiedź

Definicje

AdminReport

AdminReports

PrincipalType

ReportUser

ReportUserAccessRight

ServicePrincipalProfile

Subscription

SubscriptionUser