Datasets - Get Dataset In Group

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Restituisce il set di dati specificato dall'area di lavoro specificata.

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: Profili dell'entità servizio in Power BI Embedded.

Ambito obbligatorio

Dataset.ReadWrite.All o Dataset.Read.All

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasetId	path	True	string	ID del set di dati
groupId	path	True	string uuid	ID area di lavoro

Risposte

Nome	Tipo	Descrizione
200 OK	Dataset	OK

Esempio

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229

Sample Response

Status code:: 200

{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "name": "SalesMarketing",
  "addRowsAPIEnabled": false,
  "configuredBy": "john@contoso.com",
  "isRefreshable": true,
  "isEffectiveIdentityRequired": true,
  "isEffectiveIdentityRolesRequired": true,
  "isOnPremGatewayRequired": false,
  "targetStorageMode": "Abf"
}

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

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

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

Condividi tramite