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 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 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	Tipo	Descrizione
$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	AdminDatasets	Va bene

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	Un 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 di dati odata
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
PrincipalType	Tipo di entità
ServicePrincipalProfile	Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

AdminDataset

Object

Un 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	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
workspaceId	string (uuid)	ID dell'area di lavoro del set di dati. Questa proprietà verrà restituita solo in GetDatasetsAsAdmin.

AdminDatasets

Object

Wrapper dell'elenco di dati odata

Nome	Tipo	Descrizione
@odata.context	string	Contesto OData
value	AdminDataset[]	Set di dati

DatasetQueryScaleOutSettings

Object

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

Object

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

Enumerazione

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

Object

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

Object

Informazioni di crittografia per un set di dati

Nome	Tipo	Descrizione
EncryptionStatus	EncryptionStatus	Stato di crittografia del set di dati

EncryptionStatus

Enumerazione

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

PrincipalType

Enumerazione

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

ServicePrincipalProfile

Object

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

Condividi tramite

Admin - Datasets GetDatasetsAsAdmin

Autorizzazioni

Ambito obbligatorio

Limitazioni

Parametri dell'URI

Risposte

Esempio

Example

Esempio di richiesta

Risposta di esempio

Definizioni

AdminDataset

AdminDatasets

DatasetQueryScaleOutSettings

DatasetUser

DatasetUserAccessRight

DependentDataflow

Encryption

EncryptionStatus

PrincipalType

ServicePrincipalProfile

Risorse aggiuntive