Admin - Rotate Power BI Encryption Key

Usługa:: Power BI REST APIs

Wersja interfejsu API:: v1.0

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

Uprawnienia

Użytkownik musi być administratorem sieci szkieletowej.

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

Ograniczenia

Maksymalna liczba żądań 600 na godzinę.

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

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/admin/tenantKeys/82d9a37a-2b45-4221-b012-cb109b8e30c7/Default.Rotate

Treść żądania

{
  "keyVaultKeyIdentifier": "https://contoso-vault2.vault.azure.net/keys/ContosoKeyVault/b2ab4ba1c7b341eea5ecaaa2wb54c4d2"
}

Przykładowa odpowiedź

Kod stanu:: 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

Objekt

Informacje o kluczu szyfrowania

Nazwa	Typ	Opis
createdAt	string (date-time)	Data i godzina utworzenia klucza szyfrowania
id	string (uuid)	Identyfikator klucza szyfrowania
isDefault	boolean	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 (date-time)	Data i godzina ostatniej aktualizacji klucza szyfrowania

TenantKeyRotationRequest