Udostępnij za pośrednictwem


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
groupId
path True

string

uuid

Identyfikator obszaru roboczego

importId
path True

string

uuid

Identyfikator importu

Odpowiedzi

Nazwa Typ Opis
200 OK

Import

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.

DatasetQueryScaleOutSettings

Wykonywanie zapytań dotyczących ustawień skalowania w poziomie zestawu danych

DatasetUser

Wpis prawa dostępu użytkownika usługi Power BI dla zestawu danych

DatasetUserAccessRight

Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień)

DependentDataflow

Zależny od przepływu danych usługi Power BI

Encryption

Informacje o szyfrowaniu zestawu danych

EncryptionStatus

Stan szyfrowania zestawu danych

Import

Obiekt importu

PrincipalType

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.

ReportUser

Wpis prawa dostępu użytkownika usługi Power BI dla raportu

ReportUserAccessRight

Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)

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 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

Encryption

Informacje o szyfrowaniu zestawu danych. Ma zastosowanie tylko wtedy, gdy $expand jest określony.

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

DatasetQueryScaleOutSettings

Wykonywanie zapytań dotyczących ustawień skalowania w poziomie zestawu danych

targetStorageMode

string

Tryb przechowywania zestawu danych

upstreamDataflows

DependentDataflow[]

Lista wszystkich przepływów danych, od których zależy ten element

users

DatasetUser[]

(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 getArtifactUsers .

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

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

PrincipalType

Typ podmiotu zabezpieczeń

profile

ServicePrincipalProfile

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

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:
  • Failed
  • Publishing
  • Succeeded

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:
  • PaginatedReport
  • PowerBIReport

Typ raportu

subscriptions

Subscription[]

(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

ReportUser[]

(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 getArtifactUsers .

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

PrincipalType

Typ podmiotu zabezpieczeń

profile

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

reportUserAccessRight

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 Report, Dashboardlub Dataset)

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

SubscriptionUser[]

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

PrincipalType

Typ podmiotu zabezpieczeń

profile

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

userType

string

Typ użytkownika.