Admin - Get Capacities As Admin

Servizio:

Power BI REST APIs

Versione API:

v1.0

Restituisce un elenco di capacità per l'organizzazione.

Autorizzazioni

• L'utente deve essere un amministratore di Fabric o eseguire l'autenticazione usando un'entità servizio.
• Le autorizzazioni delegate sono supportate.

Durante l'esecuzione con l'autenticazione priniciale del servizio, un'app non deve avere premissioni necessarie per il consenso amministratore per Power BI impostate nel portale di Azure.

Ambito obbligatorio

Tenant.Read.All o Tenant.ReadWrite.All

Rilevante 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.

Limitazioni

Massimo 200 richieste all'ora.

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

Con parametri facoltativi:

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	Capacities	OK

Esempio

Example

Example with expand on tenant key

Example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Esempio di richiesta

GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand=tenantKey

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
Capacities	Wrapper di risposta OData per un elenco di capacità di Power BI
Capacity	Una 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

Una capacità di Power BI

Nome	Tipo	Descrizione
admins	string[]	Matrice di amministratori della capacità
capacityUserAccessRight	capacityUserAccessRight	Diritto di accesso che un utente ha sulla 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 della 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 dell'amministratore)

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	Non è possibile usare la capacità
NotActivated	string	Non confermato
PreSuspended	string	Non confermato
ProvisionFailed	string	Provisioning della capacità non riuscita
Provisioning	string	L'attivazione della capacità è in corso
Suspended	string	L'uso della capacità è sospeso
UpdatingSku	string	È in corso una modifica dello SKU della capacità

capacityUserAccessRight

Diritto di accesso che l'utente ha sulla capacità

Nome	Tipo	Descrizione
Admin	string	L'utente dispone dei diritti di amministratore per la 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	Indica 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