Imports - Post Import In Group

  • Reference
Service:
Power BI REST APIs
API Version:
v1.0

Vytvoří nový obsah v zadaném pracovním prostoru.

Poznámka

Podporovaný obsah:

  • Soubory .pbix v Power BI
  • Soubory JSON (.json)
  • Excelové soubory (.xlsx)
  • SQL Server soubory jazyka definice sestav (.rdl)
  • Chcete-li importovat soubor, zadejte typ obsahu multipart/form-data v hlavičce požadavku a zakódujte soubor jako data formuláře v textu požadavku.
  • Chcete-li importovat soubor .rdl, zahrňte příponu souboru do názvu zadaného nástrojem datasetDisplayName, jak je popsáno v parametrech identifikátoru URI.
  • Pokud chcete importovat soubor .xlsx z OneDrive pro firmy, zahrňte do hlaviček požadavku typ obsahu application/json. Zahrňte ImportInfo s nastaveným filePath na cestu k souboru .xlsx v textu požadavku.
  • Pokud chcete importovat velké soubory Power BI .pbix o velikosti od 1 GB do 10 GB, přečtěte si článek Vytvoření dočasného umístění pro nahrávání ve skupině a skript PowerShellu pro import velkých souborů . To se podporuje jenom u pracovních prostorů kapacity Premium.
  • Pokud chcete vytvořit tok dat ze souboru model.json, nastavte datasetDisplayName na model.json, jak je popsáno v parametrech identifikátoru URI.

Oprávnění

Toto volání rozhraní API lze volat pomocí profilu instančního objektu. Další informace najdete v tématu Profily instančního objektu v Power BI Embedded.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

  • Toky dat s instančním objektem se nepodporují.
  • Import souboru .pbix Power BI z OneDrivu se nepodporuje.
  • Instanční objekty nepodporují import souboru s chráněným popiskem citlivosti. 

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/imports?datasetDisplayName={datasetDisplayName}
With optional parameters: 
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/imports?datasetDisplayName={datasetDisplayName}&nameConflict={nameConflict}&skipReport={skipReport}&overrideReportLabel={overrideReportLabel}&overrideModelLabel={overrideModelLabel}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
groupId
 path True

string

uuid

ID pracovního prostoru
datasetDisplayName
 query True

string

Zobrazovaný název datové sady by měl obsahovat příponu souboru. Nepodporuje se při importu z OneDrive pro firmy. Pro import nebo vytváření toků dat by měl být tento parametr pevně zakódován tak, aby model.json.
nameConflict
 query

ImportConflictHandlerMode

Určuje, co dělat, pokud už datová sada se stejným názvem existuje. Výchozí hodnota je Ignore. Pro soubory Abort RDL a Overwrite jsou jedinými podporovanými možnostmi. Pro tok dat model.json soubory Abort a GenerateUniqueName jsou jedinými podporovanými možnostmi.
overrideModelLabel
 query

boolean

Určuje, jestli se má při opětovném publikování souboru .pbix Power BI přepsat existující popisek v modelu. Výchozí hodnota služby je true.
overrideReportLabel
 query

boolean

Jestli se má při opětovném publikování souboru Power BI .pbix přepsat existující popisek sestavy. Výchozí hodnota služby je true.
skipReport
 query

boolean

Jestli se má přeskočit import sestav. Pokud je zadaný, musí být truehodnota . Podporuje se jenom pro soubory .pbix Power BI.

Text požadavku

Media Types: "application/json", "multipart/form-data"

Name Typ Description
connectionType

connectionType

Typ připojení importu pro soubor OneDrive pro firmy
filePath

string

Cesta k souboru OneDrive pro firmy Excelu (.xlsx) k importu, která může být absolutní nebo relativní. Soubory .pbix Power BI se nepodporují.
fileUrl

string

Adresa URL sdíleného přístupového podpisu dočasného úložiště objektů blob použitého k importu velkých souborů Power BI .pbix o velikosti 1 GB až 10 GB

Odpovědi

Name Typ Description
200 OK

Import

OK
202 Accepted

Import

Přijato

Příklady

Import dataflow model.json example
Post import example
Post import skip report example

