Admin - Add Power BI Encryption Key

Referenz

Dienst:: Power BI REST APIs

API-Version:: v1.0

Fügt einen Verschlüsselungsschlüssel für Power BI-Arbeitsbereiche hinzu, die einer Kapazität zugewiesen sind.

Erlaubnisse

Der Benutzer muss ein Fabric-Administrator sein.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Begrenzungen

Maximal 600 Anforderungen pro Stunde.

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

Anforderungstext

Name	Typ	Beschreibung
activate	boolean	Gibt an, ob inaktivierte Kapazitäten aktiviert und dieser Schlüssel für die Verschlüsselung verwendet werden soll.
isDefault	boolean	Gibt an, ob ein 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 einen Verschlüsselungsschlüssel im Azure Key Vault eindeutig angibt
name	string	Der Name des Verschlüsselungsschlüssels

Antworten

Name	Typ	Beschreibung
200 OK	TenantKey	OKAY

Beispiele

Example

Beispielanforderung

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

Anforderungstext

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

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
TenantKeyCreationRequest	Hinzufügen einer Verschlüsselungsschlüsselanforderung

TenantKey

Verschlüsselungsschlüsselinformationen

Name	Typ	Beschreibung
createdAt	string	Erstellungsdatum und -uhrzeit des Verschlüsselungsschlüssels
id	string	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	Datum und Uhrzeit der letzten Aktualisierung des Verschlüsselungsschlüssels

TenantKeyCreationRequest

Hinzufügen einer Verschlüsselungsschlüsselanforderung

Name	Typ	Beschreibung
activate	boolean	Gibt an, ob inaktivierte Kapazitäten aktiviert und dieser Schlüssel für die Verschlüsselung verwendet werden soll.
isDefault	boolean	Gibt an, ob ein 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 einen Verschlüsselungsschlüssel im Azure Key Vault eindeutig angibt
name	string	Der Name des Verschlüsselungsschlüssels

Freigeben über