Admin - Add Power BI Encryption Key

Riferimento

Servizio:: Power BI REST APIs

Versione API:: v1.0

Aggiunge una chiave di crittografia per le aree di lavoro di Power BI assegnate a una capacità.

Autorizzazioni

L'utente deve essere un amministratore di Fabric.

Ambito obbligatorio

Tenant.Read.All o Tenant.ReadWrite.All

Limitazioni

Massimo 600 richieste all'ora.

POST https://api.powerbi.com/v1.0/myorg/admin/tenantKeys

Corpo della richiesta

Nome	Tipo	Descrizione
activate	boolean	Se attivare le capacità inattive e usare questa chiave per la crittografia
isDefault	boolean	Indica se una 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 una chiave di crittografia in Azure Key Vault
name	string	Nome della chiave di crittografia

Risposte

Nome	Tipo	Descrizione
200 OK	TenantKey	OK

Esempio

Example

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/admin/tenantKeys

Corpo della richiesta

{
  "name": "Contoso Sales",
  "keyVaultKeyIdentifier": "https://contoso-vault2.vault.azure.net/keys/ContosoKeyVault/b2ab4ba1c7b341eea5ecaaa2wb54c4d2",
  "activate": true,
  "isDefault": true
}

Risposta di esempio

Codice di stato:: 200

{
  "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
TenantKey	Informazioni sulla chiave di crittografia
TenantKeyCreationRequest	Aggiungere una richiesta di chiave di crittografia

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

TenantKeyCreationRequest

Aggiungere una richiesta di chiave di crittografia

Nome	Tipo	Descrizione
activate	boolean	Se attivare le capacità inattive e usare questa chiave per la crittografia
isDefault	boolean	Indica se una 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 una chiave di crittografia in Azure Key Vault
name	string	Nome della chiave di crittografia

Condividi tramite