Capacities - Get Capacities

Service:

Power BI REST APIs

API Version:

v1.0

Restituisce un elenco di capacità a cui l'utente può accedere.

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: Profili dell'entità servizio in Power BI Embedded. L'autore del profilo deve disporre delle autorizzazioni di capacità.

Ambito obbligatorio

Capacity.Read.All o Capacity.ReadWrite.All

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

Risposte

Nome	Tipo	Descrizione
200 OK	Capacities	OK

Esempio

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

Definizioni

Nome	Descrizione
Capacities	Wrapper di risposta OData per un elenco di capacità di Power BI
Capacity	Capacità di Power BI
CapacityState	Stato della capacità
capacityUserAccessRight	Diritto di accesso che l'utente ha sulla capacità
TenantKey	Informazioni sulla chiave di crittografia

Capacities

Wrapper di risposta OData per un elenco di capacità di Power BI

Nome	Tipo	Descrizione
odata.context	string
value	Capacity[]	Elenco di capacità

Capacity

Capacità di Power BI

Nome	Tipo	Descrizione
admins	string[]	Matrice di amministratori della capacità
capacityUserAccessRight	capacityUserAccessRight	Il diritto di accesso di un utente ha la capacità
displayName	string	Nome visualizzato della capacità
id	string	ID capacità
region	string	Area di Azure in cui è stato effettuato il provisioning della capacità
sku	string	SKU di capacità
state	CapacityState	Stato della capacità
tenantKey	TenantKey	Informazioni sulla chiave di crittografia (si applica solo alle route di amministrazione)
tenantKeyId	string	ID di una chiave di crittografia (applicabile solo alla route di amministrazione)

CapacityState

Stato della capacità

Nome	Tipo	Descrizione
Active	string	La capacità è pronta per l'uso
Deleted	string	La capacità è stata eliminata e non è disponibile
Deleting	string	L'eliminazione della capacità è in corso
Invalid	string	La capacità non può essere usata
NotActivated	string	Non supportato
PreSuspended	string	Non supportato
ProvisionFailed	string	Provisioning della capacità non riuscita
Provisioning	string	L'attivazione della capacità è in corso
Suspended	string	L'uso della capacità viene sospeso
UpdatingSku	string	Una modifica dello SKU della capacità è in corso

capacityUserAccessRight

Diritto di accesso che l'utente ha sulla capacità

Nome	Tipo	Descrizione
Admin	string	L'utente ha diritti di amministratore sulla capacità
Assign	string	L'utente ha diritti di collaboratore e può assegnare aree di lavoro alla capacità
None	string	L'utente non ha accesso alla capacità

TenantKey

Informazioni sulla chiave di crittografia

Nome	Tipo	Descrizione
createdAt	string	Data e ora di creazione della chiave di crittografia
id	string	ID della chiave di crittografia
isDefault	boolean	Se la chiave di crittografia è la chiave predefinita per l'intero tenant. Qualsiasi capacità appena creata eredita la chiave predefinita.
keyVaultKeyIdentifier	string	URI che specifica in modo univoco la chiave di crittografia in Azure Key Vault
name	string	Nome della chiave di crittografia
updatedAt	string	Data e ora dell'ultimo aggiornamento della chiave di crittografia