Admin - Add Power BI Encryption Key

Referência

Service:: Power BI REST APIs

API Version:: v1.0

Adiciona uma chave de criptografia para workspaces do Power BI atribuídos a uma capacidade.

Permissões

O usuário deve ter direitos de administrador (como Office 365 Administrador Global ou Administrador de Serviços do Power BI).

Escopo Necessário

Tenant.Read.All ou Tenant.ReadWrite.All

Limitações

Máximo de 600 solicitações por hora.

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

Corpo da solicitação

Nome	Tipo	Description
activate	boolean	Se você deve ativar quaisquer capacidades inativadas e usar essa chave para sua criptografia
isDefault	boolean	Se uma chave de criptografia é a chave padrão para todo o locatário. Qualquer capacidade recém-criada herda a chave padrão.
keyVaultKeyIdentifier	string	O URI que especifica exclusivamente uma chave de criptografia no Azure Key Vault
name	string	O nome da chave de criptografia

Respostas

Nome	Tipo	Description
200 OK	TenantKey	OK

Exemplos

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

Definições

Nome	Description
TenantKey	Informações de chave de criptografia
TenantKeyCreationRequest	Adicionar solicitação de chave de criptografia

TenantKey

Informações de chave de criptografia

Nome	Tipo	Description
createdAt	string	A data e a hora de criação da chave de criptografia
id	string	A ID da chave de criptografia
isDefault	boolean	Se a chave de criptografia é a chave padrão para todo o locatário. Qualquer capacidade recém-criada herda a chave padrão.
keyVaultKeyIdentifier	string	O URI que especifica exclusivamente a chave de criptografia no Azure Key Vault
name	string	O nome da chave de criptografia
updatedAt	string	A última data e hora da atualização da chave de criptografia

TenantKeyCreationRequest

Adicionar solicitação de chave de criptografia

Nome	Tipo	Description
activate	boolean	Se você deve ativar quaisquer capacidades inativadas e usar essa chave para sua criptografia
isDefault	boolean	Se uma chave de criptografia é a chave padrão para todo o locatário. Qualquer capacidade recém-criada herda a chave padrão.
keyVaultKeyIdentifier	string	O URI que especifica exclusivamente uma chave de criptografia no Azure Key Vault
name	string	O nome da chave de criptografia

Compartilhar via