Condividi tramite


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

Imports

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.

DatasetQueryScaleOutSettings

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

DatasetUser

Voce a destra dell'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 di crittografia del set di dati

Import

Oggetto import

Imports

Wrapper di risposta OData per una raccolta di importazione di Power BI

PrincipalType

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.

ReportUser

Voce a destra dell'accesso utente di Power BI per un report

ReportUserAccessRight

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

ServicePrincipalProfile

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)

SubscriptionUser

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

Encryption

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

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

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

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 as Admin o l'API PostWorkspaceInfo con il parametro getArtifactUsers.

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: -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

Voce a destra dell'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 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 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

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:
  • 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

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:
  • 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 l'Ottenere sottoscrizioni di report come chiamata API di amministrazione.

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

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

PrincipalType

Tipo di entità

profile

ServicePrincipalProfile

Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

reportUserAccessRight

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 Report, Dashboardo 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 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 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

PrincipalType

Tipo di entità

profile

ServicePrincipalProfile

Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

userType

string

Tipo di utente.