Capacities - Get Capacities

Service:

Power BI REST APIs

Version d'API:

v1.0

Retourne la liste des 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	D’ACCORD

Exemples

Example

Exemple de requête

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

Exemple de réponse

Code d’état:

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és Power BI
Capacity	Une capacité Power BI
CapacityState	État de la capacité
capacityUserAccessRight	Droit d’accès que l’utilisateur a sur la capacité
TenantKey	Informations sur la clé de chiffrement

Capacities

Object

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

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

Capacity

Object

Une capacité Power BI

Nom	Type	Description
admins	string[]	Tableau d’administrateurs de capacité
capacityUserAccessRight	capacityUserAccessRight	Le droit d’accès dont dispose un utilisateur sur la capacité
displayName	string	Nom complet de la capacité
id	string (uuid)	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 la capacité
tenantKey	TenantKey	Informations sur la clé de chiffrement (s’applique uniquement aux itinéraires d’administration)
tenantKeyId	string (uuid)	ID d’une clé de chiffrement (applicable uniquement à l’itinéraire administrateur)

CapacityState

Énumération

État de la capacité

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

capacityUserAccessRight

Énumération

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

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

TenantKey

Object

Informations sur la clé de chiffrement

Nom	Type	Description
createdAt	string (date-time)	Date et heure de création de la clé de chiffrement
id	string (uuid)	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-time)	Date et heure de la dernière mise à jour de la clé de chiffrement