Admin - Add Power BI Encryption Key

Odwołanie

Service:: Power BI REST APIs

API Version:: v1.0

Dodaje 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).

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

Ograniczenia

Maksymalnie 600 żądań na godzinę.

POST https://api.powerbi.com/v1.0/myorg/admin/tenantKeys

Treść żądania

Nazwa	Typ	Opis
activate	boolean	Czy aktywować jakiekolwiek nieaktywne pojemności i używać tego klucza do jego 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

Odpowiedzi

Nazwa	Typ	Opis
200 OK	TenantKey	OK

Przykłady

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/tenantKeys

Request Body

{
  "name": "Contoso Sales",
  "keyVaultKeyIdentifier": "https://contoso-vault2.vault.azure.net/keys/ContosoKeyVault/b2ab4ba1c7b341eea5ecaaa2wb54c4d2",
  "activate": true,
  "isDefault": true
}

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
TenantKeyCreationRequest	Dodawanie żądania 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	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

TenantKeyCreationRequest

Dodawanie żądania klucza szyfrowania

Nazwa	Typ	Opis
activate	boolean	Czy aktywować jakiekolwiek nieaktywne pojemności i używać tego klucza do jego 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

Udostępnij za pośrednictwem