Freigeben über

Imports - Get Import

Dienst:
Power BI REST APIs
API-Version:
v1.0

Gibt den angegebenen Import aus My workspacezurück.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All 

GET https://api.powerbi.com/v1.0/myorg/imports/{importId}

URI-Parameter

Name In Erforderlich Typ Beschreibung
importId
 path True

string (uuid)

Die Import-ID

Antworten

Name Typ Beschreibung
200 OK

Import

OKAY

Beispiele

Completed import example
In-progress import example

Completed import example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/imports/82d9a37a-2b45-4221-b012-cb109b8e30c7

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
  "importState": "Succeeded",
  "createdDateTime": "2018-05-08T14:56:18.477Z",
  "updatedDateTime": "2018-05-08T14:56:18.477Z",
  "name": "SalesMarketing",
  "connectionType": "import",
  "source": "Upload",
  "datasets": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "name": "SalesMarketing",
      "webUrl": "https://app.powerbi.com/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ],
  "reports": [
    {
      "id": "5b218778-e7a5-4d73-8187-f10824047715",
      "name": "SalesMarketing",
      "webUrl": "https://app.powerbi.com/reports/5b218778-e7a5-4d73-8187-f10824047715",
      "embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715"
    }
  ]
}

In-progress import example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/imports/82d9a37a-2b45-4221-b012-cb109b8e30c7

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
  "importState": "Publishing",
  "createdDateTime": "2018-05-08T14:56:18.477Z",
  "updatedDateTime": "2018-05-08T14:56:18.477Z",
  "name": "SalesMarketing",
  "connectionType": "import",
  "source": "Upload",
  "datasets": [],
  "reports": []
}

Definitionen

Name Beschreibung
Dataset

Ein Power BI-Dataset. Die API gibt eine Teilmenge der folgenden Liste der Dataseteigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank ab.
DatasetQueryScaleOutSettings

Abfrageskalierungseinstellungen eines Datasets
DatasetUser

Ein Power BI-Benutzerzugriff für ein Dataset
DatasetUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)
DependentDataflow

Ein abhängiger Power BI-Datenfluss
Encryption

Verschlüsselungsinformationen für ein Dataset
EncryptionStatus

Datensetverschlüsselungsstatus
Import

Das Importobjekt
PrincipalType

Der Prinzipaltyp
Report

Ein Power BI-Bericht. Die API gibt eine Teilmenge der folgenden Liste der Berichtseigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.
ReportUser

Ein Power BI-Benutzerzugriffsrecht für einen Bericht
ReportUserAccessRight

Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)
ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.
Subscription

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

Ein Power BI-E-Mail-Abonnementbenutzer

Dataset

Objekt

Ein Power BI-Dataset. Die API gibt eine Teilmenge der folgenden Liste der Dataseteigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank ab.

Name Typ Beschreibung
ContentProviderType

string

Eine veraltete Eigenschaft, die ignoriert werden soll.
Encryption

Encryption

Datensetverschlüsselungsinformationen. Gilt nur, wenn $expand angegeben wird.
IsEffectiveIdentityRequired

boolean

Gibt an, ob das Dataset eine effektive Identität erfordert, die Sie in einem GenerateToken API-Aufruf senden müssen.
IsEffectiveIdentityRolesRequired

boolean

Gibt an, ob die Sicherheit auf Zeilenebene innerhalb der Power BI-PBIX-Datei definiert ist. Wenn ja, müssen Sie eine Rolle angeben.
IsInPlaceSharingEnabled

boolean

Gibt an, ob das Dataset für externe Benutzer freigegeben werden kann, die in ihrem eigenen Mandanten genutzt werden sollen.
IsOnPremGatewayRequired

boolean

Gibt an, ob für das Dataset ein lokales Datengateway erforderlich ist.
IsRefreshable

boolean

Dieses Feld gibt true zurück, wenn das Dataset kürzlich aktualisiert oder für die automatische Aktualisierung konfiguriert ist, wobei der Verbindungsmodus speziell auf "Import" festgelegt ist. Der Wert gibt false für andere Verbindungsmodi zurück, z. B. "DirectQuery" und "LiveConnection", unabhängig davon, ob das Dataset manuell aktualisiert oder für die automatische Aktualisierung eingerichtet wird.
addRowsAPIEnabled

boolean

Gibt an, ob das Dataset das Hinzufügen neuer Zeilen zulässt.
configuredBy

string

Der Datasetbesitzer
createReportEmbedURL

string

Die Datensatz erstellen Berichtseinbettungs-URL
createdDate

string (date-time)

