Capacities - Get Refreshables

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Vrátí seznam aktualizovatelných položek pro všechny kapacity, ke kterým má uživatel přístup.

Power BI uchovává pro každou datovou sadu sedmidenní historii aktualizací, maximálně 6 aktualizací.

Požadovaný obor

Capacity.Read.All nebo Capacity.ReadWrite.All

GET https://api.powerbi.com/v1.0/myorg/capacities/refreshables?$top={$top}

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/capacities/refreshables?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
$top	query	True	integer int32	Vrátí pouze prvních n výsledků.
$expand	query		string	Přijímá seznam datových typů oddělených čárkami, který se v odpovědi rozbalí. Podporuje `capacity` a `group`.
$filter	query		string	Filtruje výsledky na základě logické podmínky.
$skip	query		integer int32	Přeskočí prvních n výsledků. Pokud chcete načíst výsledky nad rámec prvních 1000, použijte s horní.

Odpovědi

Name	Typ	Description
200 OK	Refreshables	OK

Příklady

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

Sample Request

GET https://api.powerbi.com/v1.0/myorg/capacities/refreshables

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 refreshables, filtering for an average refresh duration of greater than 30 minutes example.

Sample Request

GET https://api.powerbi.com/v1.0/myorg/capacities/refreshables?$filter=averageDuration gt 1800

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

Sample Request

GET https://api.powerbi.com/v1.0/myorg/capacities/refreshables?$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"
      }
    }
  ]
}

Definice

Name	Description
Capacity	Kapacita Power BI
CapacityState	Stav kapacity
capacityUserAccessRight	Přístupové právo, které má uživatel k kapacitě
days	Dny, ve kterých se má aktualizace spustit
Refresh	Položka historie aktualizací Power BI
Refreshable	Aktualizovatelná datová sada Power BI je datová sada, která se alespoň jednou aktualizovala nebo pro kterou existuje platný plán aktualizace. Pokud datová sada nesplňuje některou z těchto podmínek, nezobrazí se v odpovědi rozhraní API. Power BI uchovává pro každou datovou sadu sedmidenní historii aktualizací, maximálně 6 aktualizací.
RefreshableGroup	Skupina Power BI přidružená k aktualizovatelné položce
RefreshableKind	Aktualizovatelný druh
Refreshables	Seznam aktualizovatelných položek Power BI
RefreshAttempt	Power BI automaticky provede několik pokusů o aktualizaci datové sady, pokud dojde k selhání aktualizace. Tento objekt obsahuje informace o každém pokusu o aktualizaci.
RefreshAttemptType	Typ pokusu o aktualizaci.
RefreshSchedule	Plán aktualizace Power BI pro importovaný model
RefreshType	Typ žádosti o aktualizaci
ScheduleNotifyOption	Možnost oznámení o ukončení plánované aktualizace Instanční objekty podporují `NoNotification` pouze hodnotu.
TenantKey	Informace o šifrovacím klíči

Capacity

Kapacita Power BI

Name	Typ	Description
admins	string[]	Pole správců kapacity
capacityUserAccessRight	capacityUserAccessRight	Přístupové právo, které má uživatel ke kapacitě
displayName	string	Zobrazovaný název kapacity
id	string	ID kapacity
region	string	Oblast Azure, ve které byla kapacita zřízena
sku	string	Skladová položka kapacity
state	CapacityState	Stav kapacity
tenantKey	TenantKey	Informace o šifrovacím klíči (platí jenom pro trasy pro správce)
tenantKeyId	string	ID šifrovacího klíče (platí jenom pro trasu správce)

CapacityState

Stav kapacity

Name	Typ	Description
Active	string	Kapacita je připravená k použití
Deleted	string	Kapacita se odstranila a není k dispozici.
Deleting	string	Probíhá odstraňování kapacity
Invalid	string	Kapacitu nejde použít
NotActivated	string	Nepodporované
PreSuspended	string	Nepodporované
ProvisionFailed	string	Zřizování kapacity se nezdařilo.
Provisioning	string	Probíhá aktivace kapacity
Suspended	string	Využití kapacity je pozastaveno.
UpdatingSku	string	Probíhá změna skladové položky kapacity

