Admin - Rotate Power BI Encryption Key

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Otočte šifrovací klíč pro pracovní prostory Power BI přiřazené ke kapacitě.

Oprávnění

Uživatel musí mít práva správce (například Office 365 globálního správce nebo správce služby Power BI).

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Omezení

Maximálně 600 požadavků za hodinu.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
tenantKeyId	path	True	string uuid	ID klíče tenanta

Text požadavku

Name	Typ	Description
keyVaultKeyIdentifier	string	Identifikátor URI, který jedinečně určuje šifrovací klíč v Azure Key Vault

Odpovědi

Name	Typ	Description
200 OK	TenantKey	OK

Příklady

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

Definice

Name	Description
TenantKey	Informace o šifrovacím klíči
TenantKeyRotationRequest	Žádost o otočení šifrovacího klíče

TenantKey

Informace o šifrovacím klíči

Name	Typ	Description
createdAt	string	Datum a čas vytvoření šifrovacího klíče
id	string	ID šifrovacího klíče
isDefault	boolean	Určuje, jestli je šifrovací klíč výchozím klíčem pro celého tenanta. Každá nově vytvořená kapacita dědí výchozí klíč.
keyVaultKeyIdentifier	string	Identifikátor URI, který jedinečně určuje šifrovací klíč v Azure Key Vault
name	string	Název šifrovacího klíče
updatedAt	string	Datum a čas poslední aktualizace šifrovacího klíče

TenantKeyRotationRequest

Žádost o otočení šifrovacího klíče

Name	Typ	Description
keyVaultKeyIdentifier	string	Identifikátor URI, který jedinečně určuje šifrovací klíč v Azure Key Vault