Capacities - Get Capacities

Service:

Power BI REST APIs

API Version:

v1.0

Gibt eine Liste der Kapazitäten zurück, auf die der Benutzer Zugriff hat.

Berechtigungen

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter: Dienstprinzipalprofile in Power BI Embedded. Der Profilersteller muss über Kapazitätsberechtigungen verfügen.

Erforderlicher Bereich

Capacity.Read.All oder Capacity.ReadWrite.All

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

Antworten

Name	Typ	Beschreibung
200 OK	Capacities	OK

Beispiele

Example

Sample Request

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

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "displayName": "MyCapacity",
      "admins": [
        "john@contoso.com"
      ],
      "sku": "A1",
      "state": "Active",
      "region": "West Central US",
      "capacityUserAccessRight": "Admin"
    }
  ]
}

Definitionen

Name	Beschreibung
Capacities	OData-Antwortwrapper für eine Power BI-Kapazitätsliste
Capacity	Eine Power BI-Kapazität
CapacityState	Der Kapazitätsstatus
capacityUserAccessRight	Der Zugriffsrecht, über den der Benutzer über die Kapazität verfügt
TenantKey	Verschlüsselungsschlüsselinformationen

Capacities

OData-Antwortwrapper für eine Power BI-Kapazitätsliste

Name	Typ	Beschreibung
odata.context	string
value	Capacity[]	Die Kapazitätsliste

Capacity

Eine 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	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	Die ID eines Verschlüsselungsschlüssels (gilt nur für die Administratorroute)

CapacityState

Der Kapazitätsstatus

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

capacityUserAccessRight

Der Zugriffsrecht, über den der Benutzer über die Kapazität verfügt

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

TenantKey

Verschlüsselungsschlüsselinformationen

Name	Typ	Beschreibung
createdAt	string	Das Erstellungsdatum und die Uhrzeit des Verschlüsselungsschlüssels
id	string	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 in Azure Key Vault eindeutig angibt
name	string	Der Name des Verschlüsselungsschlüssels
updatedAt	string	Datum und Uhrzeit der letzten Aktualisierung des Verschlüsselungsschlüssels