Get Random Bytes - Get Random Bytes

Usługa:

Key Vault

Wersja interfejsu API:

7.4

Pobierz żądaną liczbę bajtów zawierających wartości losowe z zarządzanego modułu HSM.

POST {vaultBaseUrl}/rng?api-version=7.4

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
vaultBaseUrl	path	True	string	Nazwa magazynu, na przykład https://myvault.vault.azure.net.
api-version	query	True	string	Wersja interfejsu API klienta.

Treść żądania

Nazwa	Wymagane	Typ	Opis
count	True	integer	Żądana liczba bajtów losowych.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	RandomBytes	Bajty zakodowane jako ciąg base64url.
Other Status Codes	KeyVaultError	Key Vault odpowiedź o błędzie opisująca, dlaczego operacja nie powiodła się.

Przykłady

GetRandomBytes

Przykładowe żądanie

HTTP

POST https://myhsm.managedhsm.azure.net//rng?api-version=7.4

{
  "count": 4
}

Przykładowa odpowiedź

Kod stanu:

200

{
  "value": "MTIzNA"
}

Definicje

Nazwa	Opis
Error	Błąd serwera magazynu kluczy.
GetRandomBytesRequest	Obiekt żądania pobierania losowych bajtów.
KeyVaultError	Wyjątek błędu magazynu kluczy.
RandomBytes	Obiekt odpowiedzi get random bytes zawierający bajty.

Error

Błąd serwera magazynu kluczy.

Nazwa	Typ	Opis
code	string	Kod błędu.
innererror	Error	Błąd serwera magazynu kluczy.
message	string	Komunikat o błędzie.

GetRandomBytesRequest

Obiekt żądania pobierania losowych bajtów.

Nazwa	Typ	Opis
count	integer	Żądana liczba bajtów losowych.

KeyVaultError

Wyjątek błędu magazynu kluczy.

Nazwa	Typ	Opis
error	Error	Błąd serwera magazynu kluczy.

RandomBytes

Obiekt odpowiedzi get random bytes zawierający bajty.

Nazwa	Typ	Opis
value	string	Bajty zakodowane jako ciąg base64url.