管理 Amazon EC2 实例 - AWS SDK for JavaScript
情景先决条件任务描述实例管理实例监控启动和停止实例重启实例

我们已宣布即将终止对 AWS SDK for JavaScript v2 的支持。建议您迁移到 AWS SDK for JavaScript v3。有关日期、其他详细信息以及如何迁移的信息，请参阅链接的公告。

管理 Amazon EC2 实例

JavaScript code example that applies to Node.js execution

此 Node.js 代码示例演示：

  • 如何检索有关 Amazon EC2 实例的基本信息。

  • 如何启动和停止对 Amazon EC2 实例的详细监控。

  • 如何启动和停止 Amazon EC2 实例。

  • 如何重启 Amazon EC2 实例。

情景

在本示例中，您使用一系列 Node.js 模块执行多个基本实例管理操作。这些 Node.js 模块使用 SDK for JavaScript，通过以下 Amazon EC2 客户端类方法管理实例：

有关 Amazon EC2 实例生命周期的更多信息，请参阅《Amazon EC2 用户指南（适用于 Linux 实例）》中的实例生命周期。

先决条件任务

要设置和运行此示例，请先完成以下任务：

描述实例

创建文件名为 ec2_describeinstances.js 的 Node.js 模块。请确保按前面所示配置开发工具包。要访问 Amazon EC2，请创建 AWS.EC2 服务对象。调用 Amazon EC2 服务对象的 describeInstances 方法来检索实例的详细说明。

// 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 = {
  DryRun: false,
};

// Call EC2 to retrieve policy for selected bucket
ec2.describeInstances(params, function (err, data) {
  if (err) {
    console.log("Error", err.stack);
  } else {
    console.log("Success", JSON.stringify(data));
  }
});

要运行示例，请在命令行中键入以下内容。

node ec2_describeinstances.js

此示例代码可在 GitHub 上的此处找到。

管理实例监控

创建文件名为 ec2_monitorinstances.js 的 Node.js 模块。请确保按前面所示配置开发工具包。要访问 Amazon EC2，请创建 AWS.EC2 服务对象。添加您要控制监控的实例的实例 ID。

根据命令行参数的值（ON 或 OFF），调用 Amazon EC2 服务对象的 monitorInstances 方法来启动对指定实例的详细监控，或者调用 unmonitorInstances 方法。使用 DryRun 参数，在您尝试更改这些实例的监控之前，测试您是否有权限更改实例监控。

// 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 = {
  InstanceIds: ["INSTANCE_ID"],
  DryRun: true,
};

if (process.argv[2].toUpperCase() === "ON") {
  // Call EC2 to start monitoring the selected instances
  ec2.monitorInstances(params, function (err, data) {
    if (err && err.code === "DryRunOperation") {
      params.DryRun = false;
      ec2.monitorInstances(params, function (err, data) {
        if (err) {
          console.log("Error", err);
        } else if (data) {
          console.log("Success", data.InstanceMonitorings);
        }
      });
    } else {
      console.log("You don't have permission to change instance monitoring.");
    }
  });
} else if (process.argv[2].toUpperCase() === "OFF") {
  // Call EC2 to stop monitoring the selected instances
  ec2.unmonitorInstances(params, function (err, data) {
    if (err && err.code === "DryRunOperation") {
      params.DryRun = false;
      ec2.unmonitorInstances(params, function (err, data) {
        if (err) {
          console.log("Error", err);
        } else if (data) {
          console.log("Success", data.InstanceMonitorings);
        }
      });
    } else {
      console.log("You don't have permission to change instance monitoring.");
    }
  });
}

要运行此示例，请在命令行中键入以下内容，指定 ON 以启动详细监控，或者指定 OFF 以停止监控。

node ec2_monitorinstances.js ON

此示例代码可在 GitHub 上的此处找到。

启动和停止实例

创建文件名为 ec2_startstopinstances.js 的 Node.js 模块。请确保按前面所示配置开发工具包。要访问 Amazon EC2，请创建 AWS.EC2 服务对象。添加您要启动或停止的实例的实例 ID。

根据命令行参数的值（START 或 STOP），调用 Amazon EC2 服务对象的 startInstances 方法来启动指定实例，或者调用 stopInstances 方法来停止实例。首先使用 DryRun 参数来测试您是否有权限，然后再尝试启动或停止所选实例。

// 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 = {
  InstanceIds: [process.argv[3]],
  DryRun: true,
};

if (process.argv[2].toUpperCase() === "START") {
  // Call EC2 to start the selected instances
  ec2.startInstances(params, function (err, data) {
    if (err && err.code === "DryRunOperation") {
      params.DryRun = false;
      ec2.startInstances(params, function (err, data) {
        if (err) {
          console.log("Error", err);
        } else if (data) {
          console.log("Success", data.StartingInstances);
        }
      });
    } else {
      console.log("You don't have permission to start instances.");
    }
  });
} else if (process.argv[2].toUpperCase() === "STOP") {
  // Call EC2 to stop the selected instances
  ec2.stopInstances(params, function (err, data) {
    if (err && err.code === "DryRunOperation") {
      params.DryRun = false;
      ec2.stopInstances(params, function (err, data) {
        if (err) {
          console.log("Error", err);
        } else if (data) {
          console.log("Success", data.StoppingInstances);
        }
      });
    } else {
      console.log("You don't have permission to stop instances");
    }
  });
}

要运行此示例，请在命令行中键入以下内容，指定 START 以启动实例，或者指定 STOP 以停止实例。

node ec2_startstopinstances.js START INSTANCE_ID

此示例代码可在 GitHub 上的此处找到。

重启实例

创建文件名为 ec2_rebootinstances.js 的 Node.js 模块。请确保按前面所示配置开发工具包。要访问 Amazon EC2，请创建 Amazon EC2 服务对象。添加您要重启的实例的实例 ID。调用 AWS.EC2 服务对象的 rebootInstances 方法来重启指定的实例。首先使用 DryRun 参数来测试您是否有权限重启这些实例，然后再尝试重启它们。

// 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 = {
  InstanceIds: ["INSTANCE_ID"],
  DryRun: true,
};

// Call EC2 to reboot instances
ec2.rebootInstances(params, function (err, data) {
  if (err && err.code === "DryRunOperation") {
    params.DryRun = false;
    ec2.rebootInstances(params, function (err, data) {
      if (err) {
        console.log("Error", err);
      } else if (data) {
        console.log("Success", data);
      }
    });
  } else {
    console.log("You don't have permission to reboot instances.");
  }
});

要运行示例，请在命令行中键入以下内容。

node ec2_rebootinstances.js

此示例代码可在 GitHub 上的此处找到。