Imports - Get Import In Group
Zwraca określony import z określonego obszaru roboczego.
Uprawnienia
To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w Power BI Embedded.
Zakres wymagany
Dataset.ReadWrite.All lub Dataset.Read.All
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/imports/{importId}
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
group
|
path | True |
string uuid |
Identyfikator obszaru roboczego |
import
|
path | True |
string uuid |
Identyfikator importu |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK |
Przykłady
Completed import example |
In-progress import example |
Completed import example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/imports/82d9a37a-2b45-4221-b012-cb109b8e30c7
Sample Response
{
"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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}
],
"reports": [
{
"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"
}
]
}
In-progress import example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/imports/82d9a37a-2b45-4221-b012-cb109b8e30c7
Sample Response
{
"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": []
}
Definicje
Nazwa | Opis |
---|---|
Dataset |
Zestaw danych usługi Power BI. Interfejs API zwraca podzestaw następujących właściwości zestawu danych. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI. |
Dataset |
Wykonywanie zapytań dotyczących ustawień skalowania w poziomie zestawu danych |
Dataset |
Wpis prawa dostępu użytkownika usługi Power BI dla zestawu danych |
Dataset |
Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień) |
Dependent |
Zależny od przepływu danych usługi Power BI |
Encryption |
Informacje o szyfrowaniu zestawu danych |
Encryption |
Stan szyfrowania zestawu danych |
Import |
Obiekt importu |
Principal |
Typ podmiotu zabezpieczeń |
Report |
Raport usługi Power BI. Interfejs API zwraca podzbiór następujących właściwości raportu. Podzbiór zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI. |
Report |
Wpis prawa dostępu użytkownika usługi Power BI dla raportu |
Report |
Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień) |
Service |
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) |
Subscription |
Użytkownik subskrypcji e-mail usługi Power BI |
Dataset
Zestaw danych usługi Power BI. Interfejs API zwraca podzestaw następujących właściwości zestawu danych. 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 |
---|---|---|
ContentProviderType |
string |
Typ dostawcy zawartości dla zestawu danych |
CreateReportEmbedURL |
string |
Adres URL osadzania raportu tworzenia zestawu danych |
CreatedDate |
string |
Data i godzina utworzenia zestawu danych |
Encryption |
Informacje o szyfrowaniu zestawu danych. Ma zastosowanie tylko wtedy, gdy |
|
IsEffectiveIdentityRequired |
boolean |
Określa, czy zestaw danych wymaga obowiązującej tożsamości, którą należy wysłać w wywołaniu interfejsu API GenerateToken . |
IsEffectiveIdentityRolesRequired |
boolean |
Określa, czy zabezpieczenia na poziomie wiersza są zdefiniowane wewnątrz pliku pbix usługi Power BI. Jeśli tak, musisz określić rolę. |
IsInPlaceSharingEnabled |
boolean |
Określa, czy zestaw danych może być udostępniany użytkownikom zewnętrznym do użycia we własnej dzierżawie |
IsOnPremGatewayRequired |
boolean |
Czy zestaw danych wymaga lokalnej bramy danych |
IsRefreshable |
boolean |
Niezależnie od tego, czy zestaw danych jest odświeżalny, czy nie. Zestaw danych z możliwością odświeżania usługi Power BI to zestaw danych, który został odświeżony co najmniej raz lub dla którego istnieje prawidłowy harmonogram odświeżania. |
QnaEmbedURL |
string |
Zestaw danych Q&adres URL osadzania |
addRowsAPIEnabled |
boolean |
Czy zestaw danych umożliwia dodawanie nowych wierszy |
configuredBy |
string |
Właściciel zestawu danych |
description |
string |
Opis zestawu danych |
id |
string |
Identyfikator zestawu danych |
name |
string |
Nazwa zestawu danych |
queryScaleOutSettings |
Wykonywanie zapytań dotyczących ustawień skalowania w poziomie zestawu danych |
|
targetStorageMode |
string |
Tryb przechowywania zestawu danych |
upstreamDataflows |
Lista wszystkich przepływów danych, od których zależy ten element |
|
users |
(Pusta wartość) Szczegóły dostępu użytkownika zestawu danych. Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o użytkowniku w elemencie usługi Power BI (takim jak raport lub pulpit nawigacyjny) można pobrać przy użyciu interfejsu API pobierz zestaw danych jako interfejsu API Administracja lub interfejsu API PostWorkspaceInfo z parametrem |
|
webUrl |
string |
Internetowy adres URL zestawu danych |
DatasetQueryScaleOutSettings
Wykonywanie zapytań dotyczących ustawień skalowania w poziomie zestawu danych
Nazwa | Typ | Opis |
---|---|---|
autoSyncReadOnlyReplicas |
boolean |
Czy zestaw danych automatycznie synchronizuje repliki tylko do odczytu |
maxReadOnlyReplicas |
integer |
Maksymalna liczba replik tylko do odczytu dla zestawu danych (0–64, -1 dla automatycznej liczby replik) |
DatasetUser
Wpis prawa dostępu użytkownika usługi Power BI dla zestawu danych
Nazwa | Typ | Opis |
---|---|---|
datasetUserAccessRight |
Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień) |
|
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 administratora. |
identifier |
string |
Identyfikator podmiotu zabezpieczeń |
principalType |
Typ podmiotu zabezpieczeń |
|
profile |
Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami. |
|
userType |
string |
Typ użytkownika. |
DatasetUserAccessRight
Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień)
Nazwa | Typ | Opis |
---|---|---|
None |
string |
Usuwa uprawnienia do zawartości w zestawie danych |
Read |
string |
Przyznaje dostęp do odczytu do zawartości w zestawie danych |
ReadExplore |
string |
Przyznaje uprawnienia do odczytu i eksplorowania dostępu do zawartości w zestawie danych |
ReadReshare |
string |
Przyznaje dostęp do odczytu i udostępniania dalej do zawartości w zestawie danych |
ReadReshareExplore |
string |
Przyznaje uprawnienia do odczytu, udostępniania dalej i eksplorowania dostępu do zawartości w zestawie danych |
ReadWrite |
string |
Przyznaje dostęp do odczytu i zapisu do zawartości w zestawie danych |
ReadWriteExplore |
string |
Przyznaje dostęp do zawartości w zestawie danych: odczyt, zapis i eksplorowanie |
ReadWriteReshare |
string |
Udziela dostępu do odczytu, zapisu i udostępniania dalej zawartości w zestawie danych |
ReadWriteReshareExplore |
string |
Przyznaje dostęp do zawartości w zestawie danych: odczyt, zapis, udostępnianie dalej i eksplorowanie |
DependentDataflow
Zależny od przepływu danych usługi Power BI
Nazwa | Typ | Opis |
---|---|---|
groupId |
string |
Identyfikator grupy docelowej |
targetDataflowId |
string |
Identyfikator docelowego przepływu danych |
Encryption
Informacje o szyfrowaniu zestawu danych
Nazwa | Typ | Opis |
---|---|---|
EncryptionStatus |
Stan szyfrowania zestawu danych |
EncryptionStatus
Stan szyfrowania zestawu danych
Nazwa | Typ | Opis |
---|---|---|
InSyncWithWorkspace |
string |
Szyfrowanie jest obsługiwane i jest synchronizowane z ustawieniami szyfrowania |
NotInSyncWithWorkspace |
string |
Szyfrowanie jest obsługiwane, ale nie jest zsynchronizowane z ustawieniami szyfrowania |
NotSupported |
string |
Szyfrowanie nie jest obsługiwane w przypadku tego zestawu danych |
Unknown |
string |
Stan szyfrowania jest nieznany z powodu uszkodzenia zestawu danych |
Import
Obiekt importu
Nazwa | Typ | Opis |
---|---|---|
createdDateTime |
string |
Data i godzina utworzenia importu |
datasets |
Dataset[] |
Zestawy danych skojarzone z tym importem |
id |
string |
Identyfikator importu |
importState |
enum:
|
Stan przekazywania importu |
name |
string |
Nazwa importu |
reports |
Report[] |
Raporty skojarzone z tym importem |
updatedDateTime |
string |
Importowanie daty i godziny ostatniej aktualizacji |
PrincipalType
Typ podmiotu zabezpieczeń
Nazwa | Typ | Opis |
---|---|---|
App |
string |
Typ jednostki usługi |
Group |
string |
Typ podmiotu zabezpieczeń grupy |
None |
string |
Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji. |
User |
string |
Typ podmiotu zabezpieczeń użytkownika |
Report
Raport usługi Power BI. Interfejs API zwraca podzbiór następujących właściwości raportu. Podzbiór 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 |
datasetId |
string |
Identyfikator zestawu danych raportu |
description |
string |
Opis raportu |
embedUrl |
string |
Adres URL osadzania raportu |
id |
string |
Identyfikator raportu |
isOwnedByMe |
boolean |
Ustal, czy raport jest tworzony przez bieżącego użytkownika. |
name |
string |
Nazwa raportu |
originalReportId |
string |
Rzeczywisty identyfikator raportu po opublikowaniu obszaru roboczego jako aplikacja. |
reportType |
enum:
|
Typ raportu |
subscriptions |
(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 dla raportu usługi Power BI można pobrać przy użyciu wywołania interfejsu API pobierania raportów jako Administracja. |
|
users |
(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 pobierania raportów jako Administracja lub wywołania interfejsu API PostWorkspaceInfo z parametrem |
|
webUrl |
string |
Internetowy adres URL raportu |
ReportUser
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 administratora. |
identifier |
string |
Identyfikator podmiotu zabezpieczeń |
principalType |
Typ podmiotu zabezpieczeń |
|
profile |
Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami. |
|
reportUserAccessRight |
Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień) |
|
userType |
string |
Typ użytkownika. |
ReportUserAccessRight
Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)
Nazwa | Typ | Opis |
---|---|---|
None |
string |
Brak uprawnień do zawartości w raporcie |
Owner |
string |
Przyznaje prawa dostępu do odczytu, zapisu i udostępniania dalej do zawartości w raporcie |
Read |
string |
Przyznaje dostęp do odczytu do zawartości w raporcie |
ReadCopy |
string |
Przyznaje dostęp do odczytu i kopiowania do zawartości w raporcie |
ReadReshare |
string |
Udziela dostępu do odczytu i udostępniania dalej zawartości w raporcie |
ReadWrite |
string |
Przyznaje dostęp do odczytu i zapisu do zawartości w raporcie |
ServicePrincipalProfile
Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
Nazwa | Typ | Opis |
---|---|---|
displayName |
string |
Nazwa profilu jednostki usługi |
id |
string |
Identyfikator profilu jednostki usługi |
Subscription
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 |
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 |
attachmentFormat |
string |
Format raportu dołączonego do subskrypcji poczty e-mail |
endDate |
string |
Data i godzina zakończenia subskrypcji e-mail |
frequency |
string |
Częstotliwość subskrypcji poczty e-mail |
id |
string |
Identyfikator subskrypcji |
isEnabled |
boolean |
Czy subskrypcja poczty e-mail jest włączona |
linkToContent |
boolean |
Czy link subskrypcji istnieje w subskrypcji e-mail |
previewImage |
boolean |
Czy na zrzucie ekranu raportu istnieje subskrypcja poczty e-mail |
startDate |
string |
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 |
Szczegóły każdego subskrybenta poczty e-mail. W przypadku używania wywołania interfejsu API Pobierz subskrypcje użytkowników jako Administracja 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 opcji Pobierz subskrypcje raportów jako Administracja lub Pobierz subskrypcje pulpitu nawigacyjnego jako wywołania interfejsu API Administracja. |
SubscriptionUser
Użytkownik subskrypcji 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 administratora. |
identifier |
string |
Identyfikator podmiotu zabezpieczeń |
principalType |
Typ podmiotu zabezpieczeń |
|
profile |
Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami. |
|
userType |
string |
Typ użytkownika. |