Admin - Get Refreshable For Capacity

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Restituisce l'aggiornabile specificato per la capacità specificata a cui l'utente può accedere.

Power BI mantiene una cronologia degli aggiornamenti di sette giorni per ogni set di dati, fino a un massimo di sessanta aggiornamenti.

Autorizzazioni

L'utente deve disporre dei diritti di amministratore( ad esempio Office 365 amministratore globale o amministratore del servizio Power BI) o eseguire l'autenticazione tramite un'entità servizio.
Le autorizzazioni delegate sono supportate.

Quando viene eseguita 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.

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/refreshables/{refreshableId}

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/refreshables/{refreshableId}?$expand={$expand}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
capacityId	path	True	string uuid	ID della capacità
refreshableId	path	True	string	ID aggiornabile
$expand	query		string	Accetta un elenco delimitato da virgole di tipi di dati, che verranno espansi inline nella risposta. Supporta `capacities` e `groups`.

Risposte

Nome	Tipo	Descrizione
200 OK	Refreshables	OK

Esempio

Example

Get a refreshable with its 'capacity' and 'group' expanded example

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/refreshables/{refreshableId}

Sample Response

Status code:: 200

{
  "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 a refreshable with its 'capacity' and 'group' expanded example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/refreshables/{refreshableId}?$expand=capacity,group

Sample Response

Status code:: 200

{
  "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
CapacityState	Stato della capacità
capacityUserAccessRight	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 oggetto aggiornabile di Power BI è un set di dati che è stato aggiornato almeno una volta o per cui 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 degli aggiornamenti di sette giorni per ogni set di dati, fino a un massimo di sessanta aggiornamenti.
RefreshableGroup	Un gruppo di Power BI associato a un elemento aggiornabile
RefreshableKind	Tipo aggiornabile
Refreshables	Elenco di aggiornamenti di Power BI
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.
RefreshAttemptType	Tipo di tentativo di aggiornamento.
RefreshSchedule	Pianificazione dell'aggiornamento di Power BI per il modello importato
RefreshType	Tipo di richiesta di aggiornamento
ScheduleNotifyOption	Opzione di notifica alla chiusura di un aggiornamento pianificato. Le entità servizio supportano solo il `NoNotification` valore .
TenantKey	Informazioni sulla chiave di crittografia

Capacity

Una capacità di Power BI

Nome	Tipo	Descrizione
admins	string[]	Matrice di amministratori della capacità
capacityUserAccessRight	capacityUserAccessRight	Il diritto di accesso di un utente ha sulla capacità
displayName	string	Nome visualizzato della capacità
id	string	ID della capacità
region	string	Area di Azure in cui è stato effettuato il provisioning della capacità
sku	string	SKU della capacità
state	CapacityState	Stato della capacità
tenantKey	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 di amministrazione)

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 supportato
PreSuspended	string	Non supportato
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 dispone dei 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	RefreshAttempt[]	Elenco dei tentativi di aggiornamento.
refreshType	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 in formato JSON (vuoto se non viene visualizzato alcun errore)
startTime	string	Data e ora di inizio dell'aggiornamento
status	string	`Unknown` se lo stato di completamento è sconosciuto o è in corso un aggiornamento. `Completed` per un aggiornamento completato correttamente. `Failed` per un aggiornamento non riuscito (`serviceExceptionJson` conterrà il codice di errore). `Disabled` se l'aggiornamento è disabilitato da un aggiornamento selettivo.

Refreshable

Un oggetto aggiornabile di Power BI è un set di dati che è stato aggiornato almeno una volta o per cui 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 degli aggiornamenti 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 esistono i dati di aggiornamento
capacity	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	RefreshableGroup	Gruppo associato per l'elemento aggiornabile
id	string	ID oggetto dell'oggetto aggiornabile
kind	RefreshableKind	Tipo aggiornabile
lastRefresh	Refresh	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 il quale sono presenti i dati di aggiornamento
name	string	Nome visualizzato dell'oggetto aggiornabile
refreshCount	integer	Numero di aggiornamenti nell'intervallo di tempo per il quale sono presenti i dati di aggiornamento
refreshFailures	integer	Numero di errori di aggiornamento nell'intervallo di tempo per cui esistono i dati di aggiornamento
refreshSchedule	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 cui esistono i dati di aggiornamento
startTime	string	Ora di inizio della finestra per cui sono presenti i dati di aggiornamento

RefreshableGroup

Un gruppo di Power BI associato a un elemento aggiornabile

Nome	Tipo	Descrizione
id	string	ID area di lavoro
name	string	Nome del gruppo

RefreshableKind

Tipo aggiornabile

Nome	Tipo	Descrizione
Dataset	string	Set di dati

Refreshables

Elenco di aggiornamenti di Power BI

Nome	Tipo	Descrizione
odata.context	string	Contesto OData
value	Refreshable[]	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 di errore non riuscito in formato JSON. Void se non è presente alcun errore.
startTime	string	Data e ora di inizio del tentativo di aggiornamento.
type	RefreshAttemptType	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 il modello importato

Nome	Tipo	Descrizione
NotifyOption	ScheduleNotifyOption	Opzione di notifica alla chiusura di un aggiornamento pianificato. Le entità servizio supportano solo il `NoNotification` 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, vedi Informazioni sul fuso orario.
times	string[]	Orari del giorno in cui eseguire l'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 il training automatico delle aggregazioni
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 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 NoNotification valore .

Nome	Tipo	Descrizione
MailOnFailure	string	Una notifica di posta elettronica verrà inviata 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

Share via

Admin - Get Refreshable For Capacity

Autorizzazioni

Ambito obbligatorio

Parametri dell'URI

Risposte

Esempio

Example

Sample Request

Sample Response

Get a refreshable with its 'capacity' and 'group' expanded example

Sample Request

Sample Response

Definizioni

Capacity

CapacityState

capacityUserAccessRight

days

Refresh

Refreshable

RefreshableGroup

RefreshableKind

Refreshables

RefreshAttempt

RefreshAttemptType

RefreshSchedule

RefreshType

ScheduleNotifyOption

TenantKey

Risorse aggiuntive