你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get Random Bytes - Get Random Bytes

Service:

Key Vault

API Version:

7.4

从托管 HSM 获取包含随机值的请求字节数。

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

URI 参数

名称	在	必需	类型	说明
vaultBaseUrl	path	True	string	保管库名称，例如 https://myvault.vault.azure.net。
api-version	query	True	string	客户端 API 版本。

请求正文

名称	必需	类型	说明
count	True	integer	请求的随机字节数。

响应

名称	类型	说明
200 OK	RandomBytes	编码为 base64url 字符串的字节。
Other Status Codes	KeyVaultError	密钥保管库描述操作失败原因的错误响应。

示例

GetRandomBytes

Sample Request

HTTP

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

{
  "count": 4
}

Sample Response

Status code:

200

{
  "value": "MTIzNA"
}

定义

名称	说明
Error	密钥保管库服务器错误。
GetRandomBytesRequest	获取随机字节请求对象。
KeyVaultError	密钥保管库错误异常。
RandomBytes	获取包含字节的随机字节响应对象。

Error

密钥保管库服务器错误。

名称	类型	说明
code	string	错误代码。
innererror	Error	密钥保管库服务器错误。
message	string	错误消息。

GetRandomBytesRequest

获取随机字节请求对象。

名称	类型	说明
count	integer	请求的随机字节数。

KeyVaultError

密钥保管库错误异常。

名称	类型	说明
error	Error	密钥保管库服务器错误。

RandomBytes

获取包含字节的随机字节响应对象。

名称	类型	说明
value	string	编码为 base64url 字符串的字节。