Admin - Add Power BI Encryption Key

Référence

Service:: Power BI REST APIs

Version d'API:: v1.0

Ajoute une clé de chiffrement pour les espaces de travail Power BI affectés à une capacité.

Autorisations

L’utilisateur doit être administrateur fabric.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Limitations

Maximum 600 requêtes par heure.

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

Corps de la demande

Nom	Type	Description
activate	boolean	Indique s’il faut activer des capacités inactivées et utiliser cette clé pour son chiffrement
isDefault	boolean	Indique si une 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 une clé de chiffrement dans Azure Key Vault
name	string	Nom de la clé de chiffrement

Réponses

Nom	Type	Description
200 OK	TenantKey	D’ACCORD

Exemples

Example

Exemple de requête

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

Corps de la demande

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

Exemple de réponse

Code d’état:: 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"
}

Définitions

Nom	Description
TenantKey	Informations sur la clé de chiffrement
TenantKeyCreationRequest	Ajouter une demande de clé de chiffrement

TenantKey

Informations sur la clé de chiffrement

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

TenantKeyCreationRequest

Ajouter une demande de clé de chiffrement

Nom	Type	Description
activate	boolean	Indique s’il faut activer des capacités inactivées et utiliser cette clé pour son chiffrement
isDefault	boolean	Indique si une 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 une clé de chiffrement dans Azure Key Vault
name	string	Nom de la clé de chiffrement

Partager via