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 매개 변수

Name	In(다음 안에)	필수	형식	Description
tenantKeyId	path	True	string uuid	테넌트 키 ID

요청 본문

Name	형식	Description
keyVaultKeyIdentifier	string	Azure Key Vault 암호화 키를 고유하게 지정하는 URI입니다.

응답

Name	형식	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"
}

정의

Name	Description
TenantKey	암호화 키 정보
TenantKeyRotationRequest	암호화 키 회전 요청

TenantKey

암호화 키 정보

Name	형식	Description
createdAt	string	암호화 키의 생성 날짜 및 시간
id	string	암호화 키의 ID
isDefault	boolean	암호화 키가 전체 테넌트에 대한 기본 키인지 여부입니다. 새로 만든 용량은 기본 키를 상속합니다.
keyVaultKeyIdentifier	string	Azure Key Vault 암호화 키를 고유하게 지정하는 URI입니다.
name	string	암호화 키의 이름
updatedAt	string	암호화 키의 마지막 업데이트 날짜 및 시간

TenantKeyRotationRequest

암호화 키 회전 요청

Name	형식	Description
keyVaultKeyIdentifier	string	Azure Key Vault 암호화 키를 고유하게 지정하는 URI입니다.