capacityUserAccessRight

Přístupové právo, které má uživatel k kapacitě

Name	Typ	Description
Admin	string	Uživatel má oprávnění správce ke kapacitě.
Assign	string	Uživatel má práva přispěvatele a může ke kapacitě přiřadit pracovní prostory.
None	string	Uživatel nemá přístup ke kapacitě.

days

Dny, ve kterých se má aktualizace spustit

Name	Typ	Description
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

Refresh

Položka historie aktualizací Power BI

Name	Typ	Description
endTime	string	Koncové datum a čas aktualizace (pokud probíhá aktualizace, může být prázdné)
refreshAttempts	RefreshAttempt[]	Seznam pokusů o aktualizaci.
refreshType	RefreshType	Typ žádosti o aktualizaci
requestId	string	Identifikátor žádosti o aktualizaci. Zadejte tento identifikátor ve všech žádostech o služby.
serviceExceptionJson	string	Kód chyby selhání ve formátu JSON (prázdný, pokud žádná chyba není)
startTime	string	Počáteční datum a čas aktualizace
status	string	`Unknown` pokud je stav dokončení neznámý nebo probíhá aktualizace. `Completed` pro úspěšně dokončenou aktualizaci. `Failed` pro neúspěšnou aktualizaci (`serviceExceptionJson` bude obsahovat kód chyby). `Disabled` pokud je aktualizace zakázaná selektivní aktualizací.

Refreshable

Aktualizovatelná datová sada Power BI je datová sada, která se alespoň jednou aktualizovala nebo pro kterou existuje platný plán aktualizace. Pokud datová sada nesplňuje některou z těchto podmínek, nezobrazí se v odpovědi rozhraní API. Power BI uchovává pro každou datovou sadu sedmidenní historii aktualizací, maximálně 6 aktualizací.

Name	Typ	Description
averageDuration	number	Průměrná doba trvání aktualizace v sekundách během časového období, pro které existují data aktualizace
capacity	Capacity	Kapacita aktualizovatelné položky
configuredBy	string[]	Aktualizovatelné vlastníky
endTime	string	Koncový čas okna, pro které existují data aktualizace
group	RefreshableGroup	Přidružená skupina pro aktualizovatelnou položku
id	string	ID objektu aktualizovatelného objektu
kind	RefreshableKind	Aktualizovatelný druh
lastRefresh	Refresh	Poslední položka historie aktualizací Power BI pro aktualizovatelnou položku
medianDuration	number	Medián doby trvání aktualizace v sekundách v časovém intervalu, pro který existují data aktualizace
name	string	Zobrazovaný název aktualizovatelného
refreshCount	integer	Počet aktualizací v časovém intervalu, pro které existují data aktualizace
refreshFailures	integer	Počet selhání aktualizace v časovém intervalu, pro který existují data aktualizace
refreshSchedule	RefreshSchedule	Plán aktualizace pro aktualizovatelnou položku
refreshesPerDay	integer	Počet aktualizací za den (naplánovaných a na vyžádání) v časovém intervalu, pro který existují data aktualizace
startTime	string	Čas spuštění okna, pro které existují data aktualizace

RefreshableGroup

Skupina Power BI přidružená k aktualizovatelné položce

Name	Typ	Description
id	string	ID pracovního prostoru
name	string	Název skupiny

RefreshableKind

Aktualizovatelný druh

Name	Typ	Description
Dataset	string	Datová sada

Refreshables

Seznam aktualizovatelných položek Power BI

Name	Typ	Description
odata.context	string	Kontext OData
value	Refreshable[]	Aktualizovatelné

RefreshAttempt

