通过

Admin - Rotate Power BI Encryption Key

服务:
Power BI REST APIs
API 版本:
v1.0

轮换分配给容量的 Power BI 工作区的加密密钥。

Permissions

用户必须是 Fabric 管理员。

所需范围

Tenant.Read.All 或 Tenant.ReadWrite.All

局限性

每小时最多 600 个请求。 

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

URI 参数

名称 在 必需 类型 说明
tenantKeyId
 path True

string (uuid)

租户密钥 ID

请求正文

名称 类型 说明
keyVaultKeyIdentifier

string

唯一指定 Azure Key Vault 中的加密密钥的 URI

响应

名称 类型 说明
200 OK

TenantKey

好的

示例

Example

示例请求

POST https://api.powerbi.com/v1.0/myorg/admin/tenantKeys/82d9a37a-2b45-4221-b012-cb109b8e30c7/Default.Rotate
请求正文
{
  "keyVaultKeyIdentifier": "https://contoso-vault2.vault.azure.net/keys/ContosoKeyVault/b2ab4ba1c7b341eea5ecaaa2wb54c4d2"
}

示例响应

状态代码:
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"
}

定义

名称 说明
TenantKey

加密密钥信息
TenantKeyRotationRequest

轮换加密密钥的请求

TenantKey

Object

加密密钥信息

名称 类型 说明
createdAt

string (date-time)

加密密钥的创建日期和时间
id

string (uuid)

加密密钥的 ID
isDefault

boolean

加密密钥是否是整个租户的默认密钥。 任何新创建的容量都继承默认密钥。
keyVaultKeyIdentifier

string

唯一指定 Azure Key Vault 中的加密密钥的 URI
name

string

加密密钥的名称
updatedAt

string (date-time)

加密密钥的上次更新日期和时间

TenantKeyRotationRequest

Object

轮换加密密钥的请求

名称 类型 说明
keyVaultKeyIdentifier

string

唯一指定 Azure Key Vault 中的加密密钥的 URI