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.

Nesta página

Mostrar todos

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

Vinculação de um par de chaves SSH

Atualizado em 2023-02-28 GMT+08:00

Ver PDF

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.

Tópico principal: Gerenciamento de tarefas de par de chaves

Tópico anterior: Gerenciamento de tarefas de par de chaves

Próximo tópico: Desvinculação de um par de chaves SSH

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar