Admin - Rotate Power BI Encryption Key

Serviço:: Power BI REST APIs

Versão da API:: v1.0

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

Permissões

O usuário deve ser um administrador do Fabric.

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	OKEY

Exemplos

Example

Solicitação de exemplo

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

Corpo da solicitação

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

Resposta de exemplo

Código de status:: 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

Objeto

Informações de chave de criptografia

Nome	Tipo	Description
createdAt	string (date-time)	A data e a hora de criação da chave de criptografia
id	string (uuid)	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 (date-time)	A data e a hora da última atualização da chave de criptografia

TenantKeyRotationRequest