Condividi tramite

Imports - Post Import In Group

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

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 di file nel nome specificato da datasetDisplayName, come descritto in 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 Create percorso di caricamento temporaneo in gruppo e lo script di PowerShell Importa file di grandi dimensioni. Questa funzionalità è supportata solo per le aree di lavoro per la capacità Premium.
  • Per creare un flusso di dati da un file di model.json, impostare su datasetDisplayNamemodel.json, come descritto in Parametri URI.

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo entità servizio. Per altre informazioni, vedere Profili entità servizio 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 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}
With optional parameters: 
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 area di lavoro
datasetDisplayName
 query True

string

Il nome visualizzato del set di dati deve includere l'estensione di 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.
nameConflict
 query

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.
overrideModelLabel
 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 è true.
overrideReportLabel
 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 è true.
skipReport
 query

boolean

Se ignorare l'importazione del report. Se specificato, il valore deve essere true. Supportato solo per i file pbix di Power BI.
subfolderObjectId
 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

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'archivio BLOB temporaneo usato per importare file con estensione pbix di Power BI di grandi dimensioni tra 1 GB e 10 GB.

Risposte

Nome Tipo Descrizione
200 OK

Import

OK
202 Accepted

Import

Accettato

Esempio

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

Definizioni

Nome Descrizione
connectionType

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

Un 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.
DatasetQueryScaleOutSettings

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

Immissione del diritto di accesso utente di Power BI 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 da Power BI
Encryption

Informazioni di crittografia per un set di dati
EncryptionStatus

Stato della crittografia del set di dati
Import

Oggetto import
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.
ImportInfo

Informazioni sull'importazione
PrincipalType

Tipo di entità
Report

Un 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.
ReportUser

Voce di diritto di accesso utente di Power BI per un report
ReportUserAccessRight

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

Profilo principale servizio Power BI. Rilevante solo 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)
SubscriptionUser

Un 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

Un 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 contenuti per il set di dati
CreateReportEmbedURL

string

URL di incorporamento del report creato dal set di dati
CreatedDate

string

Data e ora di creazione del set di dati
Encryption

Encryption

Informazioni sulla crittografia del set di dati. Applicabile solo quando $expand viene specificato.
IsEffectiveIdentityRequired

boolean

Indica se il set di dati richiede un'identità effettiva, 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 di 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

Indica se il set di dati è aggiornabile o meno. Un set di dati aggiornabile di Power BI è un set di dati che è stato aggiornato almeno una volta o per cui 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

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 di Power BI , ad esempio un report o un dashboard, usando l'API Get Dataset Users (Ottieni utenti del set di dati) come API Amministrazione o l'API PostWorkspaceInfo con il getArtifactUsers parametro .
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

Indica 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

Immissione del diritto di accesso utente di Power BI 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 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

PrincipalType

Tipo di entità
profile

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.
userType

string

Tipo di utente.

DatasetUserAccessRight

Diritto di accesso a cui 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 ricondivisione al contenuto nel set di dati
ReadReshareExplore

string

Concede l'accesso in lettura, ricondivisione ed esplora 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 esplorazione 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 l'accesso in lettura, scrittura, ricondivisione ed esplora 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 del flusso di dati di destinazione

Encryption

Informazioni di crittografia per un set di dati

Nome Tipo Descrizione
EncryptionStatus

EncryptionStatus

Stato della crittografia del set di dati

EncryptionStatus

Stato della crittografia del 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:
  • Failed
  • Publishing
  • Succeeded

Stato di caricamento dell'importazione
name

string

Nome dell'importazione
reports

Report[]

Report associati all'importazione
updatedDateTime

string

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

ImportInfo

Informazioni sull'importazione

Nome Tipo Descrizione
connectionType

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'archivio BLOB temporaneo usato per importare file con estensione pbix di Power BI di grandi dimensioni tra 1 GB e 10 GB.

PrincipalType

Tipo di entità

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 intera organizzazione.
User

string

Tipo di entità utente

Report

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

Tipo di report
subscriptions

Subscription[]

(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 futura. È possibile recuperare le informazioni sulla sottoscrizione per un report di Power BI usando Get Report Subscriptions (Ottieni sottoscrizioni report) come Amministrazione chiamata API.
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 le informazioni utente in un report di Power BI usando Get Report Users (Ottieni utenti report) come chiamata API Amministrazione o l'API PostWorkspaceInfo con il getArtifactUsers parametro .
webUrl

string

URL Web del report

ReportUser

Voce di diritto di 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

PrincipalType

Tipo di entità
profile

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.
reportUserAccessRight

ReportUserAccessRight

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

string

Tipo di utente.

ReportUserAccessRight

Diritto di accesso a cui 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 ricondivisione 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 ricondivisione al contenuto nel report
ReadWrite

string

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

ServicePrincipalProfile

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

ID del 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 di Power BI sottoscritto , ad esempio un report o un dashboard.
artifactId

string

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

string

Tipo di elemento di Power BI ( ad esempio Report, Dashboardo Dataset)
attachmentFormat

string

Formato del report allegato 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

Indica se la sottoscrizione di posta elettronica è abilitata
linkToContent

boolean

Indica se esiste un collegamento di sottoscrizione nella sottoscrizione di posta elettronica
previewImage

boolean

Indica se nella sottoscrizione di posta elettronica è presente uno screenshot del report
startDate

string

Data e ora di inizio della sottoscrizione di posta elettronica
subArtifactDisplayName

string

Nome della pagina dell'elemento di 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 la chiamata api Get User Subscriptions As Amministrazione, il valore restituito è una matrice vuota (null). Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare le informazioni sulla sottoscrizione in un report o un dashboard di Power BI usando get report subscriptions As Amministrazione (Ottieni sottoscrizioni report) o Get Dashboard Subscriptions As Amministrazione API calls (Ottieni sottoscrizioni report come Amministrazione chiamate API).

SubscriptionUser

Un 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

PrincipalType

Tipo di entità
profile

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.
userType

string

Tipo di utente.