Admin - Dashboards GetDashboardsAsAdmin

Odwołanie

Service:: Power BI REST APIs

API Version:: v1.0

Zwraca listę pulpitów nawigacyjnych dla organizacji.

Uprawnienia

Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Office 365 lub administrator usługi Power BI) lub uwierzytelnić się przy użyciu jednostki usługi.
Uprawnienia delegowane są obsługiwane.

W przypadku uruchamiania w ramach uwierzytelniania prinicipal usługi aplikacja nie może mieć żadnych wymaganych przez administratora premisji dla usługi Power BI ustawionych w Azure Portal.

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

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

Ograniczenia

Maksymalnie 50 żądań na godzinę lub 5 żądań na minutę na dzierżawę.

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards

With optional parameters:

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

Parametry identyfikatora URI

Nazwa	W	Typ	Opis
$expand	query	string	Akceptuje rozdzielaną przecinkami listę typów danych, które zostaną rozwinięte w tekście w odpowiedzi. Obsługuje funkcję `tiles`.
$filter	query	string	Filtruje wyniki na podstawie warunku logicznego
$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	AdminDashboards	OK

Przykłady

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
      "displayName": "SalesMarketing",
      "embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
      "isReadOnly": false,
      "workspaceId": "abfbdc89-2659-43c1-9142-93e8378eac96"
    }
  ]
}

Definicje

Nazwa	Opis
AdminDashboard	Pulpit nawigacyjny usługi Power BI zwrócony przez interfejsy API Administracja. Interfejs API zwraca podzestaw następujących właściwości pulpitu nawigacyjnego. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.
AdminDashboards	Otoka odpowiedzi OData dla kolekcji pulpitów nawigacyjnych usługi Power BI
AdminTile	Kafelek usługi Power BI zwrócony przez interfejsy API Administracja.
DashboardUser	Odpowiedni wpis dostępu użytkownika usługi Power BI dla pulpitu nawigacyjnego
DashboardUserAccessRight	Prawo dostępu, które użytkownik ma dla pulpitu nawigacyjnego (poziom uprawnień)
PrincipalType	Typ podmiotu zabezpieczeń
ServicePrincipalProfile	Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
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

AdminDashboard

Pulpit nawigacyjny usługi Power BI zwrócony przez interfejsy API Administracja. Interfejs API zwraca podzestaw następujących właściwości pulpitu nawigacyjnego. 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 pulpit nawigacyjny należy do aplikacji
displayName	string	Nazwa wyświetlana pulpitu nawigacyjnego
embedUrl	string	Adres URL osadzania pulpitu nawigacyjnego
id	string	Identyfikator pulpitu nawigacyjnego
isReadOnly	boolean	Czy pulpit nawigacyjny jest tylko do odczytu
subscriptions	Subscription[]	(Wartość pusta) 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 dla raportu usługi Power BI można pobrać za pomocą wywołania interfejsu API pobierania raportów jako wywołania interfejsu API Administracja.
tiles	AdminTile[]	Kafelki należące do pulpitu nawigacyjnego
users	DashboardUser[]	(Wartość pusta) Szczegóły dostępu użytkownika pulpitu nawigacyjnego. Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o użytkowniku na pulpicie nawigacyjnym usługi Power BI można pobrać przy użyciu wywołania interfejsu API pobierz pulpit nawigacyjny jako Administracja lub wywołania interfejsu API PostWorkspaceInfo z parametrem `getArtifactUsers` .
webUrl	string	Internetowy adres URL pulpitu nawigacyjnego
workspaceId	string	Identyfikator obszaru roboczego (GUID) pulpitu nawigacyjnego. Ta właściwość zostanie zwrócona tylko w obszarze GetDashboardsAsAdmin.