Udostępnij przez

Admin - Users GetUserSubscriptionsAsAdmin

Usługa:
Power BI REST APIs
Wersja interfejsu API:
v1.0

Zwraca listę subskrypcji dla określonego użytkownika. Jest to wywołanie interfejsu API w wersji zapoznawczej.

Uprawnienia

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

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

Ograniczenia

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

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/subscriptions
Z parametrami opcjonalnymi: 
GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/subscriptions?continuationToken={continuationToken}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
userId
 path True

string

Identyfikator grafu lub główna nazwa użytkownika (UPN) użytkownika
continuationToken
 query

string

Token wymagany do pobrania następnego fragmentu zestawu wyników

Odpowiedzi

Nazwa Typ Opis
200 OK

SubscriptionsByUserResponse

OK

Przykłady

Example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
200 
{
  "subscriptionEntities": [
    {
      "id": "9225d0bc-9f5e-4819-a637-799c0c4fh3f1",
      "title": "Team Scorecard-test",
      "artifactId": "0b50f0bf-b22b-4685-83b9-b6d17f7f4e46",
      "artifactDisplayName": "Customer Profitability Sample",
      "subArtifactDisplayName": "Team Scorecard",
      "artifactType": "Report",
      "isEnabled": false,
      "frequency": "Daily",
      "startDate": "8/10/2021 12:00:00 AM",
      "endDate": "8/10/2022 12:00:00 AM",
      "linkToContent": false,
      "previewImage": true,
      "attachmentFormat": "PNG",
      "users": []
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/subscriptions?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Definicje

Nazwa Opis
PrincipalType

Typ podmiotu zabezpieczeń
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)
SubscriptionsByUserResponse

Otoka odpowiedzi OData dla subskrypcji usługi Power BI dla użytkownika
SubscriptionUser

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

PrincipalType

Wyliczanie

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

ServicePrincipalProfile

Objekt

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

Objekt

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, Dashboardlub 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.

SubscriptionsByUserResponse

Objekt

Otoka odpowiedzi OData dla subskrypcji usługi Power BI dla użytkownika

Nazwa Typ Opis
@odata.context

string

continuationToken

string

Token umożliwiający pobranie następnego fragmentu zestawu wyników
continuationUri

string

Identyfikator URI następnego fragmentu w zestawie wyników
subscriptionEntities

Subscription[]

Subskrypcje użytkownika

SubscriptionUser

Objekt

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.