Import dataflow model.json example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=model.json&nameConflict=Abort&skipReport=True
Request Body
{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data name=model.json; filename=model.json Content-Type: application/json [Contents of Model JSON Encoded] --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

Sample Response

Status code:
202 
{
  "id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}

Post import example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=MyReport&nameConflict=Ignore
Request Body
{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

Sample Response

Status code:
202 
{
  "id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}

Post import skip report example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=MyReport&nameConflict=Ignore&skipReport=True&overrideReportLabel=True&overrideModelLabel=True
Request Body
{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

Sample Response

Status code:
202 
{
  "id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}

Definice

Name Description
connectionType

Typ připojení importu pro soubor OneDrive pro firmy
Dataset

Datová sada Power BI. Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností datové sady. Podmnožina závisí na volaným rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.
DatasetQueryScaleOutSettings

Dotaz na nastavení škálování datové sady na více instancí
DatasetUser

Položka přístupového práva uživatele Power BI pro datovou sadu
DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)
DependentDataflow

Tok dat závislý na Power BI
Encryption

Informace o šifrování datové sady
EncryptionStatus

Stav šifrování datové sady
Import

Objekt importu
ImportConflictHandlerMode

Určuje, co dělat, pokud už datová sada se stejným názvem existuje. Výchozí hodnota je Ignore. Pro soubory Abort RDL a Overwrite jsou jedinými podporovanými možnostmi. Pro tok dat model.json soubory Abort a GenerateUniqueName jsou jedinými podporovanými možnostmi.
ImportInfo

Informace o importu
PrincipalType

Typ objektu zabezpečení
Report

Sestava Power BI. Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností sestavy. Podmnožina závisí na volaného rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.
ReportUser

Položka přístupového práva uživatele Power BI pro sestavu
ReportUserAccessRight

Přístupové právo, které má uživatel k sestavě (úroveň oprávnění)
ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
Subscription

Odběr e-mailu pro položku Power BI (například sestavu nebo řídicí panel)
SubscriptionUser

Uživatel e-mailového předplatného Power BI

connectionType

Typ připojení importu pro soubor OneDrive pro firmy

Name Typ Description
connect

string

import

string

Dataset

Datová sada Power BI. Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností datové sady. Podmnožina závisí na volaným rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

Name Typ Description
ContentProviderType

string

Typ zprostředkovatele obsahu pro datovou sadu
CreateReportEmbedURL

string

Adresa URL pro vložení sestavy pro vytvoření datové sady
CreatedDate

string

Datum a čas vytvoření datové sady
Encryption

Encryption

Informace o šifrování datové sady. Platí pouze v případě, že $expand je zadáno.
IsEffectiveIdentityRequired

boolean

Jestli datová sada vyžaduje efektivní identitu, kterou musíte odeslat ve volání rozhraní API GenerateToken .
IsEffectiveIdentityRolesRequired

boolean

Určuje, jestli je v souboru .pbix Power BI definované zabezpečení na úrovni řádků. Pokud ano, musíte zadat roli.
IsInPlaceSharingEnabled

boolean

Jestli je možné datovou sadu sdílet s externími uživateli, aby ji mohli využívat ve svém vlastním tenantovi.
IsOnPremGatewayRequired

boolean

Jestli datová sada vyžaduje místní bránu dat
IsRefreshable

boolean

Jestli je datová sada aktualizovatelná nebo ne. Aktualizovatelná datová sada Power BI je datová sada, která se alespoň jednou aktualizovala nebo pro kterou existuje platný plán aktualizace.
QnaEmbedURL

string

Adresa URL pro vložení Q&A datové sady
addRowsAPIEnabled

boolean

Jestli datová sada umožňuje přidávat nové řádky
configuredBy

string

Vlastník datové sady
description

string

Popis datové sady
id

string

ID datové sady
name

string

Název datové sady
queryScaleOutSettings

DatasetQueryScaleOutSettings

Dotaz na nastavení škálování datové sady na více instancí
targetStorageMode

string

Režim úložiště datové sady
upstreamDataflows

DependentDataflow[]

Seznam všech toků dat, na které tato položka závisí
users

DatasetUser[]

(Prázdná hodnota) Podrobnosti o přístupu uživatele k datové sadě Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o uživatelích u položky Power BI (například sestavy nebo řídicího panelu) můžete načíst pomocí rozhraní API Get Dataset Users as Správa nebo rozhraní API PostWorkspaceInfo s parametrem getArtifactUsers .
webUrl

string

Webová adresa URL datové sady

DatasetQueryScaleOutSettings

Dotaz na nastavení škálování datové sady na více instancí

Name Typ Description
autoSyncReadOnlyReplicas

boolean

Jestli datová sada automaticky synchronizuje repliky jen pro čtení
maxReadOnlyReplicas

integer

Maximální počet replik jen pro čtení pro datovou sadu (0–64, -1 pro automatický počet replik)

DatasetUser

Položka přístupového práva uživatele Power BI pro datovou sadu

Name Typ Description
datasetUserAccessRight

DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)
displayName

string

Zobrazovaný název objektu zabezpečení
emailAddress

string

E-mailová adresa uživatele
graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.
identifier

string

Identifikátor objektu zabezpečení
principalType

PrincipalType

Typ objektu zabezpečení
profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
userType

string

Typ uživatele.

DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)

Name Typ Description
None

string

Odebere oprávnění k obsahu v datové sadě.
Read

string

Udělí oprávnění ke čtení obsahu v datové sadě.
ReadExplore

string

Udělí přístup ke čtení a prozkoumání obsahu v datové sadě.
ReadReshare

string

Uděluje přístup ke čtení a sdílení obsahu v datové sadě.
ReadReshareExplore

string

Uděluje přístup ke čtení, sdílení a prozkoumání obsahu v datové sadě.
ReadWrite

string

Uděluje přístup ke čtení a zápisu k obsahu v datové sadě.
ReadWriteExplore

string

Uděluje přístup ke čtení, zápisu a prozkoumání obsahu v datové sadě.
ReadWriteReshare

string

Uděluje přístup ke čtení, zápisu a sdílení obsahu v datové sadě.
ReadWriteReshareExplore

string

Uděluje přístup ke čtení, zápisu, sdílení a prozkoumání obsahu v datové sadě.

DependentDataflow

Tok dat závislý na Power BI

Name Typ Description
groupId

string

ID cílové skupiny
targetDataflowId

string

ID cílového toku dat

Encryption

Informace o šifrování datové sady

Name Typ Description
EncryptionStatus

EncryptionStatus

Stav šifrování datové sady

EncryptionStatus

Stav šifrování datové sady

Name Typ Description
InSyncWithWorkspace

string

Šifrování se podporuje a synchronizuje se s nastavením šifrování.
NotInSyncWithWorkspace

string

Šifrování se podporuje, ale není synchronizované s nastavením šifrování.
NotSupported

string

U této datové sady se nepodporuje šifrování.
Unknown

string

Stav šifrování je neznámý kvůli poškození datové sady.

Import

Objekt importu

Name Typ Description
createdDateTime

string

Datum a čas vytvoření importu
datasets

Dataset[]

Datové sady přidružené k tomuto importu
id

string

ID importu
importState enum:
  • Failed
  • Publishing
  • Succeeded

Stav nahrání importu
name

string

Název importu
reports

Report[]

Sestavy přidružené k tomuto importu
updatedDateTime

string

Importovat datum a čas poslední aktualizace

ImportConflictHandlerMode

Určuje, co dělat, pokud už datová sada se stejným názvem existuje. Výchozí hodnota je Ignore. Pro soubory Abort RDL a Overwrite jsou jedinými podporovanými možnostmi. Pro tok dat model.json soubory Abort a GenerateUniqueName jsou jedinými podporovanými možnostmi.

Name Typ Description
Abort

string

Pokud datová sada nebo tok dat se stejným názvem již existuje, operace importu se zruší.
CreateOrOverwrite

string

Pokud už datová sada se stejným názvem existuje, operace importu nahradí stávající datovou sadu novou. Operace importu selže, pokud existuje více než jedna datová sada se stejným názvem.
GenerateUniqueName

string

Pokud už tok dat se stejným názvem existuje, operace importu vygeneruje nový jedinečný název nového toku dat.
Ignore

string

Pokud už datová sada se stejným názvem existuje, operace importu vytvoří novou datovou sadu se stejným názvem.
Overwrite

string

Pokud už datová sada se stejným názvem existuje, operace importu nahradí stávající datovou sadu novou. Operace importu selže, pokud neexistuje žádný konflikt nebo pokud existuje více než jedna datová sada se stejným názvem.

ImportInfo

Informace o importu

Name Typ Description
connectionType

connectionType

Typ připojení importu pro soubor OneDrive pro firmy
filePath

string

Cesta k souboru OneDrive pro firmy Excelu (.xlsx) k importu, která může být absolutní nebo relativní. Soubory .pbix Power BI se nepodporují.
fileUrl

string

Adresa URL sdíleného přístupového podpisu dočasného úložiště objektů blob použitého k importu velkých souborů Power BI .pbix o velikosti 1 GB až 10 GB

PrincipalType

Typ objektu zabezpečení

Name Typ Description
App

string

Typ instančního objektu
Group

string

Typ objektu zabezpečení skupiny
None

string

Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.
User

string

Typ objektu zabezpečení uživatele

Report

Sestava Power BI. Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností sestavy. Podmnožina závisí na volaného rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

Name Typ Description
appId

string

ID aplikace, které se vrátí jenom v případě, že sestava patří aplikaci
datasetId

string

ID datové sady sestavy
description

string

Popis sestavy
embedUrl

string

Adresa URL pro vložení sestavy
id

string

ID sestavy
name

string

Název sestavy
originalReportId

string

Skutečné ID sestavy při publikování pracovního prostoru jako aplikace
reportType enum:
  • PaginatedReport
  • PowerBIReport

Typ sestavy
subscriptions

Subscription[]

(Prázdná hodnota) Podrobnosti o předplatném pro položku Power BI (například sestavu nebo řídicí panel). Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o předplatném pro sestavu Power BI můžete načíst pomocí volání Získat odběry sestav jako Správa rozhraní API.
users

ReportUser[]

(Prázdná hodnota) Podrobnosti o přístupu uživatele k sestavě Power BI Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o uživatelích v sestavě Power BI můžete načíst pomocí volání Rozhraní API Get Report Users as Správa nebo pomocí volání rozhraní API PostWorkspaceInfo s parametremgetArtifactUsers.
webUrl

string

Webová adresa URL sestavy

ReportUser

Položka přístupového práva uživatele Power BI pro sestavu

Name Typ Description
displayName

string

Zobrazovaný název objektu zabezpečení
emailAddress

string

E-mailová adresa uživatele
graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.
identifier

string

Identifikátor objektu zabezpečení
principalType

PrincipalType

Typ objektu zabezpečení
profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
reportUserAccessRight

ReportUserAccessRight

Přístupové právo, které má uživatel k sestavě (úroveň oprávnění)
userType

string

Typ uživatele.

ReportUserAccessRight

Přístupové právo, které má uživatel k sestavě (úroveň oprávnění)

Name Typ Description
None

string

Žádná oprávnění k obsahu v sestavě
Owner

string

Uděluje přístup ke čtení, zápisu a sdílení obsahu v sestavě.
Read

string

Uděluje oprávnění ke čtení obsahu v sestavě.
ReadCopy

string

Uděluje přístup ke čtení a kopírování obsahu v sestavě.
ReadReshare

string

Uděluje přístup ke čtení a opětovnému sdílení obsahu v sestavě.
ReadWrite

string

Uděluje přístup ke čtení a zápisu k obsahu v sestavě.

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

Name Typ Description
displayName

string

Název profilu instančního objektu
id

string

ID profilu instančního objektu

Subscription

Odběr e-mailu pro položku Power BI (například sestavu nebo řídicí panel)

Name Typ Description
artifactDisplayName

string

Název odebírané položky Power BI (například sestavy nebo řídicího panelu)
artifactId

string

ID odebírané položky Power BI (například sestavy nebo řídicího panelu)
artifactType

string

Typ položky Power BI (například Report, Dashboardnebo Dataset)
attachmentFormat

string

Formát sestavy připojené k odběru e-mailu
endDate

string

Koncové datum a čas odběru e-mailu
frequency

string

Frekvence odběru e-mailu
id

string

ID předplatného
isEnabled

boolean

Jestli je povolené předplatné e-mailu
linkToContent

boolean

Jestli v e-mailovém předplatném existuje odkaz na předplatné
previewImage

boolean

Jestli v odběru e-mailu existuje snímek obrazovky se sestavou
startDate

string

Počáteční datum a čas odběru e-mailu
subArtifactDisplayName

string

Název stránky odebírané položky Power BI, pokud se jedná o sestavu.
title

string

Název aplikace
users

SubscriptionUser[]

Podrobnosti o každém odběrateli e-mailu. Při použití volání rozhraní API Get User Subscriptions As Správa je vrácená hodnota prázdné pole (null). Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o předplatném sestavy nebo řídicího panelu Power BI můžete načíst pomocí volání rozhraní API Získat odběry sestav jako Správa nebo Získat odběry řídicích panelů jako Správa.

SubscriptionUser

Uživatel e-mailového předplatného Power BI

Name Typ Description
displayName

string

Zobrazovaný název objektu zabezpečení
emailAddress

string

E-mailová adresa uživatele
graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.
identifier

string

Identifikátor objektu zabezpečení
principalType

PrincipalType

Typ objektu zabezpečení
profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
userType

string

Typ uživatele.