Imports - Post Import
Crea nuovo contenuto nell'area di lavoro personale.
Per un esempio di uso di questa API, vedere lo script Importa file di grandi dimensioni di PowerShell.
Nota
Contenuto supportato:
- File con estensione pbix di Power BI
- File JSON (.json)
- File di Excel (con estensione xlsx)
- File RDL (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 di Power BI con estensione pbix di grandi dimensioni compresi tra 1 GB e 10 GB, vedere Create Percorso di caricamento temporaneo. 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.
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/imports?datasetDisplayName={datasetDisplayName}
POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName={datasetDisplayName}&nameConflict={nameConflict}&skipReport={skipReport}&overrideReportLabel={overrideReportLabel}&overrideModelLabel={overrideModelLabel}&subfolderObjectId={subfolderObjectId}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
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. |
name
|
query |
Specifica cosa fare se esiste già un set di dati con lo stesso nome. Il valore predefinito è |
||
override
|
query |
boolean |
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 del report esistente durante la ripubblicazione di un file con estensione pbix di Power BI. Il valore predefinito del servizio è |
|
skip
|
query |
boolean |
Se ignorare l'importazione del report. Se specificato, il valore deve essere |
|
subfolder
|
query |
string uuid |
ID della sottocartella per importare il file nella sottocartella. |
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 example |
Post import example |
Post import with 'skip |
Import dataflow example
Esempio di richiesta
POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName=model.json&nameConflict=Abort
{
"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--"
}
Risposta di esempio
{
"id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}
Post import example
Esempio di richiesta
POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName=MyReport&nameConflict=Ignore
{
"value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}
Risposta di esempio
{
"id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}
Post import with 'skipReport' example
Esempio di richiesta
POST https://api.powerbi.com/v1.0/myorg/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--"
}
Risposta di esempio
{
"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.
Nome | Tipo | Descrizione |
---|---|---|
Abort |
string |
Se esiste già un set di dati con lo stesso nome, 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 |
isOwnedByMe |
boolean |
Determinare se il report viene creato dall'utente corrente. |
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. |