Freigeben über


Capacities - Get Capacities

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

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