Admin - Rotate Power BI Encryption Key

Dienst:: Power BI REST APIs

API-Version:: v1.0

Drehen Sie den Verschlüsselungsschlüssel für Power BI-Arbeitsbereiche, die einer Kapazität zugewiesen sind.

Erlaubnisse

Der Benutzer muss ein Fabric-Administrator sein.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Einschränkungen

Maximal 600 Anforderungen pro Stunde.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
tenantKeyId	path	True	string (uuid)	Die Mandantenschlüssel-ID

Anforderungstext

Name	Typ	Beschreibung
keyVaultKeyIdentifier	string	Der URI, der den Verschlüsselungsschlüssel eindeutig im Azure Key Vault angibt

Antworten

Name	Typ	Beschreibung
200 OK	TenantKey	OKAY

Beispiele

Example

Beispielanforderung

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

Anforderungstext

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

Beispiel für eine Antwort

Statuscode:: 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"
}

Definitionen

Name	Beschreibung
TenantKey	Verschlüsselungsschlüsselinformationen
TenantKeyRotationRequest	Eine Anforderung zum Drehen eines Verschlüsselungsschlüssels

TenantKey

Objekt

Verschlüsselungsschlüsselinformationen

Name	Typ	Beschreibung
createdAt	string (date-time)	Erstellungsdatum und -uhrzeit des Verschlüsselungsschlüssels
id	string (uuid)	Die ID des Verschlüsselungsschlüssels
isDefault	boolean	Gibt an, ob der Verschlüsselungsschlüssel der Standardschlüssel für den gesamten Mandanten ist. Jede neu erstellte Kapazität erbt den Standardschlüssel.
keyVaultKeyIdentifier	string	Der URI, der den Verschlüsselungsschlüssel eindeutig im Azure Key Vault angibt
name	string	Der Name des Verschlüsselungsschlüssels
updatedAt	string (date-time)	Datum und Uhrzeit der letzten Aktualisierung des Verschlüsselungsschlüssels

TenantKeyRotationRequest