Imports - Post Import In Group

Servizio:
Power BI REST APIs
Versione API:
v1.0

Crea nuovo contenuto nell'area di lavoro specificata.

Nota

Contenuto supportato:

  • Power BI file con estensione pbix
  • File JSON (.json)
  • file Excel (.xlsx)
  • 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. Impostare datasetDisplayName sul nome del file, inclusa l'estensione , ad esempio MyReport.pbix, report.rdl.
  • Per importare un file di report impaginato (con estensione rdl), includere l'estensione .rdl in datasetDisplayName (ad esempio, paginatedReport.rdl). Per nameConflict, usare Abort o Overwrite solo .
  • Per importare un file .xlsx da OneDrive for Business, specificare il tipo di contenuto application/json nelle intestazioni della richiesta. Includere ImportInfo con filePath impostato sul percorso del file .xlsx nel corpo della richiesta. Non impostare il datasetDisplayName parametro di query per questo metodo di importazione.
  • Per importare file con estensione pbix di grandi dimensioni Power BI compresi tra 1 GB e 10 GB, specificare il tipo di contenuto application/json e includere ImportInfo con fileUrl impostato sull'URL della firma di accesso condiviso ottenuto da Crea percorso di caricamento temporaneo nel gruppo. Impostare datasetDisplayName su un nome con un'estensione .pbix . Questa opzione è supportata solo per le aree di lavoro della capacità Premium. Per un esempio, vedere lo script di PowerShell Importa file di grandi dimensioni .
  • Per creare un flusso di dati da un file di model.json, impostare su datasetDisplayNamemodel.json. Per nameConflict, usare Abort o GenerateUniqueName solo .

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: profili dell'entità Service in Power BI Embedded.

Ambito obbligatorio

Dataset.ReadWrite.All

Limitazioni

  • I flussi di dati con entità servizio non sono supportati.
  • L'importazione di un file con estensione pbix Power BI da OneDrive non è supportata.
  • L'importazione di un file con un'etichetta di riservatezza protetta non è supportata per le entità servizio.
  • L'importazione tramite un percorso di caricamento temporaneo (fileUrl) richiede un'area di lavoro per la capacità Premium.
  • Il parametro datasetDisplayName non è supportato durante l'importazione di cartelle di lavoro di Excel da OneDrive for Business tramite filePath. 

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/imports?datasetDisplayName={datasetDisplayName}
Con parametri facoltativi: 
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/imports?datasetDisplayName={datasetDisplayName}&nameConflict={nameConflict}&skipReport={skipReport}&overrideReportLabel={overrideReportLabel}&overrideModelLabel={overrideModelLabel}&subfolderObjectId={subfolderObjectId}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
groupId
 path True

string (uuid)

ID dell'area di lavoro
datasetDisplayName
 query True

string

Nome visualizzato del set di dati, inclusa l'estensione del file , ad esempio MyReport.pbix, report.rdl. Obbligatorio per multipart/form-data i caricamenti e fileUrl le importazioni. Non supportato durante l'importazione da OneDrive for Business tramite filePath. Per l'importazione o la creazione di flussi di dati, impostare questa proprietà su model.json.
nameConflict
 query

ImportConflictHandlerMode

Specifica le operazioni da eseguire se esiste già un set di dati con lo stesso nome. Il valore predefinito è Ignore. Per i file RDL, usare Abort o Overwrite solo. Per i file di flusso di dati model.json, usare Abort o GenerateUniqueName solo .
overrideModelLabel
 query

boolean

Determina se eseguire l'override dell'etichetta esistente in un modello quando si ripubblica un file con estensione pbix Power BI. Il valore predefinito del servizio è true.
overrideReportLabel
 query

boolean

Indica se eseguire l'override dell'etichetta esistente in un report durante la ripubblicazione di un file con estensione pbix Power BI. Il valore predefinito del servizio è true.
skipReport
 query

boolean

Se ignorare l'importazione del report. Se specificato, il valore deve essere true. Supportato solo per Power BI file con estensione pbix.
subfolderObjectId
 query

string (uuid)

ID della sottocartella per importare il file nella sottocartella.

Corpo della richiesta

Nome Tipo Descrizione
connectionType

connectionType

Tipo di connessione di importazione per un file OneDrive for Business
filePath

string

Percorso del file OneDrive for Business Excel (.xlsx) da importare, che può essere assoluto o relativo. Power BI file con estensione pbix non sono supportati.
fileUrl

string

URL della firma di accesso condiviso dell'archivio BLOB temporaneo usato per importare file con estensione pbix di grandi dimensioni Power BI da 1 GB a 10 GB.

Risposte

Nome Tipo Descrizione
200 OK

Import

Va bene
202 Accepted

Import

Accettato

Esempio

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

