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

Имя	В	Обязательно	Тип	Описание
tenantKeyId	path	True	string uuid	Идентификатор ключа клиента

Текст запроса

Имя	Тип	Описание
keyVaultKeyIdentifier	string	Универсальный код ресурса (URI), однозначно указывающий ключ шифрования в Azure Key Vault

Ответы

Имя	Тип	Описание
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"
}

Определения

Имя	Описание
TenantKey	Сведения о ключе шифрования
TenantKeyRotationRequest	Запрос на смену ключа шифрования

TenantKey

Сведения о ключе шифрования

Имя	Тип	Описание
createdAt	string	Дата и время создания ключа шифрования
id	string	Идентификатор ключа шифрования
isDefault	boolean	Указывает, является ли ключ шифрования ключом по умолчанию для всего клиента. Любая только что созданная емкость наследует ключ по умолчанию.
keyVaultKeyIdentifier	string	Универсальный код ресурса (URI), однозначно указывающий ключ шифрования в Azure Key Vault
name	string	Имя ключа шифрования
updatedAt	string	Дата и время последнего обновления ключа шифрования

TenantKeyRotationRequest

Запрос на смену ключа шифрования

Имя	Тип	Описание
keyVaultKeyIdentifier	string	Универсальный код ресурса (URI), однозначно указывающий ключ шифрования в Azure Key Vault

Share via