Datum und Uhrzeit der Datensatzerstellung
description

string

Beschreibung des Datasets
id

string

Die Dataset-ID
name

string

Der Datasetname
qnaEmbedURL

string

Das Dataset Q&Eine Einbettungs-URL
queryScaleOutSettings

DatasetQueryScaleOutSettings

Abfrageskalierungseinstellungen eines Datasets
targetStorageMode

string

Der Datasetspeichermodus
upstreamDataflows

DependentDataflow[]

Die Liste aller Datenflüsse dieses Elements hängt von
users

DatasetUser[]

(Leerer Wert) Die Details des Datasetbenutzerzugriffs. Diese Eigenschaft wird aus der Nutzlastantwort in einer bevorstehenden Version entfernt. Sie können Benutzerinformationen zu einem Power BI-Element (z. B. einem Bericht oder einem Dashboard) abrufen, indem Sie die Get Dataset Users as Admin API oder die PostWorkspaceInfo API mit dem getArtifactUsers Parameter verwenden.
webUrl

string

Die Web-URL des Datasets

DatasetQueryScaleOutSettings

Objekt

Abfrageskalierungseinstellungen eines Datasets

Name Typ Beschreibung
autoSyncReadOnlyReplicas

boolean

Gibt an, ob das Dataset schreibgeschützte Replikate automatisch synchronisiert.
maxReadOnlyReplicas

integer

minimum: -1
maximum: 64

Maximale Anzahl schreibgeschützter Replikate für das Dataset (0-64, -1 für die automatische Anzahl von Replikaten)

DatasetUser

Objekt

Ein Power BI-Benutzerzugriff für ein Dataset

Name Typ Beschreibung
datasetUserAccessRight

DatasetUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)
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-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.
userType

string

Typ des Benutzers.

DatasetUserAccessRight

Enumeration

Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)

Wert Beschreibung
None

Entfernt die Berechtigung für den Inhalt im Dataset.
Read

Gewährt Lesezugriff auf den Inhalt im Dataset
ReadWrite

Gewährt Lese- und Schreibzugriff auf den Inhalt im Dataset
ReadReshare

Gewährt Lese- und Freigabezugriff auf den Inhalt im Dataset
ReadWriteReshare

Gewährt Lese-, Schreib- und Freigabezugriff auf den Inhalt im Dataset
ReadExplore

Gewährt Lese- und Erkundungszugriff auf den Inhalt im Dataset
ReadReshareExplore

Gewährt Lese-, Freigabe- und Erkunden des Zugriffs auf den Inhalt im Dataset
ReadWriteExplore

Gewährt Lese-, Schreib- und Erkunden des Zugriffs auf den Inhalt im Dataset
ReadWriteReshareExplore

Gewährt Lese-, Schreib-, Refreigabe- und Erkunden des Zugriffs auf den Inhalt im Dataset

DependentDataflow

Objekt

Ein abhängiger Power BI-Datenfluss

Name Typ Beschreibung
groupId

string

Die Zielgruppen-ID
targetDataflowId

string

Die Zieldatenfluss-ID

Encryption

Objekt

Verschlüsselungsinformationen für ein Dataset

Name Typ Beschreibung
EncryptionStatus

EncryptionStatus

Datensetverschlüsselungsstatus

EncryptionStatus

Enumeration

Datensetverschlüsselungsstatus

Wert Beschreibung
Unknown

Der Verschlüsselungsstatus ist aufgrund von Datasetbeschädigungen unbekannt.
NotSupported

Die Verschlüsselung wird für dieses Dataset nicht unterstützt.
InSyncWithWorkspace

Die Verschlüsselung wird unterstützt und wird mit den Verschlüsselungseinstellungen synchronisiert.
NotInSyncWithWorkspace

Verschlüsselung wird unterstützt, aber nicht mit den Verschlüsselungseinstellungen synchronisiert

Import

Objekt

Das Importobjekt

Name Typ Beschreibung
createdDateTime

string (date-time)

Erstellungsdatum und -uhrzeit importieren
datasets

Dataset[]

Die Datasets, die diesem Import zugeordnet sind
id

string (uuid)

Die Import-ID
importState enum:
  • Failed
  • Publishing
  • Succeeded

Der Importuploadstatus
name

string

Der Importname
reports

Report[]

Die diesem Import zugeordneten Berichte
updatedDateTime

string (date-time)

Datum und Uhrzeit der letzten Aktualisierung importieren

PrincipalType

Enumeration

Der Prinzipaltyp

Wert Beschreibung
None

