Admin - Rotate Power BI Encryption Key

Referencia

Service:: Power BI REST APIs

API Version:: v1.0

Rotación de la clave de cifrado para las áreas de trabajo de Power BI asignadas a una capacidad.

Permisos

El usuario debe tener derechos de administrador (como Office 365 administrador global o administrador del servicio Power BI).

Ámbito requerido

Tenant.Read.All o Tenant.ReadWrite.All

Limitaciones

Máximo 600 solicitudes por hora.

POST https://api.powerbi.com/v1.0/myorg/admin/tenantKeys/{tenantKeyId}/Default.Rotate

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
tenantKeyId	path	True	string uuid	Identificador de clave de inquilino

Cuerpo de la solicitud

Nombre	Tipo	Description
keyVaultKeyIdentifier	string	Identificador URI que especifica de forma única la clave de cifrado en Azure Key Vault

Respuestas

Nombre	Tipo	Description
200 OK	TenantKey	Aceptar

Ejemplos

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

Definiciones

Nombre	Description
TenantKey	Información de clave de cifrado
TenantKeyRotationRequest	Una solicitud para rotar una clave de cifrado

TenantKey

Información de clave de cifrado

Nombre	Tipo	Description
createdAt	string	Fecha y hora de creación de la clave de cifrado
id	string	Identificador de la clave de cifrado
isDefault	boolean	Si la clave de cifrado es la clave predeterminada para todo el inquilino. Cualquier capacidad recién creada hereda la clave predeterminada.
keyVaultKeyIdentifier	string	Identificador URI que especifica de forma única la clave de cifrado en Azure Key Vault
name	string	Nombre de la clave de cifrado
updatedAt	string	Fecha y hora de la última actualización de la clave de cifrado

TenantKeyRotationRequest

Una solicitud para rotar una clave de cifrado

Nombre	Tipo	Description
keyVaultKeyIdentifier	string	Identificador URI que especifica de forma única la clave de cifrado en Azure Key Vault

Compartir a través de