Admin - Rotate Power BI Encryption Key

Referência

Service:: Power BI REST APIs

API Version:: v1.0

Gire a 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/{tenantKeyId}/Default.Rotate

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
tenantKeyId	path	True	string uuid	A ID da chave de locatário

Corpo da solicitação

Nome	Tipo	Description
keyVaultKeyIdentifier	string	O URI que especifica exclusivamente a chave de criptografia no Azure Key Vault

Respostas

Nome	Tipo	Description
200 OK	TenantKey	OK

Exemplos

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

Definições

Nome	Description
TenantKey	Informações de chave de criptografia
TenantKeyRotationRequest	Uma solicitação para girar uma chave de criptografia

TenantKey

Informações de chave de criptografia

Nome	Tipo	Description
createdAt	string	A data e a hora da 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

TenantKeyRotationRequest

Uma solicitação para girar uma chave de criptografia

Nome	Tipo	Description
keyVaultKeyIdentifier	string	O URI que especifica exclusivamente a chave de criptografia no Azure Key Vault

Compartilhar via