Condividi tramite

Admin - Datasets GetDatasetsAsAdmin

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

Restituisce un elenco di set di dati per l'organizzazione.

Autorizzazioni

  • L'utente deve avere diritti di amministratore, ad esempio Office 365 amministratore globale o amministratore del servizio Power BI, oppure eseguire l'autenticazione usando un'entità servizio.
  • Le autorizzazioni delegate sono supportate.

Quando è in esecuzione nell'autenticazione prinicipal del servizio, un'app non deve disporre di premissioni necessarie per il consenso amministratore per Power BI impostata nel portale di Azure.

Ambito obbligatorio

Tenant.Read.All o Tenant.ReadWrite.All

Pertinente 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 50 richieste all'ora o 5 richieste al minuto, per tenant. 

GET https://api.powerbi.com/v1.0/myorg/admin/datasets
Con parametri facoltativi: 
GET https://api.powerbi.com/v1.0/myorg/admin/datasets?$filter={$filter}&$top={$top}&$skip={$skip}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
$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

AdminDatasets

OK

Esempio

Example

Esempio di richiesta

GET https://api.powerbi.com/v1.0/myorg/admin/datasets

Risposta di esempio

Codice di stato:
200 
{
  "value": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "name": "SalesMarketing",
      "addRowsAPIEnabled": false,
      "configuredBy": "john@contoso.com",
      "isRefreshable": true,
      "isEffectiveIdentityRequired": false,
      "isEffectiveIdentityRolesRequired": false,
      "isOnPremGatewayRequired": false,
      "isInPlaceSharingEnabled": false,
      "workspaceId": "5c968528-70b6-4588-809f-ce811ffa5c23"
    }
  ]
}

Definizioni

Nome Descrizione
AdminDataset

Set di dati di Power BI restituito dalle API di Amministrazione. 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.
AdminDatasets

Wrapper dell'elenco odata del set di dati
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 che 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 dei set di dati
PrincipalType

Tipo principale
ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

AdminDataset

Set di dati di Power BI restituito dalle API di Amministrazione. 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

Encryption

Informazioni sulla crittografia dei set di dati. Applicabile solo quando $expand viene specificato.
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

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 dipende da
users

DatasetUser[]

(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 getArtifactUsers parametro .
webUrl

string

URL Web del set di dati
workspaceId

string

ID area di lavoro del set di dati. Questa proprietà verrà restituita solo in GetDatasetsAsAdmin.

AdminDatasets

Wrapper dell'elenco odata del set di dati

Nome Tipo Descrizione
odata.context

string

Contesto OData
value

AdminDataset[]

Set di dati

DatasetQueryScaleOutSettings

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

Nome Tipo Descrizione
autoSyncReadOnlyReplicas

boolean

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

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

PrincipalType

Tipo principale
profile

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.
userType

string

Tipo dell'utente.

DatasetUserAccessRight

Diritto di accesso che 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 rishare al contenuto nel set di dati
ReadReshareExplore

string

Concede lettura, ricondividi e Esplora l'accesso 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 esplora 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 lettura, scrittura, ricondividi e esplora l'accesso 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

EncryptionStatus

Stato della crittografia dei set di dati

EncryptionStatus

Stato della crittografia dei 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

PrincipalType

Tipo principale

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

string

Tipo di entità utente

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

Nome Tipo Descrizione
displayName

string

Nome del profilo dell'entità servizio
id

string

ID profilo dell'entità servizio