Admin - Get Refreshable For Capacity

Referenz

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt die angegebene Aktualisierung für die angegebene Kapazität zurück, auf die der Benutzer Zugriff hat.

Power BI behält einen siebentägigen Aktualisierungsverlauf für jedes Dataset bei, bis zu maximal sechszig Aktualisierungen.

Erlaubnisse

Der Benutzer muss ein Fabric-Administrator sein oder sich mit einem Dienstprinzipal authentifizieren.
Delegierte Berechtigungen werden unterstützt.

Wenn eine App unter der dienst prinicipalen Authentifizierung ausgeführt wird, darf eine App keine erforderlichen Administratorzustimmungen für Power BI im Azure-Portal festlegen.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Relevant nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken. Darf nicht vorhanden sein, wenn die Authentifizierung über einen Dienstprinzipal verwendet wird.

Einschränkungen

Maximal 200 Anforderungen pro Stunde.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
capacityId	path	True	string (uuid)	Die Kapazitäts-ID
refreshableId	path	True	string	Die aktualisierbare ID
$expand	query		string	Akzeptiert eine durch Trennzeichen getrennte Liste von Datentypen, die inline in der Antwort erweitert wird. Unterstützt `capacities` und `groups`.

Antworten

Name	Typ	Beschreibung
200 OK	Refreshables	OKAY

Beispiele

Example

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

Example

Beispielanforderung

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

Beispiel für eine Antwort

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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 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"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
Capacity	Power BI-Kapazität
CapacityState	Der Kapazitätsstatus
capacityUserAccessRight	Das Zugriffsrecht, das der Benutzer über die Kapazität hat
days	Die Tage, an denen die Aktualisierung ausgeführt werden soll
Refresh	Ein Power BI-Aktualisierungsverlaufseintrag
Refreshable	Eine Power BI-Aktualisierung ist ein Dataset, das mindestens einmal aktualisiert wurde oder für das ein gültiger Aktualisierungszeitplan vorhanden ist. Wenn ein Dataset keine dieser Bedingungen erfüllt, wird es in der API-Antwort nicht angezeigt. Power BI behält einen siebentägigen Aktualisierungsverlauf für jedes Dataset bei, bis zu maximal sechszig Aktualisierungen.
RefreshableGroup	Eine Power BI-Gruppe, die einem aktualisierbaren Element zugeordnet ist
RefreshableKind	Die aktualisierbare Art
Refreshables	Eine Power BI-Aktualisierungsliste
RefreshAttempt	Power BI führt automatisch mehrere Versuche aus, ein Dataset zu aktualisieren, wenn ein Aktualisierungsfehler auftritt. Dieses Objekt enthält Informationen zu jedem Aktualisierungsversuch.
RefreshAttemptType	Der Typ des Aktualisierungsversuchs.
RefreshSchedule	Ein Power BI-Aktualisierungszeitplan für importierten Modell
RefreshType	Der Typ der Aktualisierungsanforderung
ScheduleNotifyOption	Die Benachrichtigungsoption beim Beenden einer geplanten Aktualisierung. Dienstprinzipale unterstützen nur den `NoNotification` Wert.
TenantKey	Verschlüsselungsschlüsselinformationen

Capacity

Objekt

Power BI-Kapazität

Name	Typ	Beschreibung
admins	string[]	Ein Array von Kapazitätsadministratoren
capacityUserAccessRight	capacityUserAccessRight	Das Zugriffsrecht, über das ein Benutzer verfügt, hat die Kapazität
displayName	string	Der Anzeigename der Kapazität
id	string (uuid)	Die Kapazitäts-ID
region	string	Die Azure-Region, in der die Kapazität bereitgestellt wurde
sku	string	Die Kapazitäts-SKU
state	CapacityState	Der Kapazitätsstatus
tenantKey	TenantKey	Verschlüsselungsschlüsselinformationen (gilt nur für Administratorrouten)
tenantKeyId	string (uuid)	Die ID eines Verschlüsselungsschlüssels (gilt nur für die Administratorroute)

CapacityState

Enumeration

Der Kapazitätsstatus

Wert	Beschreibung
Active	Die Kapazität ist einsatzbereit.
Deleted	Die Kapazität wurde gelöscht und ist nicht verfügbar.
Deleting	Das Löschen der Kapazität wird ausgeführt.
Invalid	Die Kapazität kann nicht verwendet werden.
NotActivated	Nicht unterstützt
PreSuspended	Nicht unterstützt
ProvisionFailed	Fehler bei der Bereitstellung der Kapazität
Provisioning	Die Aktivierung der Kapazität wird ausgeführt.
Suspended	Die Nutzung der Kapazität wird angehalten.
UpdatingSku	Eine Kapazitäts-SKU-Änderung wird ausgeführt

