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/ Bare Metal Server/ Referencia de la API/ API nativa de Nova V2.1 de OpenStack/ Gestión de pares de claves de SSH del BMS/ Creación o importación de un par de claves de SSH (API nativa de OpenStack)

Actualización más reciente 2025-02-18 GMT+08:00

Ver PDF

Creación o importación de un par de claves de SSH (API nativa de OpenStack)

Función

Esta API se utiliza para crear un par de claves SSH o importar una clave pública para generar un par de claves.

Después de generar un par de claves de SSH, descargue la clave privada a un directorio local. A continuación, puede utilizar esta clave privada para iniciar sesión en el BMS. Por motivos de seguridad del BMS, solo se puede descargar una clave privada una vez. Guárdela en un lugar seguro.

URI

POST /v2.1/{project_id}/os-keypairs

Tabla 1 enumera los parámetros.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Descripción
project_id	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.

Parámetros de solicitud

Al crear un par de claves SSH, solo necesita configurar name. Al importar una clave SSH pública, también debe configurar public_key.

Parámetro	Obligatorio	Tipo	Descripción
keypair	Sí	Object	Especifica el par de claves de SSH creado o importado. Para obtener más información, consulte Tabla 2.

**Tabla 2** Descripción de la estructura de datos del campo **keypair**
Parámetro	Obligatorio	Tipo	Descripción
public_key	No	String	Especifica la clave pública importada. El tamaño máximo de la clave pública importada es de 1024 bytes. Nota: Si la longitud de la clave pública que se va a importar supera los 1024 bytes, la importación de clave pública al BMS fallará.
name	Sí	String	Especifica el nombre del par de claves. El nombre del nuevo par de claves no puede ser el mismo que uno existente.

Ejemplo de solicitud

Crear o importar un par de claves de SSH (nombre: keypair-7d7c3650-dabe-4eb0-b904-5c464453c043) con la clave pública ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQC9mC3WZN9UGLxgPBpP7H5jZMc6pKwOoSgre8yun6REFktn/Kz7DUt9jaR1UJyRzHxITfCfAIgSxPdGqB/oF1suMyWgu5i0625vavLB5z5kC8Hq3qZJ9zJO1poE1kyD+htiTtPWJ88e12xuH2XB/CZN9OpEiF98hAagiOE0EnOS5Q== Generated by Nova\n

     
          POST https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/os-keypairs

     
          {
    "keypair": {
        "name": "keypair-7d7c3650-dabe-4eb0-b904-5c464453c043",
        "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQC9mC3WZN9UGLxgPBpP7H5jZMc6pKwOoSgre8yun6REFktn/Kz7DUt9jaR1UJyRzHxITfCfAIgSxPdGqB/oF1suMyWgu5i0625vavLB5z5kC8Hq3qZJ9zJO1poE1kyD+htiTtPWJ88e12xuH2XB/CZN9OpEiF98hAagiOE0EnOS5Q== Generated by Nova\n"
    }
}

Parámetros de respuesta

Parámetro	Tipo	Descripción
keypair	Object	Especifica el par de claves SSH. Para obtener más información, consulte Tabla 3.

**Tabla 3** Descripción de la estructura de datos del campo **keypair**
Parámetro	Tipo	Descripción
fingerprint	String	Especifica la información de huellas dactilares sobre el par de claves.
name	String	Especifica el nombre del par de claves.
public_key	String	Especifica la clave pública.
private_key	String	Especifica la clave privada. La información sobre la clave privada está contenida en la respuesta para crear una clave de SSH. La información sobre la clave privada no está contenida en la respuesta para importar una clave de SSH.
user_id	String	Especifica el ID del usuario al que pertenece el par de claves.

Ejemplo de respuesta

    
         {
    "keypair": {
        "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQC9mC3WZN9UGLxgPBpP7H5jZMc6pKwOoSgre8yun6REFktn/Kz7DUt9jaR1UJyRzHxITfCfAIgSxPdGqB/oF1suMyWgu5i0625vavLB5z5kC8Hq3qZJ9zJO1poE1kyD+htiTtPWJ88e12xuH2XB/CZN9OpEiF98hAagiOE0EnOS5Q== Generated by Nova\n",
        "user_id": "f882feb345064e7d9392440a0f397c25",
        "name": "keypair-7d7c3650-dabe-4eb0-b904-5c464453c043",
        "fingerprint": "35:9d:d0:c3:4a:80:d3:d8:86:f1:ca:f7:df:c4:f9:d8"
    }
}