Freigeben über


Admin - Reports GetReportSubscriptionsAsAdmin

Gibt eine Liste von Berichtsabonnements zusammen mit Abonnentendetails zurück. Dies ist ein Vorschau-API-Aufruf.

Berechtigungen

  • Der Benutzer muss über Administratorrechte (z. B. Office 365 globalen Administrator oder Power BI-Dienstadministrator) verfügen oder sich mit einem Dienstprinzipal authentifizieren.
  • Delegierte Berechtigungen werden unterstützt.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Einschränkungen

Maximal 200 Anforderungen pro Stunde.

GET https://api.powerbi.com/v1.0/myorg/admin/reports/{reportId}/subscriptions

URI-Parameter

Name In Erforderlich Typ Beschreibung
reportId
path True

string

uuid

Die Berichts-ID

Antworten

Name Typ Beschreibung
200 OK

Subscriptions

OK

Beispiele

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/reports/{reportId}/subscriptions

Sample Response

{
  "value": [
    {
      "id": "18b746fe-c6d5-4a00-9523-05dc91424274",
      "title": "TestReportSubscription-1",
      "artifactId": "7b71b90a-a333-4006-b12c-ef3d767fa4e9",
      "artifactDisplayName": "Customer Profitability Sample",
      "subArtifactDisplayName": "Team Scorecard",
      "artifactType": "Report",
      "isEnabled": true,
      "frequency": "Daily",
      "startDate": "10/13/2021 12:00:00 AM",
      "endDate": "10/13/2022 12:00:00 AM",
      "linkToContent": true,
      "previewImage": true,
      "attachmentFormat": "PNG",
      "users": [
        {
          "displayName": "John Nick",
          "emailAddress": "john@contoso.com",
          "identifier": "john@contoso.com",
          "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
          "principalType": "User"
        }
      ]
    }
  ]
}

Definitionen

Name Beschreibung
PrincipalType

Der Prinzipaltyp

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

Subscription

Ein E-Mail-Abonnement für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard)

Subscriptions

OData-Antwort-Wrapper für power BI-Abonnements

SubscriptionUser

Ein Power BI-E-Mail-Abonnementbenutzer

PrincipalType

Der Prinzipaltyp

Name Typ Beschreibung
App

string

Dienstprinzipaltyp

Group

string

Gruppenprinzipaltyp

None

string

Kein Prinzipaltyp. Verwenden Sie für den Zugriff auf organization ganzen Organization ebene.

User

string

Benutzerprinzipaltyp

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname

id

string

Die Dienstprinzipalprofil-ID

Subscription

Ein E-Mail-Abonnement für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard)

Name Typ Beschreibung
artifactDisplayName

string

Der Name des abonnierten Power BI-Elements (z. B. ein Bericht oder ein Dashboard)

artifactId

string

Die ID des abonnierten Power BI-Elements (z. B. ein Bericht oder ein Dashboard)

artifactType

string

Der Typ des Power BI-Elements (z. B. , ReportDashboardoder Dataset)

attachmentFormat

string

Format des Berichts, der im E-Mail-Abonnement angefügt ist

endDate

string

Enddatum und -uhrzeit des E-Mail-Abonnements

frequency

string

Häufigkeit des E-Mail-Abonnements

id

string

Die Abonnement-ID

isEnabled

boolean

Ob das E-Mail-Abonnement aktiviert ist

linkToContent

boolean

Ob ein Abonnementlink im E-Mail-Abonnement vorhanden ist

previewImage

boolean

Ob ein Screenshot des Berichts im E-Mail-Abonnement vorhanden ist

startDate

string

Startdatum und -uhrzeit des E-Mail-Abonnements

subArtifactDisplayName

string

Der Seitenname des abonnierten Power BI-Elements, wenn es sich um einen Bericht handelt.

title

string

Der App-Name

users

SubscriptionUser[]

Die Details der einzelnen E-Mail-Abonnenten. Wenn Sie den API-Aufruf "Benutzerabonnements abrufen als Admin" verwenden, ist der zurückgegebene Wert ein leeres Array (NULL). Diese Eigenschaft wird in einer bevorstehenden Version aus der Nutzlastantwort entfernt. Sie können Abonnementinformationen für einen Power BI-Bericht oder Dashboard abrufen, indem Sie die API-Aufrufe Berichtsabonnements abrufen als Admin oder Dashboardabonnements abrufen als Admin verwenden.

Subscriptions

OData-Antwort-Wrapper für power BI-Abonnements

Name Typ Beschreibung
odata.context

string

value

Subscription[]

Power BI-E-Mail-Abonnement

SubscriptionUser

Ein Power BI-E-Mail-Abonnementbenutzer

Name Typ Beschreibung
displayName

string

Anzeigename des Prinzipals

emailAddress

string

E-Mail-Adresse des Benutzers

graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.

identifier

string

Bezeichner des Prinzipals

principalType

PrincipalType

Der Prinzipaltyp

profile

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

userType

string

Typ des Benutzers.