capacityUserAccessRight

Enumeration

Das Zugriffsrecht, das der Benutzer über die Kapazität hat

Wert	Beschreibung
Admin	Der Benutzer verfügt über Administratorrechte für die Kapazität
Assign	Der Benutzer verfügt über Mitwirkenderechte und kann Arbeitsbereiche der Kapazität zuweisen.
None	Der Benutzer hat keinen Zugriff auf die Kapazität.

days

Enumeration

Die Tage, an denen die Aktualisierung ausgeführt werden soll

Wert	Beschreibung
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

Refresh

Objekt

Ein Power BI-Aktualisierungsverlaufseintrag

Name	Typ	Beschreibung
endTime	string (date-time)	Das Enddatum und die Uhrzeit der Aktualisierung (kann leer sein, wenn eine Aktualisierung ausgeführt wird) im UTC-Format.
refreshAttempts	RefreshAttempt[]	Die Aktualisierungsversuchsliste.
refreshType	RefreshType	Der Typ der Aktualisierungsanforderung
requestId	string	Der Bezeichner der Aktualisierungsanforderung. Geben Sie diesen Bezeichner in allen Dienstanforderungen an.
serviceExceptionJson	string	Fehlerfehlercode im JSON-Format (leer, wenn kein Fehler)
startTime	string (date-time)	Das Startdatum und die Uhrzeit der Aktualisierung im UTC-Format.
status	string	`Unknown`, wenn der Abschlussstatus unbekannt ist oder eine Aktualisierung ausgeführt wird. `Completed` für eine erfolgreich abgeschlossene Aktualisierung. `Failed` für eine nicht erfolgreiche Aktualisierung (`serviceExceptionJson` enthält den Fehlercode). `Disabled`, wenn die Aktualisierung durch eine selektive Aktualisierung deaktiviert ist.

Refreshable

Objekt

Eine Power BI-Aktualisierung ist ein Dataset, das mindestens einmal aktualisiert wurde oder für das ein gültiger Aktualisierungszeitplan vorhanden ist. Wenn ein Dataset keine dieser Bedingungen erfüllt, wird es in der API-Antwort nicht angezeigt. Power BI behält einen siebentägigen Aktualisierungsverlauf für jedes Dataset bei, bis zu maximal sechszig Aktualisierungen.

Name	Typ	Beschreibung
averageDuration	number	Die durchschnittliche Dauer einer Aktualisierung innerhalb von Sekunden während des Zeitfensters, für das Aktualisierungsdaten vorhanden sind
capacity	Capacity	Die Kapazität für das aktualisierbare Element
configuredBy	string[]	Die aktualisierbaren Besitzer
endTime	string (date-time)	Die Endzeit des Fensters, für das Aktualisierungsdaten im UTC-Format vorhanden sind.
group	RefreshableGroup	Die zugeordnete Gruppe für das aktualisierbare Element
id	string	Die Objekt-ID der aktualisierbaren
kind	RefreshableKind	Die aktualisierbare Art
lastRefresh	Refresh	Der letzte Power BI-Aktualisierungsverlaufseintrag für das aktualisierbare Element
medianDuration	number	Die Mediandauer in Sekunden einer Aktualisierung innerhalb des Zeitfensters, für die Aktualisierungsdaten vorhanden sind
name	string	Der Anzeigename des aktualisierbaren
refreshCount	integer	Die Anzahl der Aktualisierungen innerhalb des Zeitfensters, für das Aktualisierungsdaten vorhanden sind
refreshFailures	integer	Die Anzahl der Aktualisierungsfehler innerhalb des Zeitfensters, für das Aktualisierungsdaten vorhanden sind
refreshSchedule	RefreshSchedule	Der Aktualisierungszeitplan für das aktualisierbare Element
refreshesPerDay	integer	Die Anzahl der Aktualisierungen pro Tag (geplant und bei Bedarf) innerhalb des Zeitfensters, für das Aktualisierungsdaten vorhanden sind
startTime	string (date-time)	Die Startzeit des Fensters, für das Aktualisierungsdaten im UTC-Format vorhanden sind.

RefreshableGroup

Objekt

Eine Power BI-Gruppe, die einem aktualisierbaren Element zugeordnet ist

Name	Typ	Beschreibung
id	string (uuid)	Die Arbeitsbereichs-ID
name	string	Der Gruppenname

RefreshableKind

Enumeration

Die aktualisierbare Art

Wert	Beschreibung
Dataset	Dataset

Refreshables

Objekt

Eine Power BI-Aktualisierungsliste

Name	Typ	Beschreibung
@odata.context	string	OData-Kontext
value	Refreshable[]	Die Aktualisierungen

