Admin - Imports GetImportsAsAdmin
Restituisce un elenco di importazioni per l'organizzazione.
Autorizzazioni
- L'utente deve disporre dei diritti di amministratore( ad esempio Office 365 amministratore globale o amministratore del servizio Power BI) o eseguire l'autenticazione tramite un'entità servizio.
- Le autorizzazioni delegate sono supportate.
Quando viene eseguita 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
Numero massimo di 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 |
Filtra i risultati in base a una condizione booleana |
|
$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 |
OK |
Esempio
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/imports
Sample Response
{
"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 della 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 a cui l'utente ha per il report (livello di autorizzazione) |
Service |
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) |
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 |
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 |
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
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 di entità |
|
profile |
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 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 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:
|
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 |
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à
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
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 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 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
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 |
Tipo di entità |
|
profile |
Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy. |
|
userType |
string |
Tipo di utente. |