Anunciamos el próximo fin del soporte para AWS SDK for JavaScript v2. Se recomienda que migre a AWS SDK for JavaScript v3. Para ver las fechas, los detalles adicionales y la información sobre cómo realizar la migración, consulte el anuncio enlazado.

Uso de pares de claves de Amazon EC2

Este ejemplo de código de Node.js muestra:

El escenario

Amazon EC2 utiliza la criptografía de clave pública para cifrar y descifrar la información de inicio de sesión. En la criptografía de clave pública se utiliza una clave pública para cifrar datos y, a continuación, el destinatario utiliza la clave privada para descifrar los datos. El conjunto de clave pública y clave privada se denomina par de claves.

En este ejemplo, va a utilizar una serie de módulos de Node.js para realizar varias operaciones de administración de pares de claves de Amazon EC2. Los módulos de Node.js usan el SDK para JavaScript para gestionar instancias usando estos métodos de clase de cliente de Amazon EC2:

Para obtener más información acerca de los pares de claves de Amazon EC2, consulte Pares de claves de Amazon EC2 en la Guía del usuario de Amazon EC2 o Pares de claves de Amazon EC2 e instancias de Windows en la Guía del usuario de Amazon EC2.

Tareas previas necesarias

Para configurar y ejecutar este ejemplo, primero debe completar las tareas siguientes:

Descripción de sus pares de claves

Cree un módulo de Node.js con el nombre de archivo ec2_describekeypairs.js. Asegúrese de configurar el SDK tal y como se ha indicado anteriormente. Para acceder a Amazon EC2, cree un objeto de servicio de AWS.EC2. Cree un objeto JSON vacío para almacenar los parámetros que el método describeKeyPairs necesita para devolver las descripciones de todos sus pares de claves. También puede proporcionar una matriz de nombres de pares de claves en la parte KeyName de los parámetros en el archivo JSON al método describeKeyPairs.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create EC2 service object
var ec2 = new AWS.EC2({ apiVersion: "2016-11-15" });

// Retrieve key pair descriptions; no params needed
ec2.describeKeyPairs(function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", JSON.stringify(data.KeyPairs));
  }
});

Para ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.

node ec2_describekeypairs.js

Este código de ejemplo se puede encontrar aquí en GitHub.

Creación de un par de claves

Cada par de claves requiere un nombre. Amazon EC2 asocia la clave pública al nombre que especifique como nombre de la clave. Cree un módulo de Node.js con el nombre de archivo ec2_createkeypair.js. Asegúrese de configurar el SDK tal y como se ha indicado anteriormente. Para acceder a Amazon EC2, cree un objeto de servicio de AWS.EC2. Cree los parámetros de JSON para especificar el nombre del par de claves y luego transferirlos para llamar al método createKeyPair.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create EC2 service object
var ec2 = new AWS.EC2({ apiVersion: "2016-11-15" });

var params = {
  KeyName: "KEY_PAIR_NAME",
};

// Create the key pair
ec2.createKeyPair(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log(JSON.stringify(data));
  }
});

Para ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.

node ec2_createkeypair.js

Este código de ejemplo se puede encontrar aquí en GitHub.

Eliminación de un par de claves

Cree un módulo de Node.js con el nombre de archivo ec2_deletekeypair.js. Asegúrese de configurar el SDK tal y como se ha indicado anteriormente. Para acceder a Amazon EC2, cree un objeto de servicio de AWS.EC2. Cree los parámetros JSON para especificar el nombre del par de claves que desea eliminar. A continuación, llame al método deleteKeyPair.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create EC2 service object
var ec2 = new AWS.EC2({ apiVersion: "2016-11-15" });

var params = {
  KeyName: "KEY_PAIR_NAME",
};

// Delete the key pair
ec2.deleteKeyPair(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Key Pair Deleted");
  }
});

Para ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.

node ec2_deletekeypair.js

Este código de ejemplo se puede encontrar aquí en GitHub.