Admin - Get Capacities As Admin
Gibt eine Liste der Kapazitäten für die Organisation zurück.
- 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
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.
Maximal 200 Anforderungen pro Stunde.
GET https://api.powerbi.com/v1.0/myorg/admin/capacities
GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand={$expand}
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
$expand
|
query |
string |
Erweitert verwandte Entitäten inline |
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OKAY |
Beispielanforderung
GET https://api.powerbi.com/v1.0/myorg/admin/capacities
Beispiel für eine Antwort
{
"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"
}
]
}
Beispielanforderung
GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand=tenantKey
Beispiel für eine Antwort
{
"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"
}
}
]
}
Name | Beschreibung |
---|---|
Capacities |
OData-Antwortwrapper für eine Power BI-Kapazitätsliste |
Capacity |
Power BI-Kapazität |
Capacity |
Der Kapazitätsstatus |
capacity |
Das Zugriffsrecht, das der Benutzer über die Kapazität hat |
Tenant |
Verschlüsselungsschlüsselinformationen |
OData-Antwortwrapper für eine Power BI-Kapazitätsliste
Name | Typ | Beschreibung |
---|---|---|
@odata.context |
string |
|
value |
Capacity[] |
Die Kapazitätsliste |
Power BI-Kapazität
Name | Typ | Beschreibung |
---|---|---|
admins |
string[] |
Ein Array von Kapazitätsadministratoren |
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 |
Der Kapazitätsstatus |
|
tenantKey |
Verschlüsselungsschlüsselinformationen (gilt nur für Administratorrouten) |
|
tenantKeyId |
string |
Die ID eines Verschlüsselungsschlüssels (gilt nur für die Administratorroute) |
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 |
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. |
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 |