Vinculação de um par de chaves SSH
Função
Essa API é usada para vincular um par de chaves SSH a uma VM especificada. (A chave privada do par de chaves SSH para a VM é necessária se você quiser substituir o par de chaves, mas não é necessária se você quiser redefinir o par de chaves.)
URI
POST /v3/{project_id}/keypairs/associate
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 |
---|---|---|---|
keypair_name |
Sim |
String |
Nome do par de chaves SSH. |
server |
Sim |
EcsServerInfo object |
Informações sobre a VM à qual o par de chaves deve ser vinculado. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
id |
Sim |
String |
ID da VM à qual o par de chaves SSH deve ser vinculado (para substituir ou redefinir o par de chaves original). |
auth |
Não |
Auth object |
(Opcional) Tipo de autenticação. Este parâmetro é necessário para a substituição de par de chaves, mas não é necessário para a reposição de par de chaves. |
disable_password |
Não |
Boolean |
|
Parâmetros de resposta
Código de status: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
task_id |
String |
O ID retornado quando uma tarefa é entregue com sucesso. |
Código de status: 400
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Exemplo de solicitações
-
{ "keypair_name" : "newkeypair", "server" : { "id" : "d76baba7-ef09-40a2-87ff-3eafec0696e7", "authentication" : { "type" : "keypair", "key" : "-----BEGINRSAPRIVATEKEY-----\nM..." } } }
-
{ "keypair_name" : "newkeypair", "server" : { "id" : "d76baba7-ef09-40a2-87ff-3eafec0696e7" } }
Exemplo de respostas
Código de status: 200
OK.
{ "task_id" : "aee8d2fe-5484-4753-9177-5a38dc15546c" }
Código de status: 400
Ocorreu um erro.
{ "error_code" : "KPS.XXX", "error_msg" : "XXX" }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
OK. |
400 |
Ocorreu um erro. |
Códigos de erro
Consulte Códigos de erro.