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)

Идентификатор ключа клиента

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

Имя Тип Описание
keyVaultKeyIdentifier

string

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

Ответы

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

Идентификатор ключа шифрования
isDefault

boolean

Является ли ключ шифрования ключом по умолчанию для всего клиента. Любая только что созданная емкость наследует ключ по умолчанию.
keyVaultKeyIdentifier

string

Универсальный код ресурса (URI), уникально указывающий ключ шифрования в Azure Key Vault
name

string

Имя ключа шифрования
updatedAt

string (date-time)

Дата последнего обновления и время ключа шифрования

TenantKeyRotationRequest

Object

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

Имя Тип Описание
keyVaultKeyIdentifier

string

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