Admin - Add Power BI Encryption Key

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Přidá šifrovací klíč pro pracovní prostory Power BI přiřazené ke kapacitě.

Oprávnění

Uživatel musí mít práva správce (například Office 365 globálního správce nebo správce služby Power BI).

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Omezení

Maximálně 600 požadavků za hodinu.

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

Text požadavku

Name	Typ	Description
activate	boolean	Zda aktivovat jakékoli inaktivované kapacity a použít tento klíč pro jeho šifrování
isDefault	boolean	Určuje, jestli je šifrovací klíč výchozím klíčem pro celého tenanta. Všechny nově vytvořené kapacity dědí výchozí klíč.
keyVaultKeyIdentifier	string	Identifikátor URI, který jednoznačně určuje šifrovací klíč v Azure Key Vault
name	string	Název šifrovacího klíče

Odpovědi

Name	Typ	Description
200 OK	TenantKey	OK

Příklady

Example

Sample Request

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

Request Body

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

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

Definice

Name	Description
TenantKey	Informace o šifrovacím klíči
TenantKeyCreationRequest	Přidání žádosti o šifrovací klíč

TenantKey

Informace o šifrovacím klíči

Name	Typ	Description
createdAt	string	Datum a čas vytvoření šifrovacího klíče
id	string	ID šifrovacího klíče
isDefault	boolean	Určuje, jestli je šifrovací klíč výchozím klíčem pro celého tenanta. Všechny nově vytvořené kapacity dědí výchozí klíč.
keyVaultKeyIdentifier	string	Identifikátor URI, který jednoznačně určuje šifrovací klíč v Azure Key Vault
name	string	Název šifrovacího klíče
updatedAt	string	Datum a čas poslední aktualizace šifrovacího klíče

TenantKeyCreationRequest

Přidání žádosti o šifrovací klíč

Name	Typ	Description
activate	boolean	Zda aktivovat jakékoli inaktivované kapacity a použít tento klíč pro jeho šifrování
isDefault	boolean	Určuje, jestli je šifrovací klíč výchozím klíčem pro celého tenanta. Všechny nově vytvořené kapacity dědí výchozí klíč.
keyVaultKeyIdentifier	string	Identifikátor URI, který jednoznačně určuje šifrovací klíč v Azure Key Vault
name	string	Název šifrovacího klíče