Admin - Datasets GetDatasetsAsAdmin
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
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 |
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/datasets
Risposta di esempio
{
"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 |
---|---|
Admin |
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. |
Admin |
Wrapper dell'elenco di dati odata |
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 |
Principal |
Tipo di entità |
Service |
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
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.
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 |
workspaceId |
string (uuid) |
ID dell'area di lavoro del set di dati. Questa proprietà verrà restituita solo in GetDatasetsAsAdmin. |
AdminDatasets
Wrapper dell'elenco di dati odata
Nome | Tipo | Descrizione |
---|---|---|
@odata.context |
string |
Contesto OData |
value |
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 |
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 |
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 |