Admin - Get Capacities As Admin
Restituisce un elenco di capacità per l'organizzazione.
Autorizzazioni
- L'utente deve avere diritti di amministratore, ad esempio Office 365 amministratore globale o amministratore del servizio Power BI, oppure eseguire l'autenticazione usando un'entità servizio.
- Le autorizzazioni delegate sono supportate.
Quando è in esecuzione nell'autenticazione prinicipal del servizio, un'app non deve disporre di premissioni necessarie per il consenso amministratore per Power BI impostata nel portale di Azure.
Ambito obbligatorio
Tenant.Read.All o Tenant.ReadWrite.All
Pertinente solo quando si esegue l'autenticazione tramite un token di accesso amministratore delegato standard. Non deve essere presente quando viene usata l'autenticazione tramite un'entità servizio.
GET https://api.powerbi.com/v1.0/myorg/admin/capacities
GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand={$expand}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
$expand
|
query |
string |
Espande le entità correlate inline |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
Esempio
Example |
Example with expand on tenant key |
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/capacities
Sample Response
{
"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
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand=tenantKey
Sample Response
{
"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"
}
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Capacities |
Wrapper di risposta OData per un elenco di capacità di Power BI |
Capacity |
Capacità di Power BI |
Capacity |
Stato della capacità |
capacity |
Diritto di accesso che l'utente ha sulla capacità |
Tenant |
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 |
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 |
Stato della capacità |
|
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 |