Power BI automaticky provede několik pokusů o aktualizaci datové sady, pokud dojde k selhání aktualizace. Tento objekt obsahuje informace o každém pokusu o aktualizaci.

Name	Typ	Description
attemptId	integer	Index pokusu o aktualizaci.
endTime	string	Koncové datum a čas pokusu o aktualizaci. Pokud probíhá pokus o aktualizaci, hodnota je neplatná.
serviceExceptionJson	string	Kód chyby selhání ve formátu JSON V případě, že nedojde k žádné chybě, je neplatná.
startTime	string	Počáteční datum a čas pokusu o aktualizaci.
type	RefreshAttemptType	Typ pokusu o aktualizaci.

RefreshAttemptType

Typ pokusu o aktualizaci.

Name	Typ	Description
Data	string	Aktualizace se pokusí načíst data do datové sady.
Query	string	Pokus o aktualizaci mezipaměti dotazů Premium a dlaždic řídicího panelu.u

RefreshSchedule

Plán aktualizace Power BI pro importovaný model

Name	Typ	Description
NotifyOption	ScheduleNotifyOption	Možnost oznámení o ukončení plánované aktualizace Instanční objekty podporují `NoNotification` pouze hodnotu.
days	days[]	Dny, ve kterých se má aktualizace spustit
enabled	boolean	Jestli je aktualizace povolená
localTimeZoneId	string	ID časového pásma, které se má použít. Další informace najdete v tématu Informace o časovém pásmu.
times	string[]	Denní časy, kdy se má aktualizace provést

RefreshType

Typ žádosti o aktualizaci

Name	Typ	Description
OnDemand	string	Aktualizace se aktivovala interaktivně prostřednictvím portálu Power BI.
OnDemandTraining	string	Aktualizace se aktivovala interaktivně prostřednictvím portálu Power BI s trénováním automatických agregací.
Scheduled	string	Aktualizace se aktivovala nastavením plánu aktualizace datové sady.
ViaApi	string	Aktualizace se aktivovala voláním rozhraní API.
ViaEnhancedApi	string	Aktualizace se aktivovala voláním rozhraní REST API rozšířené aktualizace.
ViaXmlaEndpoint	string	Aktualizace se aktivovala prostřednictvím veřejného koncového bodu XMLA Power BI.

ScheduleNotifyOption

Možnost oznámení o ukončení plánované aktualizace Instanční objekty podporují NoNotification pouze hodnotu.

Name	Typ	Description
MailOnFailure	string	Při selhání aktualizace se odešle e-mailové oznámení.
NoNotification	string	Žádné oznámení se nepošlou.

TenantKey

Informace o šifrovacím klíči

Name	Typ	Description
createdAt	string	Datum a čas vytvoření šifrovacího klíče
id	string	ID šifrovacího klíče
isDefault	boolean	Určuje, jestli je šifrovací klíč výchozím klíčem pro celého tenanta. Výchozí klíč zdědí každá nově vytvořená kapacita.
keyVaultKeyIdentifier	string	Identifikátor URI, který jednoznačně určuje šifrovací klíč v Azure Key Vault
name	string	Název šifrovacího klíče
updatedAt	string	Datum a čas poslední aktualizace šifrovacího klíče

Sdílet prostřednictvím

Capacities - Get Refreshables

Požadovaný obor

Parametry identifikátoru URI

Odpovědi

Příklady

Example

Sample Request

Sample Response

Get refreshables, filtering for an average refresh duration of greater than 30 minutes example.

Sample Request

Sample Response

Get refreshables with their 'capacity' and 'group' expanded example

Sample Request

Sample Response

Definice

Capacity

CapacityState

capacityUserAccessRight

days

Refresh

Refreshable

RefreshableGroup

RefreshableKind

Refreshables

RefreshAttempt

RefreshAttemptType

RefreshSchedule

RefreshType

ScheduleNotifyOption

TenantKey

Další materiály