共用方式為

Admin - Rotate Power BI Encryption Key

  • 參考
Service:
Power BI REST APIs
API Version:
v1.0

輪替指派給容量的 Power BI 工作區加密金鑰。

權限

使用者必須具有系統管理員許可權 (，例如Office 365全域管理員或 Power BI 服務管理員) 。

必要範圍

Tenant.Read.All 或 Tenant.ReadWrite.All

限制

每小時最多 600 個要求。 

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

URI 參數

名稱 位於 必要 類型 Description
tenantKeyId
 path True

string

uuid

租使用者金鑰識別碼

要求本文

名稱 類型 Description
keyVaultKeyIdentifier

string

唯一指定 Azure 金鑰保存庫中加密金鑰的 URI

回應

名稱 類型 Description
200 OK

TenantKey

確定

範例

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

定義

名稱 Description
TenantKey

加密金鑰資訊
TenantKeyRotationRequest

輪替加密金鑰的要求

TenantKey

加密金鑰資訊

名稱 類型 Description
createdAt

string

加密金鑰的建立日期和時間
id

string

加密金鑰的識別碼
isDefault

boolean

加密金鑰是否為整個租使用者的預設金鑰。 任何新建立的容量都會繼承預設金鑰。
keyVaultKeyIdentifier

string

唯一指定 Azure 金鑰保存庫中加密金鑰的 URI
name

string

加密金鑰的名稱
updatedAt

string

加密金鑰的上次更新日期和時間

TenantKeyRotationRequest

輪替加密金鑰的要求

名稱 類型 Description
keyVaultKeyIdentifier

string

唯一指定 Azure 金鑰保存庫中加密金鑰的 URI