Admin - Get Refreshables
Restituisce un elenco di aggiornamenti per l'organizzazione all'interno di una capacità.
Power BI mantiene una cronologia di aggiornamento di sette giorni per ogni set di dati, fino a un massimo di sessanta aggiornamenti.
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/capacities/refreshables?$top={$top}
GET https://api.powerbi.com/v1.0/myorg/admin/capacities/refreshables?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
$top
|
query | True |
integer int32 |
Restituisce solo i primi n risultati. |
$expand
|
query |
string |
Accetta un elenco delimitato da virgole di tipi di dati, che verrà espanso inline nella risposta. Supporta |
|
$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. Usare con l'inizio per recuperare i risultati oltre i primi 1000. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
Esempio
Example |
Get refreshables, filtering for an average refresh duration of greater than 30 minutes example. |
Get refreshables with their 'capacity' and 'group' expanded example |
Example
Esempio di richiesta
GET https://api.powerbi.com/v1.0/myorg/admin/capacities/refreshables
Risposta di esempio
{
"value": [
{
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"name": "SalesMarketing",
"kind": "Dataset",
"startTime": "2017-06-13T09:25:43.153Z",
"endTime": "2017-06-19T11:22:32.445Z",
"refreshCount": 22,
"refreshFailures": 0,
"averageDuration": 289.3814,
"medianDuration": 268.6245,
"refreshesPerDay": 11,
"lastRefresh": {
"refreshType": "ViaApi",
"startTime": "2017-06-13T09:25:43.153Z",
"endTime": "2017-06-13T09:31:43.153Z",
"status": "Completed",
"requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1"
},
"refreshSchedule": {
"days": [
"Sunday",
"Friday",
"Saturday"
],
"times": [
"05:00",
"11:30",
"17:30",
"23:00"
],
"enabled": true,
"localTimeZoneId": "UTC",
"notifyOption": "MailOnFailure"
},
"configuredBy": [
"john@contoso.com"
]
}
]
}
Get refreshables, filtering for an average refresh duration of greater than 30 minutes example.
Esempio di richiesta
GET https://api.powerbi.com/v1.0/myorg/admin/capacities/refreshables?$filter=averageDuration gt 1800
Risposta di esempio
{
"value": [
{
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"name": "SalesMarketing",
"kind": "Dataset",
"startTime": "2017-06-13T09:25:43.153Z",
"endTime": "2017-06-19T11:22:32.445Z",
"refreshCount": 22,
"refreshFailures": 0,
"averageDuration": 3289.3814,
"medianDuration": 2268.6245,
"refreshesPerDay": 11,
"lastRefresh": {
"refreshType": "ViaApi",
"startTime": "2017-06-13T09:25:43.153Z",
"endTime": "2017-06-13T09:58:05.221Z",
"status": "Completed",
"requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1"
},
"refreshSchedule": {
"days": [
"Sunday",
"Friday",
"Saturday"
],
"times": [
"05:00",
"11:30",
"17:30",
"23:00"
],
"enabled": true,
"localTimeZoneId": "UTC",
"notifyOption": "MailOnFailure"
},
"configuredBy": [
"john@contoso.com"
]
}
]
}
Get refreshables with their 'capacity' and 'group' expanded example
Esempio di richiesta
GET https://api.powerbi.com/v1.0/myorg/admin/capacities/refreshables?$expand=capacity,group
Risposta di esempio
{
"value": [
{
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"name": "SalesMarketing",
"kind": "Dataset",
"startTime": "2017-06-13T09:25:43.153Z",
"endTime": "2017-06-19T11:22:32.445Z",
"refreshCount": 22,
"refreshFailures": 0,
"averageDuration": 289.3814,
"medianDuration": 268.6245,
"refreshesPerDay": 11,
"lastRefresh": {
"refreshType": "ViaApi",
"startTime": "2017-06-13T09:25:43.153Z",
"endTime": "2017-06-13T09:31:43.153Z",
"status": "Completed",
"requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1"
},
"refreshSchedule": {
"days": [
"Sunday",
"Friday",
"Saturday"
],
"times": [
"05:00",
"11:30",
"17:30",
"23:00"
],
"enabled": true,
"localTimeZoneId": "UTC",
"notifyOption": "MailOnFailure"
},
"configuredBy": [
"john@contoso.com"
],
"capacity": {
"id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
"displayName": "MyCapacity",
"sku": "A1"
},
"group": {
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"name": "SalesMarketing"
}
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Capacity |
Una capacità di Power BI |
Capacity |
Stato della capacità |
capacity |
Diritto di accesso che l'utente ha sulla capacità |
days |
Giorni in cui eseguire l'aggiornamento |
Refresh |
Voce della cronologia degli aggiornamenti di Power BI |
Refreshable |
Un aggiornamento di Power BI è un set di dati aggiornato almeno una volta o per il quale esiste una pianificazione di aggiornamento valida. Se un set di dati non soddisfa una di queste condizioni, non verrà visualizzato nella risposta dell'API. Power BI mantiene una cronologia di aggiornamento di sette giorni per ogni set di dati, fino a un massimo di sessanta aggiornamenti. |
Refreshable |
Gruppo di Power BI associato a un elemento aggiornabile |
Refreshable |
Tipo aggiornabile |
Refreshables |
Elenco aggiornabili di Power BI |
Refresh |
Power BI esegue automaticamente più tentativi di aggiornamento di un set di dati se si verifica un errore di aggiornamento. Questo oggetto contiene informazioni su ogni tentativo di aggiornamento. |
Refresh |
Tipo di tentativo di aggiornamento. |
Refresh |
Pianificazione dell'aggiornamento di Power BI per modello importato |
Refresh |
Tipo di richiesta di aggiornamento |
Schedule |
Opzione di notifica alla chiusura di un aggiornamento pianificato. Le entità servizio supportano solo il valore |
Tenant |
Informazioni sulla chiave di crittografia |
Capacity
Una capacità di Power BI
Nome | Tipo | Descrizione |
---|---|---|
admins |
string[] |
Matrice di amministratori della capacità |
capacityUserAccessRight |
Diritto di accesso che un utente ha sulla capacità |
|
displayName |
string |
Nome visualizzato della capacità |
id |
string |
ID capacità |
region |
string |
Area di Azure in cui è stato effettuato il provisioning della capacità |
sku |
string |
SKU della capacità |
state |
Stato della capacità |
|
tenantKey |
Informazioni sulla chiave di crittografia (si applica solo alle route di amministrazione) |
|
tenantKeyId |
string |
ID di una chiave di crittografia (applicabile solo alla route dell'amministratore) |
CapacityState
Stato della capacità
Nome | Tipo | Descrizione |
---|---|---|
Active |
string |
La capacità è pronta per l'uso |
Deleted |
string |
La capacità è stata eliminata e non è disponibile |
Deleting |
string |
L'eliminazione della capacità è in corso |
Invalid |
string |
Non è possibile usare la capacità |
NotActivated |
string |
Non confermato |
PreSuspended |
string |
Non confermato |
ProvisionFailed |
string |
Provisioning della capacità non riuscita |
Provisioning |
string |
L'attivazione della capacità è in corso |
Suspended |
string |
L'uso della capacità è sospeso |
UpdatingSku |
string |
È in corso una modifica dello SKU della capacità |
capacityUserAccessRight
Diritto di accesso che l'utente ha sulla capacità
Nome | Tipo | Descrizione |
---|---|---|
Admin |
string |
L'utente dispone dei diritti di amministratore per la capacità |
Assign |
string |
L'utente ha diritti di collaboratore e può assegnare aree di lavoro alla capacità |
None |
string |
L'utente non ha accesso alla capacità |
days
Giorni in cui eseguire l'aggiornamento
Nome | Tipo | Descrizione |
---|---|---|
Friday |
string |
|
Monday |
string |
|
Saturday |
string |
|
Sunday |
string |
|
Thursday |
string |
|
Tuesday |
string |
|
Wednesday |
string |
Refresh
Voce della cronologia degli aggiornamenti di Power BI
Nome | Tipo | Descrizione |
---|---|---|
endTime |
string |
Data e ora di fine dell'aggiornamento (può essere vuota se è in corso un aggiornamento) |
refreshAttempts |
Elenco di tentativi di aggiornamento. |
|
refreshType |
Tipo di richiesta di aggiornamento |
|
requestId |
string |
Identificatore della richiesta di aggiornamento. Specificare questo identificatore in tutte le richieste di servizio. |
serviceExceptionJson |
string |
Codice errore errore in formato JSON (vuoto se non viene visualizzato alcun errore) |
startTime |
string |
Data e ora di inizio dell'aggiornamento |
status |
string |
|
Refreshable
Un aggiornamento di Power BI è un set di dati aggiornato almeno una volta o per il quale esiste una pianificazione di aggiornamento valida. Se un set di dati non soddisfa una di queste condizioni, non verrà visualizzato nella risposta dell'API. Power BI mantiene una cronologia di aggiornamento di sette giorni per ogni set di dati, fino a un massimo di sessanta aggiornamenti.
Nome | Tipo | Descrizione |
---|---|---|
averageDuration |
number |
Durata media in secondi di un aggiornamento durante l'intervallo di tempo per cui sono presenti i dati di aggiornamento |
capacity |
Capacità per l'elemento aggiornabile |
|
configuredBy |
string[] |
Proprietari aggiornabili |
endTime |
string |
Ora di fine della finestra per cui sono presenti i dati di aggiornamento |
group |
Gruppo associato per l'elemento aggiornabile |
|
id |
string |
ID oggetto dell'oggetto aggiornabile |
kind |
Tipo aggiornabile |
|
lastRefresh |
Ultima voce della cronologia degli aggiornamenti di Power BI per l'elemento aggiornabile |
|
medianDuration |
number |
Durata media in secondi di un aggiornamento entro l'intervallo di tempo per cui sono presenti i dati di aggiornamento |
name |
string |
Nome visualizzato dell'oggetto aggiornabile |
refreshCount |
integer |
Numero di aggiornamenti entro l'intervallo di tempo per il quale sono presenti i dati di aggiornamento |
refreshFailures |
integer |
Numero di errori di aggiornamento entro l'intervallo di tempo per il quale sono presenti i dati di aggiornamento |
refreshSchedule |
Pianificazione dell'aggiornamento per l'elemento aggiornabile |
|
refreshesPerDay |
integer |
Numero di aggiornamenti al giorno (pianificati e su richiesta) entro l'intervallo di tempo per il quale sono presenti i dati di aggiornamento |
startTime |
string |
Ora di inizio della finestra per cui sono presenti i dati di aggiornamento |
RefreshableGroup
Gruppo di Power BI associato a un elemento aggiornabile
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID dell'area di lavoro |
name |
string |
Nome del gruppo |
RefreshableKind
Tipo aggiornabile
Nome | Tipo | Descrizione |
---|---|---|
Dataset |
string |
Dataset |
Refreshables
Elenco aggiornabili di Power BI
Nome | Tipo | Descrizione |
---|---|---|
odata.context |
string |
Contesto OData |
value |
Gli aggiornamenti |
RefreshAttempt
Power BI esegue automaticamente più tentativi di aggiornamento di un set di dati se si verifica un errore di aggiornamento. Questo oggetto contiene informazioni su ogni tentativo di aggiornamento.
Nome | Tipo | Descrizione |
---|---|---|
attemptId |
integer |
Indice del tentativo di aggiornamento. |
endTime |
string |
Data e ora di fine del tentativo di aggiornamento. Il valore è void se il tentativo di aggiornamento è in corso. |
serviceExceptionJson |
string |
Codice errore errore in formato JSON. Void se non è presente alcun errore. |
startTime |
string |
Data e ora di inizio del tentativo di aggiornamento. |
type |
Tipo di tentativo di aggiornamento. |
RefreshAttemptType
Tipo di tentativo di aggiornamento.
Nome | Tipo | Descrizione |
---|---|---|
Data |
string |
Tentativo di aggiornamento di caricare i dati nel set di dati. |
Query |
string |
Tentativo di aggiornare le cache delle query Premium e i riquadri del dashboard.u |
RefreshSchedule
Pianificazione dell'aggiornamento di Power BI per modello importato
Nome | Tipo | Descrizione |
---|---|---|
NotifyOption |
Opzione di notifica alla chiusura di un aggiornamento pianificato. Le entità servizio supportano solo il valore |
|
days |
days[] |
Giorni in cui eseguire l'aggiornamento |
enabled |
boolean |
Indica se l'aggiornamento è abilitato |
localTimeZoneId |
string |
ID del fuso orario da utilizzare. Per altre informazioni, vedere informazioni sul fuso orario. |
times |
string[] |
Orari del giorno per l'esecuzione dell'aggiornamento |
RefreshType
Tipo di richiesta di aggiornamento
Nome | Tipo | Descrizione |
---|---|---|
OnDemand |
string |
L'aggiornamento è stato attivato in modo interattivo tramite il portale di Power BI |
OnDemandTraining |
string |
L'aggiornamento è stato attivato in modo interattivo tramite il portale di Power BI con training delle aggregazioni automatiche |
Scheduled |
string |
L'aggiornamento è stato attivato da un'impostazione di pianificazione dell'aggiornamento del set di dati |
ViaApi |
string |
L'aggiornamento è stato attivato da una chiamata API |
ViaEnhancedApi |
string |
L'aggiornamento è stato attivato da una chiamata all'API REST di aggiornamento avanzato |
ViaXmlaEndpoint |
string |
L'aggiornamento è stato attivato tramite l'endpoint XMLA pubblico di Power BI |
ScheduleNotifyOption
Opzione di notifica alla chiusura di un aggiornamento pianificato. Le entità servizio supportano solo il valore NoNotification
.
Nome | Tipo | Descrizione |
---|---|---|
MailOnFailure |
string |
Verrà inviata una notifica di posta elettronica in caso di errore di aggiornamento |
NoNotification |
string |
Non verrà inviata alcuna notifica |
TenantKey
Informazioni sulla chiave di crittografia
Nome | Tipo | Descrizione |
---|---|---|
createdAt |
string |
Data e ora di creazione della chiave di crittografia |
id |
string |
ID della chiave di crittografia |
isDefault |
boolean |
Indica se la chiave di crittografia è la chiave predefinita per l'intero tenant. Qualsiasi capacità appena creata eredita la chiave predefinita. |
keyVaultKeyIdentifier |
string |
URI che specifica in modo univoco la chiave di crittografia in Azure Key Vault |
name |
string |
Nome della chiave di crittografia |
updatedAt |
string |
Data e ora dell'ultimo aggiornamento della chiave di crittografia |