다음을 통해 공유

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입니다.