Imports - Post Import In Group
Crea nuovo contenuto nell'area di lavoro specificata.
Nota
Contenuto supportato:
- File con estensione pbix di Power BI
- File JSON (.json)
- File di Excel (con estensione xlsx)
- SQL Server file del linguaggio di definizione del report (con estensione rdl)
- Per importare un file, specificare il tipo di contenuto multipart/form-data nelle intestazioni della richiesta e codificare il file come dati del modulo nel corpo della richiesta.
- Per importare un file con estensione rdl, includere l'estensione del file nel nome specificato da
datasetDisplayName
, come descritto nei parametri URI. - Per importare un file .xlsx da OneDrive for Business, includere il tipo di contenuto application/json nelle intestazioni della richiesta. Includere ImportInfo con
filePath
impostato sul percorso del file .xlsx nel corpo della richiesta. - Per importare file con estensione pbix di Power BI di grandi dimensioni compresi tra 1 GB e 10 GB, vedere Creare percorso di caricamento temporaneo in gruppo e lo script Import Large Files PowerShell. Questa funzionalità è supportata solo per le aree di lavoro di capacità Premium.
- Per creare un flusso di dati da un file di model.json, impostare
datasetDisplayName
su model.json, come descritto nei parametri URI.
Autorizzazioni
Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: Profili dell'entità servizio in Power BI Embedded.
Ambito obbligatorio
Dataset.ReadWrite.All
Limitazioni
- I flussi di dati con l'entità servizio non sono supportati.
- L'importazione di un file con estensione pbix di Power BI da OneDrive non è supportata.
- L'importazione di un file con un'etichetta di riservatezza protetta non è supportata per le entità servizio.
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/imports?datasetDisplayName={datasetDisplayName}
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/imports?datasetDisplayName={datasetDisplayName}&nameConflict={nameConflict}&skipReport={skipReport}&overrideReportLabel={overrideReportLabel}&overrideModelLabel={overrideModelLabel}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
group
|
path | True |
string uuid |
ID area di lavoro |
dataset
|
query | True |
string |
Il nome visualizzato del set di dati deve includere l'estensione del file. Non supportato durante l'importazione da OneDrive for Business. Per l'importazione o la creazione di flussi di dati, questo parametro deve essere hardcoded per model.json. |
name
|
query |
Specifica cosa fare se esiste già un set di dati con lo stesso nome. Il valore predefinito è |
||
override
|
query |
boolean |
Determina se eseguire l'override dell'etichetta esistente in un modello durante la ripubblicazione di un file con estensione pbix di Power BI. Il valore predefinito del servizio è |
|
override
|
query |
boolean |
Se eseguire l'override dell'etichetta esistente in un report durante la ripubblicazione di un file con estensione pbix di Power BI. Il valore predefinito del servizio è |
|
skip
|
query |
boolean |
Indica se ignorare l'importazione del report. Se specificato, il valore deve essere |
Corpo della richiesta
Media Types: "application/json", "multipart/form-data"
Nome | Tipo | Descrizione |
---|---|---|
connectionType |
Tipo di connessione di importazione per un file di OneDrive for Business |
|
filePath |
string |
Percorso del file OneDrive for Business Excel (.xlsx) da importare, che può essere assoluto o relativo. I file con estensione pbix di Power BI non sono supportati. |
fileUrl |
string |
URL della firma di accesso condiviso dell'archiviazione BLOB temporanea usata per importare file con estensione pbix di Power BI di grandi dimensioni tra 1 GB e 10 GB. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Accettato |
Esempio
Import dataflow model. |
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
{
"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
{
"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
{
"value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}
Sample Response
{
"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
{
"value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}
Sample Response
{
"id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}
Definizioni
Nome | Descrizione |
---|---|
connection |
Tipo di connessione di importazione per un file di OneDrive for Business |
Dataset |
Set di dati di Power BI. L'API restituisce un subset dell'elenco seguente di proprietà del set di dati. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI. |
Dataset |
Eseguire query su impostazioni di scalabilità orizzontale di un set di dati |
Dataset |
Voce a destra dell'accesso utente di Power BI per un set di dati |
Dataset |
Diritto di accesso che l'utente ha per il set di dati (livello di autorizzazione) |
Dependent |
Flusso di dati dipendente da Power BI |
Encryption |
Informazioni di crittografia per un set di dati |
Encryption |
Stato della crittografia dei set di dati |
Import |
Oggetto import |
Import |
Specifica cosa fare se esiste già un set di dati con lo stesso nome. Il valore predefinito è |
Import |
Informazioni sull'importazione |
Principal |
Tipo principale |
Report |
Report di Power BI. L'API restituisce un subset dell'elenco seguente di proprietà del report. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI. |
Report |
Voce a destra dell'accesso utente di Power BI per un report |
Report |
Diritto di accesso che l'utente ha per il report (livello di autorizzazione) |
Service |
Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy. |
Subscription |
Sottoscrizione di posta elettronica per un elemento di Power BI (ad esempio un report o un dashboard) |
Subscription |
Utente della sottoscrizione di posta elettronica di Power BI |
connectionType
Tipo di connessione di importazione per un file di OneDrive for Business
Nome | Tipo | Descrizione |
---|---|---|
connect |
string |
|
import |
string |
Dataset
Set di dati di Power BI. L'API restituisce un subset dell'elenco seguente di proprietà del set di dati. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.
Nome | Tipo | Descrizione |
---|---|---|
ContentProviderType |
string |
Tipo di provider di contenuto per il set di dati |
CreateReportEmbedURL |
string |
URL di incorporamento del report per il set di dati |
CreatedDate |
string |
Data e ora di creazione del set di dati |
Encryption |
Informazioni sulla crittografia dei set di dati. Applicabile solo quando |
|
IsEffectiveIdentityRequired |
boolean |
Se il set di dati richiede un'identità efficace, che è necessario inviare in una chiamata API GenerateToken . |
IsEffectiveIdentityRolesRequired |
boolean |
Se la sicurezza a livello di riga è definita all'interno del file pbix di Power BI. In tal caso, è necessario specificare un ruolo. |
IsInPlaceSharingEnabled |
boolean |
Se il set di dati può essere condiviso con utenti esterni da usare nel proprio tenant |
IsOnPremGatewayRequired |
boolean |
Se il set di dati richiede un gateway dati locale |
IsRefreshable |
boolean |
Se il set di dati è aggiornabile o meno. Un set di dati aggiornabile di Power BI è un set di dati aggiornato almeno una volta o per il quale esiste una pianificazione di aggiornamento valida. |
QnaEmbedURL |
string |
Il set di dati Q&UN URL di incorporamento |
addRowsAPIEnabled |
boolean |
Indica se il set di dati consente l'aggiunta di nuove righe |
configuredBy |
string |
Proprietario del set di dati |
description |
string |
Descrizione del set di dati |
id |
string |
ID del set di dati |
name |
string |
Nome del set di dati |
queryScaleOutSettings |
Eseguire query su impostazioni di scalabilità orizzontale di un set di dati |
|
targetStorageMode |
string |
Modalità di archiviazione del set di dati |
upstreamDataflows |
L'elenco di tutti i flussi di dati dipende da |
|
users |
(Valore vuoto) Dettagli di accesso utente del set di dati. Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare informazioni utente su un elemento di Power BI (ad esempio un report o un dashboard) usando l'API Get Dataset Users come API Amministrazione o l'API PostWorkspaceInfo con il |
|
webUrl |
string |
URL Web del set di dati |
DatasetQueryScaleOutSettings
Eseguire query su impostazioni di scalabilità orizzontale di un set di dati
Nome | Tipo | Descrizione |
---|---|---|
autoSyncReadOnlyReplicas |
boolean |
Se il set di dati sincronizza automaticamente le repliche di sola lettura |
maxReadOnlyReplicas |
integer |
Numero massimo di repliche di sola lettura per il set di dati (0-64, -1 per il numero automatico di repliche) |
DatasetUser
Voce a destra dell'accesso utente di Power BI per un set di dati
Nome | Tipo | Descrizione |
---|---|---|
datasetUserAccessRight |
Diritto di accesso che l'utente ha per il set di dati (livello di autorizzazione) |
|
displayName |
string |
Nome visualizzato dell'entità |
emailAddress |
string |
Indirizzo di posta elettronica dell'utente |
graphId |
string |
Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione. |
identifier |
string |
Identificatore dell'entità |
principalType |
Tipo principale |
|
profile |
Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy. |
|
userType |
string |
Tipo dell'utente. |
DatasetUserAccessRight
Diritto di accesso che l'utente ha per il set di dati (livello di autorizzazione)
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
Rimuove l'autorizzazione per il contenuto nel set di dati |
Read |
string |
Concede l'accesso in lettura al contenuto nel set di dati |
ReadExplore |
string |
Concede l'accesso in lettura ed esplora al contenuto nel set di dati |
ReadReshare |
string |
Concede l'accesso in lettura e rishare al contenuto nel set di dati |
ReadReshareExplore |
string |
Concede lettura, ricondividi e Esplora l'accesso al contenuto nel set di dati |
ReadWrite |
string |
Concede l'accesso in lettura e scrittura al contenuto nel set di dati |
ReadWriteExplore |
string |
Concede l'accesso in lettura, scrittura ed esplora al contenuto nel set di dati |
ReadWriteReshare |
string |
Concede l'accesso in lettura, scrittura e ricondividi al contenuto nel set di dati |
ReadWriteReshareExplore |
string |
Concede lettura, scrittura, ricondividi e esplora l'accesso al contenuto nel set di dati |
DependentDataflow
Flusso di dati dipendente da Power BI
Nome | Tipo | Descrizione |
---|---|---|
groupId |
string |
ID gruppo di destinazione |
targetDataflowId |
string |
ID flusso di dati di destinazione |
Encryption
Informazioni di crittografia per un set di dati
Nome | Tipo | Descrizione |
---|---|---|
EncryptionStatus |
Stato della crittografia dei set di dati |
EncryptionStatus
Stato della crittografia dei set di dati
Nome | Tipo | Descrizione |
---|---|---|
InSyncWithWorkspace |
string |
La crittografia è supportata ed è sincronizzata con le impostazioni di crittografia |
NotInSyncWithWorkspace |
string |
La crittografia è supportata ma non è sincronizzata con le impostazioni di crittografia |
NotSupported |
string |
La crittografia non è supportata per questo set di dati |
Unknown |
string |
Lo stato della crittografia è sconosciuto a causa del danneggiamento del set di dati |
Import
Oggetto import
Nome | Tipo | Descrizione |
---|---|---|
createdDateTime |
string |
Importare data e ora di creazione |
datasets |
Dataset[] |
Set di dati associati a questa importazione |
id |
string |
ID di importazione |
importState |
enum:
|
Stato di caricamento dell'importazione |
name |
string |
Nome di importazione |
reports |
Report[] |
I report associati a questa importazione |
updatedDateTime |
string |
Importare la data e l'ora dell'ultimo aggiornamento |
ImportConflictHandlerMode
Specifica cosa fare se esiste già un set di dati con lo stesso nome. Il valore predefinito è Ignore
. Per i file Abort
RDL e Overwrite
sono le uniche opzioni supportate. Per i file Abort
di flusso di dati model.json e GenerateUniqueName
sono le uniche opzioni supportate.
Nome | Tipo | Descrizione |
---|---|---|
Abort |
string |
Se il set di dati o il flusso di dati con lo stesso nome esiste già, l'operazione di importazione verrà annullata. |
CreateOrOverwrite |
string |
Se esiste già un set di dati con lo stesso nome, l'operazione di importazione sostituirà il set di dati esistente con quello nuovo. L'operazione di importazione avrà esito negativo se è presente più di un set di dati esistente con lo stesso nome. |
GenerateUniqueName |
string |
Se esiste già un flusso di dati con lo stesso nome, l'operazione di importazione genererà un nuovo nome univoco per il nuovo flusso di dati. |
Ignore |
string |
Se esiste già un set di dati con lo stesso nome, l'operazione di importazione creerà un nuovo set di dati con lo stesso nome. |
Overwrite |
string |
Se esiste già un set di dati con lo stesso nome, l'operazione di importazione sostituirà il set di dati esistente con quello nuovo. L'operazione di importazione avrà esito negativo se non è presente alcun conflitto o se è presente più di un set di dati esistente con lo stesso nome. |
ImportInfo
Informazioni sull'importazione
Nome | Tipo | Descrizione |
---|---|---|
connectionType |
Tipo di connessione di importazione per un file di OneDrive for Business |
|
filePath |
string |
Percorso del file OneDrive for Business Excel (.xlsx) da importare, che può essere assoluto o relativo. I file con estensione pbix di Power BI non sono supportati. |
fileUrl |
string |
URL della firma di accesso condiviso dell'archiviazione BLOB temporanea usata per importare file con estensione pbix di Power BI di grandi dimensioni tra 1 GB e 10 GB. |
PrincipalType
Tipo principale
Nome | Tipo | Descrizione |
---|---|---|
App |
string |
Tipo di entità servizio |
Group |
string |
Tipo di entità gruppo |
None |
string |
Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero. |
User |
string |
Tipo di entità utente |
Report
Report di Power BI. L'API restituisce un subset dell'elenco seguente di proprietà del report. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.
Nome | Tipo | Descrizione |
---|---|---|
appId |
string |
ID dell'app, restituito solo se il report appartiene a un'app |
datasetId |
string |
ID set di dati del report |
description |
string |
Descrizione del report |
embedUrl |
string |
URL di incorporamento del report |
id |
string |
The report ID |
name |
string |
Nome del report |
originalReportId |
string |
ID del report effettivo quando l'area di lavoro viene pubblicata come app. |
reportType |
enum:
|
Tipo di report |
subscriptions |
(Valore vuoto) Dettagli della sottoscrizione per un elemento di Power BI, ad esempio un report o un dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni sulla sottoscrizione per un report di Power BI usando le sottoscrizioni get report come Amministrazione chiamata API. |
|
users |
(Valore vuoto) Dettagli di accesso utente per un report di Power BI. Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni utente in un report di Power BI usando get report Users come chiamata API Amministrazione o la chiamata API PostWorkspaceInfo con il |
|
webUrl |
string |
URL Web del report |
ReportUser
Voce a destra dell'accesso utente di Power BI per un report
Nome | Tipo | Descrizione |
---|---|---|
displayName |
string |
Nome visualizzato dell'entità |
emailAddress |
string |
Indirizzo di posta elettronica dell'utente |
graphId |
string |
Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione. |
identifier |
string |
Identificatore dell'entità |
principalType |
Tipo principale |
|
profile |
Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy. |
|
reportUserAccessRight |
Diritto di accesso che l'utente ha per il report (livello di autorizzazione) |
|
userType |
string |
Tipo dell'utente. |
ReportUserAccessRight
Diritto di accesso che l'utente ha per il report (livello di autorizzazione)
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
Nessuna autorizzazione per il contenuto nel report |
Owner |
string |
Concede l'accesso in lettura, scrittura e ricondividi al contenuto nel report |
Read |
string |
Concede l'accesso in lettura al contenuto nel report |
ReadCopy |
string |
Concede l'accesso in lettura e copia al contenuto nel report |
ReadReshare |
string |
Concede l'accesso in lettura e ricondividi al contenuto nel report |
ReadWrite |
string |
Concede l'accesso in lettura e scrittura al contenuto nel report |
ServicePrincipalProfile
Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.
Nome | Tipo | Descrizione |
---|---|---|
displayName |
string |
Nome del profilo dell'entità servizio |
id |
string |
ID profilo dell'entità servizio |
Subscription
Sottoscrizione di posta elettronica per un elemento di Power BI (ad esempio un report o un dashboard)
Nome | Tipo | Descrizione |
---|---|---|
artifactDisplayName |
string |
Nome dell'elemento Power BI sottoscritto , ad esempio un report o un dashboard. |
artifactId |
string |
ID dell'elemento Power BI sottoscritto , ad esempio un report o un dashboard. |
artifactType |
string |
Tipo di elemento di Power BI (ad esempio , |
attachmentFormat |
string |
Formato del report collegato nella sottoscrizione di posta elettronica |
endDate |
string |
Data e ora di fine della sottoscrizione di posta elettronica |
frequency |
string |
Frequenza della sottoscrizione di posta elettronica |
id |
string |
ID sottoscrizione |
isEnabled |
boolean |
Se la sottoscrizione di posta elettronica è abilitata |
linkToContent |
boolean |
Se esiste un collegamento di sottoscrizione nella sottoscrizione di posta elettronica |
previewImage |
boolean |
Indica se esiste uno screenshot del report nella sottoscrizione di posta elettronica |
startDate |
string |
Data e ora di inizio della sottoscrizione di posta elettronica |
subArtifactDisplayName |
string |
Nome della pagina dell'elemento power BI sottoscritto, se si tratta di un report. |
title |
string |
Nome dell'app |
users |
Dettagli di ogni sottoscrittore di posta elettronica. Quando si usa la chiamata Get User Subscriptions As Amministrazione API, il valore restituito è una matrice vuota (Null). Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni sulla sottoscrizione in un report o un dashboard di Power BI usando get report Subscriptions As Amministrazione o Get Dashboard Subscriptions As Amministrazione API call( Get Report Subscriptions As Amministrazione API call). |
SubscriptionUser
Utente della sottoscrizione di posta elettronica di Power BI
Nome | Tipo | Descrizione |
---|---|---|
displayName |
string |
Nome visualizzato dell'entità |
emailAddress |
string |
Indirizzo di posta elettronica dell'utente |
graphId |
string |
Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione. |
identifier |
string |
Identificatore dell'entità |
principalType |
Tipo principale |
|
profile |
Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy. |
|
userType |
string |
Tipo dell'utente. |