Criação de um número aleatório
Função
Esta API gera um número aleatório que é de 8 bits a 8192 bits.
URI
POST /v1.0/{project_id}/kms/gen-random
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
|---|---|---|---|
project_id |
Sim |
String |
ID do projeto. |
Parâmetros de solicitação
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
|---|---|---|---|
X-Auth-Token |
Sim |
String |
Token do usuário. O token pode ser obtido chamando a API do IAM (valor de X-Subject-Token no cabeçalho de resposta). |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
|---|---|---|---|
random_data_length |
Sim |
String |
Comprimento de bit de um número aleatório. O valor é um múltiplo de 8, no intervalo de 8 a 8192. |
sequence |
Não |
String |
Número de sequência de 36-byte de uma mensagem de solicitação. Exemplo: 919c82d4-8046-4722-9094-35c3c6524cff |
Parâmetros de resposta
Código de status: 200
Parâmetro |
Tipo |
Descrição |
|---|---|---|
random_data |
String |
Número aleatório em formato hexadecimal. Dois caracteres representam 1 byte. Seu comprimento deve corresponder a random_data_length. |
Código de status: 400
Parâmetro |
Tipo |
Descrição |
|---|---|---|
error |
Object |
Mensagem de erro. |
Parâmetro |
Tipo |
Descrição |
|---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Informação de erro. |
Código de status: 403
Parâmetro |
Tipo |
Descrição |
|---|---|---|
error |
Object |
Mensagem de erro. |
Parâmetro |
Tipo |
Descrição |
|---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Informação de erro. |
Exemplo de solicitações
{
"random_data_length" : "512"
}
Exemplo de respostas
Código de status: 200
Processamento da solicitação bem-sucedido.
{
"random_data" : "5791C223E87120BE4B98D168F47A58BB2A88834EEADC"
}
Código de status: 400
Parâmetros de solicitação inválidos.
{
"error" : {
"error_code" : "KMS.XXX",
"error_msg" : "XXX"
}
}
Código de status: 403
Autenticação falhou.
{
"error" : {
"error_code" : "KMS.XXX",
"error_msg" : "XXX"
}
}
Códigos de status
Código de status |
Descrição |
|---|---|
200 |
Processamento da solicitação bem-sucedido. |
400 |
Parâmetros de solicitação inválidos. |
403 |
Autenticação falhou. |
Códigos de erro
Consulte Códigos de erro.
