Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/Data Encryption Workshop/Referência de API/APIs/APIs de gerenciamento de pares de chaves/Gerenciamento de tarefas de par de chaves/Vinculação de um par de chaves SSH
Atualizado em 2023-02-28 GMT+08:00
Ver PDF
Compartilhar

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

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatoriedade

Tipo

Descrição

project_id

Sim

String

ID do projeto.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho 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).

Tabela 3 Parâmetros de corpo de solicitação

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.

Tabela 4 EcsServerInfo

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

  • verdadeiro: o logon do SSH está desabilitado na VM.
  • falso: o logon do SSH é habilitado na VM.
Tabela 5 Auth

Parâmetro

Obrigatoriedade

Tipo

Descrição

type

Não

String

Um valor enumerado.

key

Não

String

  • Se o tipo for definido como senha, esse parâmetro indicará a senha.
  • Se o tipo for definido como par de chaves, esse parâmetro indicará a chave privada.

Parâmetros de resposta

Código de status: 200

Tabela 6 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

task_id

String

O ID retornado quando uma tarefa é entregue com sucesso.

Código de status: 400

Tabela 7 Parâmetros de corpo da resposta

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.