Admin - Get Capacities As Admin

Dienst:

Power BI REST APIs

API-Version:

v1.0

Gibt eine Liste der Kapazitäten für die Organisation zurück.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
$expand	query		string	Erweitert verwandte Entitäten inline

Antworten

Name	Typ	Beschreibung
200 OK	Capacities	OKAY

Beispiele

Example

Example with expand on tenant key

Example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

200

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

Example with expand on tenant key

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand=tenantKey

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "displayName": "MyCapacity",
      "admins": [
        "john@contoso.com"
      ],
      "sku": "A1",
      "state": "Active",
      "region": "West Central US",
      "capacityUserAccessRight": "Admin",
      "tenantKeyId": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
      "tenantKey": {
        "id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
        "name": "Contoso Sales",
        "keyVaultKeyIdentifier": "https://contoso-vault2.vault.azure.net/keys/ContosoKeyVault/b2ab4ba1c7b341eea5ecaaa2wb54c4d2",
        "isDefault": true,
        "createdAt": "2019-04-30T21:35:15.867-07:00",
        "updatedAt": "2019-04-30T21:35:15.867-07:00"
      }
    }
  ]
}

Definitionen

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

Capacities

Object

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

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

Capacity

Object

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

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.

TenantKey

Object

Verschlüsselungsschlüsselinformationen

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