Admin - Imports GetImportsAsAdmin
Restituisce un elenco di importazioni per l'organizzazione.
Autorizzazioni
- L'utente deve essere un amministratore di Fabric o eseguire l'autenticazione usando un'entità servizio.
- Le autorizzazioni delegate sono supportate.
Durante l'esecuzione con l'autenticazione priniciale del servizio, un'app non deve avere premissioni necessarie per il consenso amministratore per Power BI impostate nel portale di Azure.
Ambito obbligatorio
Tenant.Read.All o Tenant.ReadWrite.All
Rilevante solo quando si esegue l'autenticazione tramite un token di accesso amministratore delegato standard. Non deve essere presente quando viene usata l'autenticazione tramite un'entità servizio.
Limitazioni
Massimo 200 richieste all'ora.
GET https://api.powerbi.com/v1.0/myorg/admin/imports
GET https://api.powerbi.com/v1.0/myorg/admin/imports?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
$expand
|
query |
string |
Espande le entità correlate inline |
|
$filter
|
query |
string |
Restituisce un sottoinsieme di risultati in base condizione del parametro di query di filtro Odata. |
|
$skip
|
query |
integer (int32) |
Ignora i primi n risultati |
|
$top
|
query |
integer (int32) |
Restituisce solo i primi n risultati |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Va bene |
Esempio
Example
Esempio di richiesta
GET https://api.powerbi.com/v1.0/myorg/admin/imports
Risposta di esempio
{
"value": [
{
"id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
"importState": "Succeeded",
"createdDateTime": "2018-05-08T14:56:18.477Z",
"updatedDateTime": "2018-05-08T14:56:18.477Z",
"name": "SalesMarketing",
"connectionType": "import",
"source": "Upload",
"datasets": [
{
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"name": "SalesMarketing",
"webUrl": "https://app.powerbi.com/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}
],
"reports": [
{
"id": "5b218778-e7a5-4d73-8187-f10824047715",
"name": "SalesMarketing",
"webUrl": "https://app.powerbi.com/reports/5b218778-e7a5-4d73-8187-f10824047715",
"embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715"
}
]
}
]
}
Definizioni
Nome | Descrizione |
---|---|
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 a cui 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 di crittografia del set di dati |
Import |
Oggetto import |
Imports |
Wrapper di risposta OData per una raccolta di importazione di Power BI |
Principal |
Tipo di entità |
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 dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
Subscription |
Sottoscrizione di posta elettronica per un elemento di Power BI (ad esempio un report o un dashboard) |
Subscription |
Un utente della sottoscrizione di posta elettronica di Power BI |
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 |
Proprietà deprecata che deve essere ignorata. |
Encryption |
Informazioni sulla crittografia del set di dati. Applicabile solo quando si specifica |
|
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 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 |
Questo campo restituisce |
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 |
name |
string |
Nome del set di dati |
qnaEmbedURL |
string |
Il set di dati Q&UN URL di incorporamento |
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 da cui dipende questo elemento |
|
users |
(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 as Admin o l'API PostWorkspaceInfo con il 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 minimum: -1maximum: 64 |
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 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 |
Tipo di entità |
|
profile |
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
|
userType |
string |
Tipo di utente. |
DatasetUserAccessRight
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 |
ReadExplore |
Concede l'accesso in lettura ed esplora al contenuto nel set di dati |
ReadReshare |
Concede l'accesso in lettura e ricondivisione al contenuto nel set di dati |
ReadReshareExplore |
Concede l'accesso in lettura, ricondivisione ed esplora al contenuto nel set di dati |
ReadWrite |
Concede l'accesso in lettura e scrittura al contenuto nel set di dati |
ReadWriteExplore |
Concede l'accesso in lettura, scrittura ed esplorazione al contenuto nel set di dati |
ReadWriteReshare |
Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel set di dati |
ReadWriteReshareExplore |
Concede l'accesso al contenuto nel set di dati di lettura, scrittura, ricondivisione ed esplora |
DependentDataflow
Flusso di dati dipendente da Power BI
Nome | Tipo | Descrizione |
---|---|---|
groupId |
string |
ID del 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 di crittografia del set di dati |
EncryptionStatus
Stato di crittografia del set di dati
Valore | Descrizione |
---|---|
InSyncWithWorkspace |
La crittografia è supportata ed è sincronizzata con le impostazioni di crittografia |
NotInSyncWithWorkspace |
La crittografia è supportata ma non è sincronizzata con le impostazioni di crittografia |
NotSupported |
La crittografia non è supportata per questo set di dati |
Unknown |
Lo stato della crittografia è sconosciuto a causa del danneggiamento del set di dati |
Import
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 |
id |
string (uuid) |
ID importazione |
importState |
enum:
|
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 |
Imports
Wrapper di risposta OData per una raccolta di importazione di Power BI
Nome | Tipo | Descrizione |
---|---|---|
@odata.context |
string |
Contesto OData |
value |
Import[] |
Raccolta di importazione |
PrincipalType
Tipo di entità
Valore | Descrizione |
---|---|
App |
Tipo di entità servizio |
Group |
Tipo di entità gruppo |
None |
Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero. |
User |
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 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 (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:
|
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 futura. È possibile recuperare le informazioni sulla sottoscrizione per un report di Power BI usando l'Ottenere sottoscrizioni di report come chiamata API di amministrazione. |
|
users |
(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 sull'utente in un report di Power BI usando il Ottenere utenti report come chiamata API di amministrazione o la chiamata API PostWorkspaceInfo con il parametro |
|
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 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 |
Tipo di entità |
|
profile |
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
|
reportUserAccessRight |
Diritto di accesso che l'utente ha per il report (livello di autorizzazione) |
|
userType |
string |
Tipo di utente. |
ReportUserAccessRight
Diritto di accesso che l'utente ha per il report (livello di autorizzazione)
Valore | Descrizione |
---|---|
None |
Nessuna autorizzazione per il contenuto nel report |
Owner |
Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel report |
Read |
Concede l'accesso in lettura al contenuto nel report |
ReadCopy |
Concede l'accesso in lettura e copia al contenuto nel report |
ReadReshare |
Concede l'accesso in lettura e ricondivisione al contenuto nel report |
ReadWrite |
Concede l'accesso in lettura e scrittura al contenuto nel report |
ServicePrincipalProfile
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
Nome | Tipo | Descrizione |
---|---|---|
displayName |
string |
Nome del profilo dell'entità servizio |
id |
string (uuid) |
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 (uuid) |
ID dell'elemento di Power BI sottoscritto( ad esempio un report o un dashboard) |
artifactType |
string |
Tipo di elemento di Power BI , ad esempio un |
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 di 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 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 il Ottenere sottoscrizioni di report come amministratore o Ottenere sottoscrizioni dashboard come chiamate API di amministrazione. |
SubscriptionUser
Un utente della sottoscrizione di posta elettronica di 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 |
Tipo di entità |
|
profile |
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
|
userType |
string |
Tipo di utente. |