RefreshAttempt

Objekt

Power BI führt automatisch mehrere Versuche aus, ein Dataset zu aktualisieren, wenn ein Aktualisierungsfehler auftritt. Dieses Objekt enthält Informationen zu jedem Aktualisierungsversuch.

Name	Typ	Beschreibung
attemptId	integer	Der Index des Aktualisierungsversuchs.
endTime	string (date-time)	Das Enddatum und die Uhrzeit des Aktualisierungsversuchs. Der Wert ist ungültig, wenn der Aktualisierungsversuch ausgeführt wird.
serviceExceptionJson	string	Fehlerfehlercode im JSON-Format. Ungültig, wenn kein Fehler auftritt.
startTime	string (date-time)	Das Startdatum und die Uhrzeit des Aktualisierungsversuchs.
type	RefreshAttemptType	Der Typ des Aktualisierungsversuchs.

RefreshAttemptType

Enumeration

Der Typ des Aktualisierungsversuchs.

Wert	Beschreibung
Data	Der Aktualisierungsversuch zum Laden von Daten in das Dataset.
Query	Der Versuch, Premium-Abfragecaches und Dashboardkacheln zu aktualisieren.u

RefreshSchedule

Objekt

Ein Power BI-Aktualisierungszeitplan für importierten Modell

Name	Typ	Beschreibung
days	days[]	Die Tage, an denen die Aktualisierung ausgeführt werden soll
enabled	boolean	Gibt an, ob die Aktualisierung aktiviert ist.
localTimeZoneId	string	Die ID der zu verwendenden Zeitzone. Weitere Informationen finden Sie unter Zeitzoneninformationen.
notifyOption	ScheduleNotifyOption	Die Benachrichtigungsoption beim Beenden einer geplanten Aktualisierung. Dienstprinzipale unterstützen nur den `NoNotification` Wert.
times	string[]	Die Tageszeiten, um die Aktualisierung auszuführen

RefreshType

Enumeration

Der Typ der Aktualisierungsanforderung

Wert	Beschreibung
OnDemand	Die Aktualisierung wurde interaktiv über das Power BI-Portal ausgelöst.
OnDemandTraining	Die Aktualisierung wurde interaktiv über das Power BI-Portal mit automatischen Aggregationsschulungen ausgelöst.
Scheduled	Die Aktualisierung wurde durch eine Einstellung für die Datensatzaktualisierung ausgelöst.
ViaApi	Die Aktualisierung wurde durch einen API-Aufruf ausgelöst.
ViaEnhancedApi	Die Aktualisierung wurde durch einen erweiterten Aktualisierungs-REST-API-Aufruf ausgelöst.
ViaXmlaEndpoint	Die Aktualisierung wurde über den öffentlichen XMLA-Endpunkt von Power BI ausgelöst.

ScheduleNotifyOption

Enumeration

Die Benachrichtigungsoption beim Beenden einer geplanten Aktualisierung. Dienstprinzipale unterstützen nur den NoNotification Wert.

Wert	Beschreibung
MailOnFailure	Beim Aktualisierungsfehler wird eine E-Mail-Benachrichtigung gesendet.
NoNotification	Es wird keine Benachrichtigung gesendet.

TenantKey

Objekt

Verschlüsselungsschlüsselinformationen

Name	Typ	Beschreibung
createdAt	string (date-time)	Erstellungsdatum und -uhrzeit des Verschlüsselungsschlüssels
id	string (uuid)	Die ID des Verschlüsselungsschlüssels
isDefault	boolean	Gibt an, ob der Verschlüsselungsschlüssel der Standardschlüssel für den gesamten Mandanten ist. Jede neu erstellte Kapazität erbt den Standardschlüssel.
keyVaultKeyIdentifier	string	Der URI, der den Verschlüsselungsschlüssel eindeutig im Azure Key Vault angibt
name	string	Der Name des Verschlüsselungsschlüssels
updatedAt	string (date-time)	Datum und Uhrzeit der letzten Aktualisierung des Verschlüsselungsschlüssels

Freigeben über

Admin - Get Refreshable For Capacity

Erlaubnisse

Erforderlicher Bereich

Einschränkungen

URI-Parameter

Antworten

Beispiele

Example

Beispielanforderung

Beispiel für eine Antwort

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

Beispielanforderung

Beispiel für eine Antwort

Definitionen

Capacity

CapacityState

capacityUserAccessRight

days

Refresh

Refreshable

RefreshableGroup

RefreshableKind

Refreshables

RefreshAttempt

RefreshAttemptType

RefreshSchedule

RefreshType

ScheduleNotifyOption

TenantKey

Zusätzliche Ressourcen