Freigeben über

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

Objekt

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

Name Typ Beschreibung
@odata.context

string

value

Capacity[]

Die Kapazitätsliste

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
NotActivated

Nicht unterstützt
Active

Die Kapazität ist einsatzbereit.
Provisioning

Die Aktivierung der Kapazität wird ausgeführt.
ProvisionFailed

Fehler bei der Bereitstellung der Kapazität
PreSuspended

Nicht unterstützt
Suspended

Die Nutzung der Kapazität wird angehalten.
Deleting

Das Löschen der Kapazität wird ausgeführt.
Deleted

Die Kapazität wurde gelöscht und ist nicht verfügbar.
Invalid

Die Kapazität kann nicht verwendet werden.
UpdatingSku

Eine Kapazitäts-SKU-Änderung wird ausgeführt

capacityUserAccessRight

Enumeration

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

Wert Beschreibung
None

Der Benutzer hat keinen Zugriff auf die Kapazität.
Assign

Der Benutzer verfügt über Mitwirkenderechte und kann Arbeitsbereiche der Kapazität zuweisen.
Admin

Der Benutzer verfügt über Administratorrechte für die Kapazität

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