Capacities - Get Capacities

Service:

Power BI REST APIs

API Version:

v1.0

Retourne une liste de capacités auxquelles l’utilisateur a accès.

Autorisations

Cet appel d’API peut être appelé par un profil de principal de service. Pour plus d’informations, consultez : Profils de principal de service dans Power BI Embedded. Le créateur de profil doit disposer d’autorisations de capacité.

Étendue requise

Capacity.Read.All ou Capacity.ReadWrite.All

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

Réponses

Nom	Type	Description
200 OK	Capacities	Ok

Exemples

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"
    }
  ]
}

Définitions

Nom	Description
Capacities	Wrapper de réponse OData pour une liste de capacité Power BI
Capacity	Capacité Power BI
CapacityState	État de capacité
capacityUserAccessRight	Droit d’accès que l’utilisateur a sur la capacité
TenantKey	Informations sur la clé de chiffrement

Capacities

Wrapper de réponse OData pour une liste de capacité Power BI

Nom	Type	Description
odata.context	string
value	Capacity[]	Liste des capacités

Capacity

Capacité Power BI

Nom	Type	Description
admins	string[]	Tableau d’administrateurs de capacité
capacityUserAccessRight	capacityUserAccessRight	Le droit d’accès qu’un utilisateur a sur la capacité
displayName	string	Nom complet de la capacité
id	string	ID de capacité
region	string	Région Azure où la capacité a été provisionnée
sku	string	Référence SKU de capacité
state	CapacityState	État de capacité
tenantKey	TenantKey	Informations sur la clé de chiffrement (s’applique uniquement aux itinéraires d’administration)
tenantKeyId	string	ID d’une clé de chiffrement (applicable uniquement à l’itinéraire administrateur)

CapacityState

État de capacité

Nom	Type	Description
Active	string	La capacité est prête à être utilisée
Deleted	string	La capacité a été supprimée et n’est pas disponible
Deleting	string	La suppression de la capacité est en cours
Invalid	string	La capacité ne peut pas être utilisée
NotActivated	string	Non pris en charge
PreSuspended	string	Non pris en charge
ProvisionFailed	string	Échec de l’approvisionnement de la capacité
Provisioning	string	L’activation de la capacité est en cours
Suspended	string	L’utilisation de la capacité est suspendue
UpdatingSku	string	Une modification de la référence SKU de capacité est en cours

capacityUserAccessRight

Droit d’accès que l’utilisateur a sur la capacité

Nom	Type	Description
Admin	string	L’utilisateur dispose de droits d’administrateur sur la capacité
Assign	string	L’utilisateur a des droits de contributeur et peut affecter des espaces de travail à la capacité
None	string	L’utilisateur n’a pas accès à la capacité

TenantKey

Informations sur la clé de chiffrement

Nom	Type	Description
createdAt	string	Date et heure de création de la clé de chiffrement
id	string	ID de la clé de chiffrement
isDefault	boolean	Indique si la clé de chiffrement est la clé par défaut pour l’ensemble du locataire. Toute capacité nouvellement créée hérite de la clé par défaut.
keyVaultKeyIdentifier	string	URI qui spécifie de manière unique la clé de chiffrement dans Azure Key Vault
name	string	Nom de la clé de chiffrement
updatedAt	string	Date et heure de la dernière mise à jour de la clé de chiffrement