Admin - Rotate Power BI Encryption Key

Odwołanie

Service:: Power BI REST APIs

API Version:: v1.0

Obraca klucz szyfrowania dla obszarów roboczych usługi Power BI przypisanych do pojemności.

Uprawnienia

Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Office 365 lub administrator usługi Power BI).

Zakres wymagany

Tenant.Read.All lub Tenant.ReadWrite.All

Ograniczenia

Maksymalna liczba żądań na godzinę wynosi 600.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
tenantKeyId	path	True	string uuid	Identyfikator klucza dzierżawy

Treść żądania

Nazwa	Typ	Opis
keyVaultKeyIdentifier	string	Identyfikator URI, który jednoznacznie określa klucz szyfrowania w usłudze Azure Key Vault

Odpowiedzi

Nazwa	Typ	Opis
200 OK	TenantKey	OK

Przykłady

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

Definicje

Nazwa	Opis
TenantKey	Informacje o kluczu szyfrowania
TenantKeyRotationRequest	Żądanie rotacji klucza szyfrowania

TenantKey

Informacje o kluczu szyfrowania

Nazwa	Typ	Opis
createdAt	string	Data i godzina utworzenia klucza szyfrowania
id	string	Identyfikator klucza szyfrowania
isDefault	boolean	Określa, czy klucz szyfrowania jest kluczem domyślnym dla całej dzierżawy. Każda nowo utworzona pojemność dziedziczy klucz domyślny.
keyVaultKeyIdentifier	string	Identyfikator URI, który jednoznacznie określa klucz szyfrowania w usłudze Azure Key Vault
name	string	Nazwa klucza szyfrowania
updatedAt	string	Data i godzina ostatniej aktualizacji klucza szyfrowania

TenantKeyRotationRequest

Żądanie rotacji klucza szyfrowania

Nazwa	Typ	Opis
keyVaultKeyIdentifier	string	Identyfikator URI, który jednoznacznie określa klucz szyfrowania w usłudze Azure Key Vault

Udostępnij za pośrednictwem