Import dataflow model.json example

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=model.json&nameConflict=Abort&skipReport=True
Corpo della richiesta
{
  "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

Codice di stato:
202 
{
  "id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}

Post import example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
202 
{
  "id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}

Post import skip report example

Esempio di richiesta

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
Corpo della richiesta
{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

Risposta di esempio

Codice di stato:
202 
{
  "id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}

Definizioni

Nome Descrizione
connectionType

Tipo di connessione di importazione per un file OneDrive for Business
Dataset

Set di dati 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 Power BI.
DatasetQueryScaleOutSettings

Eseguire query su impostazioni di scalabilità orizzontale di un set di dati
DatasetUser

Una voce di accesso Power BI utente a destra per un set di dati
DatasetUserAccessRight

Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione)
DependentDataflow

Flusso di dati dipendente Power BI
Encryption

Informazioni di crittografia per un set di dati
EncryptionStatus

Stato di crittografia del set di dati
Import

Oggetto import
ImportConflictHandlerMode

Specifica le operazioni da eseguire se esiste già un set di dati con lo stesso nome. Il valore predefinito è Ignore. Per i file RDL, usare Abort o Overwrite solo. Per i file di flusso di dati model.json, usare Abort o GenerateUniqueName solo .
ImportError

Dettagli dell'errore per un'importazione non riuscita
ImportInfo

Informazioni sull'importazione
PowerBIApiErrorResponseDetail

Informazioni dettagliate su una risposta di errore Power BI
PrincipalType

Tipo di entità
Report

Report 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 Power BI.
ReportUser

Immissione del diritto di accesso utente Power BI per un report
ReportUserAccessRight

Diritto di accesso che l'utente ha per il report (livello di autorizzazione)
ServicePrincipalProfile

Profilo entità di servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.
Subscription

Una sottoscrizione di posta elettronica per un elemento Power BI (ad esempio un report o un dashboard)
SubscriptionUser

Un utente di sottoscrizione di posta elettronica Power BI

connectionType

Enumerazione

Tipo di connessione di importazione per un file OneDrive for Business

Valore Descrizione
import
connect

Dataset

Oggetto

Set di dati 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 Power BI.

Nome Tipo Descrizione
ContentProviderType

string

Tipo di provider di contenuto per il modello semantico.

I contentProviderType seguenti vengono archiviati nell'area principale del tenant:

ContentProviderType
Excel
CSV
UsageMetricsUserReport
UsageMetricsUserDashboard
RealTimeInPushMode
RealTimeInPubNubMode
RealTimeInStreamingMode

I contentProviderType seguenti vengono archiviati nell'area capacità:

ContentProviderType
PowerBIDesktop
PowerBIModelingService
PbixInImportMode
PbixInDirectQueryMode
PbixInCompositeMode
InImportMode
InDirectQueryMode
InCompositeMode
Encryption

Encryption

Informazioni sulla crittografia del set di dati. Applicabile solo quando si specifica $expand.
addRowsAPIEnabled

boolean

Indica se il set di dati consente l'aggiunta di nuove righe
configuredBy

string

Proprietario del set di dati
createReportEmbedURL

string

Il set di dati crea l'URL di incorporamento del report
createdDate

string (date-time)

Data e ora di creazione del set di dati
description

string

Descrizione del set di dati
id

string

ID set di dati
isEffectiveIdentityRequired

boolean

Indica se il set di dati richiede un'identità efficace, che è necessario inviare in una chiamata API GenerateToken.
isEffectiveIdentityRolesRequired

boolean

Indica se la sicurezza a livello di riga è definita all'interno del file con estensione pbix Power BI. In tal caso, è necessario specificare un ruolo.
isInPlaceSharingEnabled

boolean

Indica se il set di dati può essere condiviso con utenti esterni da utilizzare nel proprio tenant
isOnPremGatewayRequired

boolean

Indica se il set di dati richiede un gateway dati locale
isRefreshable

boolean

Questo campo restituisce true quando il set di dati viene aggiornato di recente o configurato per l'aggiornamento automatico, con la modalità di connessione impostata specificamente su "Importa". Il valore restituirà false per altre modalità di connessione, ad esempio "DirectQuery" e "LiveConnection", indipendentemente dal fatto che il set di dati sia aggiornato manualmente o sia configurato per l'aggiornamento automatico.
name

string

Nome del set di dati
qnaEmbedURL

string

Il set di dati Q&UN URL di incorporamento
queryScaleOutSettings

DatasetQueryScaleOutSettings

Eseguire query su impostazioni di scalabilità orizzontale di un set di dati
targetStorageMode

string

Modalità di archiviazione del set di dati
upstreamDataflows

DependentDataflow[]

L'elenco di tutti i flussi di dati da cui dipende questo elemento
users

DatasetUser[]

(Valore vuoto) Dettagli di accesso utente del set di dati. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare informazioni utente su un elemento Power BI (ad esempio un report o un dashboard) usando l'API Get Dataset Users as Admin o l'API PostWorkspaceInfo con il parametro getArtifactUsers.
webUrl

string

URL Web del set di dati

DatasetQueryScaleOutSettings

Oggetto

Eseguire query su impostazioni di scalabilità orizzontale di un set di dati

Nome Tipo Descrizione
autoSyncReadOnlyReplicas

boolean

Indica se il set di dati sincronizza automaticamente le repliche di sola lettura
maxReadOnlyReplicas

integer

minimum: -1
maximum: 64

Numero massimo di repliche di sola lettura per il set di dati (0-64, -1 per il numero automatico di repliche)

DatasetUser

Oggetto

Una voce di accesso Power BI utente a destra per un set di dati

Nome Tipo Descrizione
datasetUserAccessRight

DatasetUserAccessRight

Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione)
displayName

string

Nome visualizzato dell'entità
emailAddress

string

Indirizzo e-mail dell'utente
graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.
identifier

string

Identificatore dell'entità
principalType

PrincipalType

Tipo di entità
profile

ServicePrincipalProfile

Profilo entità di servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.
userType

string

Tipo di utente.

DatasetUserAccessRight

Enumerazione

Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione)

Valore Descrizione
None

Rimuove l'autorizzazione per il contenuto nel set di dati
Read

Concede l'accesso in lettura al contenuto nel set di dati
ReadWrite

Concede l'accesso in lettura e scrittura al contenuto nel set di dati
ReadReshare

Concede l'accesso in lettura e ricondivisione al contenuto nel set di dati
ReadWriteReshare

Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel set di dati
ReadExplore

Concede l'accesso in lettura ed esplora al contenuto nel set di dati
ReadReshareExplore

Concede l'accesso in lettura, ricondivisione ed esplora al contenuto nel set di dati
ReadWriteExplore

Concede l'accesso in lettura, scrittura ed esplorazione al contenuto nel set di dati
ReadWriteReshareExplore

Concede l'accesso al contenuto nel set di dati di lettura, scrittura, ricondivisione ed esplora

DependentDataflow

Oggetto

Flusso di dati dipendente Power BI

Nome Tipo Descrizione
groupId

string

ID del gruppo di destinazione
targetDataflowId

string

ID flusso di dati di destinazione

Encryption

Oggetto

Informazioni di crittografia per un set di dati

Nome Tipo Descrizione
EncryptionStatus

EncryptionStatus

Stato di crittografia del set di dati

EncryptionStatus

Enumerazione

Stato di crittografia del set di dati

Valore Descrizione
Unknown

Lo stato della crittografia è sconosciuto a causa del danneggiamento del set di dati
NotSupported

La crittografia non è supportata per questo set di dati
InSyncWithWorkspace

La crittografia è supportata ed è sincronizzata con le impostazioni di crittografia
NotInSyncWithWorkspace

La crittografia è supportata ma non è sincronizzata con le impostazioni di crittografia

Import

Oggetto

Oggetto import

Nome Tipo Descrizione
createdDateTime

string (date-time)

Data e ora di creazione dell'importazione
datasets

Dataset[]

Set di dati associati a questa importazione
error

ImportError

Dettagli dell'errore quando l'importazione non è riuscita
id

string (uuid)

ID importazione
importState enum:
  • Failed
  • Publishing
  • Succeeded

Stato di caricamento dell'importazione
name

string

Nome dell'importazione
reports

Report[]

Report associati all'importazione
updatedDateTime

string (date-time)

Importare data e ora dell'ultimo aggiornamento

ImportConflictHandlerMode

Enumerazione

Specifica le operazioni da eseguire se esiste già un set di dati con lo stesso nome. Il valore predefinito è Ignore. Per i file RDL, usare Abort o Overwrite solo. Per i file di flusso di dati model.json, usare Abort o GenerateUniqueName solo .

Valore Descrizione
Ignore

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

Se il set di dati o il flusso di dati con lo stesso nome esiste già, l'operazione di importazione verrà annullata.
Overwrite

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 sono presenti più set di dati esistenti con lo stesso nome.
CreateOrOverwrite

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 sono presenti più set di dati esistenti con lo stesso nome.
GenerateUniqueName

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.

ImportError

Oggetto

Dettagli dell'errore per un'importazione non riuscita

Nome Tipo Descrizione
code

string

Codice di errore
details

PowerBIApiErrorResponseDetail[]

Matrice di dettagli dell'errore

ImportInfo

Oggetto

Informazioni sull'importazione

Nome Tipo Descrizione
connectionType

connectionType

Tipo di connessione di importazione per un file OneDrive for Business
filePath

string

Percorso del file OneDrive for Business Excel (.xlsx) da importare, che può essere assoluto o relativo. Power BI file con estensione pbix non sono supportati.
fileUrl

string

URL della firma di accesso condiviso dell'archivio BLOB temporaneo usato per importare file con estensione pbix di grandi dimensioni Power BI da 1 GB a 10 GB.

PowerBIApiErrorResponseDetail

Oggetto

Informazioni dettagliate su una risposta di errore Power BI

Nome Tipo Descrizione
code

string

Codice di errore
message

string

Messaggio di errore
target

string

Destinazione dell'errore

PrincipalType

Enumerazione

Tipo di entità

Valore Descrizione
None

Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero.
User

Tipo di entità utente
Group

Tipo di entità gruppo
App

Tipo di entità servizio

Report

Oggetto

Report 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 Power BI.

Nome Tipo Descrizione
appId

string

ID app, restituito solo se il report appartiene a un'app
datasetId

string

ID del set di dati del report
description

string

Descrizione del report
embedUrl

string

URL di incorporamento del report
format

string

Tipo di formato della definizione del report. Per PowerBIReport:

Per PaginatedReport:
id

string (uuid)

The report ID
isOwnedByMe

boolean

Indica se l'utente corrente può modificare o creare una copia del report.
name

string

Nome del report. I report dell'app iniziano con il prefisso [App].
originalReportId

string (uuid)

ID report effettivo quando l'area di lavoro viene pubblicata come app.
reportType enum:
  • PaginatedReport
  • PowerBIReport

Tipo di report
subscriptions

Subscription[]

(Valore vuoto) Dettagli della sottoscrizione per un elemento Power BI, ad esempio un report o un dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare informazioni sulla sottoscrizione per un report Power BI usando la chiamata API Get Report Subscriptions as Admin.
users

ReportUser[]

(Valore vuoto) Dettagli di accesso utente per un report di Power BI. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare informazioni utente su un report di Power BI usando la chiamata API Get Report Users as Admin o PostWorkspaceInfo con il parametro getArtifactUsers.
webUrl

string

URL Web del report

ReportUser

Oggetto

Immissione del diritto di accesso utente Power BI per un report

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità
emailAddress

string

Indirizzo e-mail dell'utente
graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.
identifier

string

Identificatore dell'entità
principalType

PrincipalType

Tipo di entità
profile

ServicePrincipalProfile

Profilo entità di servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.
reportUserAccessRight

ReportUserAccessRight

Diritto di accesso che l'utente ha per il report (livello di autorizzazione)
userType

string

Tipo di utente.

ReportUserAccessRight

Enumerazione

Diritto di accesso che l'utente ha per il report (livello di autorizzazione)

Valore Descrizione
None

Nessuna autorizzazione per il contenuto nel report
Read

Concede l'accesso in lettura al contenuto nel report
ReadWrite

Concede l'accesso in lettura e scrittura al contenuto nel report
ReadReshare

Concede l'accesso in lettura e ricondivisione al contenuto nel report
ReadCopy

Concede l'accesso in lettura e copia al contenuto nel report
Owner

Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel report

ServicePrincipalProfile

Oggetto

Profilo entità di servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

Nome Tipo Descrizione
displayName

string

Nome del profilo dell'entità servizio
id

string (uuid)

ID del profilo dell'entità servizio

Subscription

Oggetto

Una sottoscrizione di posta elettronica per un elemento 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 (uuid)

ID dell'elemento di Power BI sottoscritto(ad esempio un report o un dashboard)
artifactType

string

Tipo di elemento Power BI ,ad esempio un Report, Dashboard o Dataset)
attachmentFormat

string

Formato del report allegato nella sottoscrizione di posta elettronica
endDate

string (date-time)

Data e ora di fine della sottoscrizione di posta elettronica
frequency

string

Frequenza della sottoscrizione di posta elettronica
id

string (uuid)

ID sottoscrizione
isEnabled

boolean

Indica se la sottoscrizione tramite posta elettronica è abilitata
linkToContent

boolean

Indica 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 (date-time)

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

SubscriptionUser[]

Dettagli di ogni sottoscrittore di posta elettronica. Quando si usa il Ottenere sottoscrizioni utente come amministratore chiamata API, il valore restituito è una matrice vuota (null). Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare informazioni sulla sottoscrizione in un report o un dashboard di Power BI usando Get Report Subscriptions As Admin o Get Dashboard Subscriptions As Admin chiamate API.

SubscriptionUser

Oggetto

Un utente di sottoscrizione di posta elettronica Power BI

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità
emailAddress

string

Indirizzo e-mail dell'utente
graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.
identifier

string

Identificatore dell'entità
principalType

PrincipalType

Tipo di entità
profile

ServicePrincipalProfile

Profilo entità di servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.
userType

string

Tipo di utente.