Kein Prinzipaltyp. Wird für den Zugriff auf ganze Organisationsebene verwendet.
User

Benutzerprinzipaltyp
Group

Gruppenprinzipaltyp
App

Dienstprinzipaltyp

Report

Objekt

Ein Power BI-Bericht. Die API gibt eine Teilmenge der folgenden Liste der Berichtseigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.

Name Typ Beschreibung
appId

string

Die App-ID, die nur zurückgegeben wird, wenn der Bericht zu einer App gehört
datasetId

string

Die Dataset-ID des Berichts
description

string

Beschreibung des Berichts
embedUrl

string

Die Einbettungs-URL des Berichts
format

string

Der Berichtsdefinitionsformattyp. Für PowerBIReport:

Für PaginatedReport:
id

string (uuid)

Die Berichts-ID
isOwnedByMe

boolean

Gibt an, ob der aktuelle Benutzer entweder eine Kopie des Berichts ändern oder erstellen kann.
name

string

Der Name des Berichts. App-Berichte beginnen mit dem Präfix [App].
originalReportId

string (uuid)

Die tatsächliche Berichts-ID, wenn der Arbeitsbereich als App veröffentlicht wird.
reportType enum:
  • PaginatedReport
  • PowerBIReport

Der Berichtstyp
subscriptions

Subscription[]

(Leerer Wert) Die Abonnementdetails für ein Power BI-Element (z. B. einen Bericht oder ein Dashboard). Diese Eigenschaft wird aus der Nutzlastantwort in einer bevorstehenden Version entfernt. Sie können Abonnementinformationen für einen Power BI-Bericht abrufen, indem Sie den Abrufen von Berichtsabonnements als Administrator- API-Aufruf verwenden.
users

ReportUser[]

(Leerer Wert) Der Benutzer greift auf Details für einen Power BI-Bericht zu. Diese Eigenschaft wird aus der Nutzlastantwort in einer bevorstehenden Version entfernt. Sie können Benutzerinformationen in einem Power BI-Bericht abrufen, indem Sie die Abrufen von Berichtsbenutzern als Administrator- API-Aufruf oder den PostWorkspaceInfo API-Aufruf mit dem parameter getArtifactUsers verwenden.
webUrl

string

Die Web-URL des Berichts

ReportUser

Objekt

Ein Power BI-Benutzerzugriffsrecht für einen Bericht

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-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.
reportUserAccessRight

ReportUserAccessRight

Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)
userType

string

Typ des Benutzers.

ReportUserAccessRight

Enumeration

Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)

Wert Beschreibung
None

Keine Berechtigung für Inhalte im Bericht
Read

Gewährt Lesezugriff auf Inhalte im Bericht
ReadWrite

Gewährt Lese- und Schreibzugriff auf Inhalte im Bericht
ReadReshare

Gewährt Lese- und Freigabezugriff auf Inhalte im Bericht
ReadCopy

Gewährt Lese- und Kopierzugriff auf Inhalte im Bericht
Owner

Gewährt Lese-, Schreib- und Freigabezugriff auf Inhalte im Bericht

ServicePrincipalProfile

Objekt

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname
id

string (uuid)

Die Dienstprinzipalprofil-ID

Subscription

Objekt

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

Name Typ Beschreibung
artifactDisplayName

string

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

string (uuid)

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

string

Der Typ des Power BI-Elements (z. B. ein Report, Dashboardoder Dataset)
attachmentFormat

string

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

string (date-time)

Enddatum und -uhrzeit des E-Mail-Abonnements
frequency

string

Die Häufigkeit des E-Mail-Abonnements
id

string (uuid)

Die Abonnement-ID
isEnabled

boolean

Gibt an, ob das E-Mail-Abonnement aktiviert ist.
linkToContent

boolean

Gibt an, ob ein Abonnementlink im E-Mail-Abonnement vorhanden ist.
previewImage

boolean

Gibt an, ob ein Screenshot des Berichts im E-Mail-Abonnement vorhanden ist.
startDate

string (date-time)

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. Bei Verwendung des Abrufen von Benutzerabonnements als Administrator API-Aufruf ist der zurückgegebene Wert ein leeres Array (NULL). Diese Eigenschaft wird aus der Nutzlastantwort in einer bevorstehenden Version entfernt. Sie können Abonnementinformationen in einem Power BI-Bericht oder -Dashboard abrufen, indem Sie die Abrufen von Berichtsabonnements als Administrator- oder Abrufen von Dashboardabonnements als Administrator API-Aufrufen verwenden.

SubscriptionUser

Objekt

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-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.
userType

string

Typ des Benutzers.