Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Data Encryption Workshop/ Referencia de la API/ APIs/ API de gestión de pares clave/ Gestión de tareas de pare de clave/ Vincular un par de claves SSH
Actualización más reciente 2022-11-03 GMT+08:00
Ver PDF
Compartir

Vincular un par de claves SSH

Función

Esta API se utiliza para enlazar un par de claves SSH a una VM especificada. (La clave privada del par de claves SSH para la máquina virtual es necesaria si desea reemplazar el par de claves, pero no es necesaria si desea restablecer el par de claves.)

URI

POST /v3/{project_id}/keypairs/associate

Tabla 1 Parámetros de path

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID del proyecto.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de usuario. El token se puede obtener llamando a la API IAM (valor de X-Subject-Token en el encabezado de respuesta).
Tabla 3 Parámetros de body de solicitud

Parámetro

Obligatorio

Tipo

Descripción

keypair_name

Sí

String

Nombre del par de claves SSH.

server

Sí

EcsServerInfo object

Información sobre la máquina virtual a la que se va a vincular el par de claves.
Tabla 4 EcsServerInfo

Parámetro

Obligatorio

Tipo

Descripción

id

Yes

String

ID de la máquina virtual a la que se debe enlazar el par de claves SSH . (para reemplazar o restablecer el par de claves original).

auth

No

Auth object

(Opcional) Tipo de autenticación. Este parámetro es necesario para el reemplazo del par de claves, pero no es necesario para el restablecimiento del par de claves.

disable_password

No

Boolean
  • true: el inicio de sesión SSH está deshabilitado en la máquina virtual.
  • false: el inicio de sesión SSH está habilitado en la máquina virtual.
Tabla 5 Auth

Parámetro

Obligatorio

Tipo

Descripción

type

No

String

Un valor enumerado.

key

No

String
  • Si el tipo se establece en contraseña, este parámetro indica la contraseña.
  • Si el tipo se establece en par de claves, este parámetro indica la clave privada.

Parámetros de respuesta

Código de estado: 200

Tabla 6 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

task_id

String

ID devuelto cuando una tarea se entrega correctamente.

Código de estado: 400

Tabla 7 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Solicitudes de ejemplo

  • {
  "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"
  }
}

Ejemplo de respuestas

Código de estado: 200

OK.

{
  "task_id" : "aee8d2fe-5484-4753-9177-5a38dc15546c"
}

Código de estado: 400

Error occurred.

{
  "error_code" : "KPS.XXX",
  "error_msg" : "XXX"
}

Códigos de estado

Código de estado

Descripción

200

OK.

400

Error occurred.

Códigos de error

Consulte Códigos de error.