Admin - Rotate Power BI Encryption Key

Référence

Service:: Power BI REST APIs

API Version:: v1.0

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

Autorisations

L’utilisateur doit disposer de droits d’administrateur (par exemple, Office 365 administrateur général ou administrateur de service Power BI).

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Limites

600 requêtes maximales par heure.

POST https://api.powerbi.com/v1.0/myorg/admin/tenantKeys/{tenantKeyId}/Default.Rotate

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
tenantKeyId	path	True	string uuid	ID de clé de locataire

Corps de la demande

Nom	Type	Description
keyVaultKeyIdentifier	string	URI qui spécifie de manière unique la clé de chiffrement dans Azure Key Vault

Réponses

Nom	Type	Description
200 OK	TenantKey	Ok

Exemples

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/tenantKeys/82d9a37a-2b45-4221-b012-cb109b8e30c7/Default.Rotate

Request Body

{
  "keyVaultKeyIdentifier": "https://contoso-vault2.vault.azure.net/keys/ContosoKeyVault/b2ab4ba1c7b341eea5ecaaa2wb54c4d2"
}

Sample Response

Status code:: 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
TenantKeyRotationRequest	Demande de rotation d’une 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

TenantKeyRotationRequest

Demande de rotation d’une clé de chiffrement

Nom	Type	Description
keyVaultKeyIdentifier	string	URI qui spécifie de manière unique la clé de chiffrement dans Azure Key Vault

Partager via