管理 Amazon EC2 实例 - Amazon SDK for JavaScript
情景先决条件任务描述实例管理实例监控启动和停止实例重启实例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon SDK for JavaScript v2 已终止支持。建议您迁移到 Amazon 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 用户指南》中的实例生命周期。

先决条件任务

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

描述实例

创建文件名为 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 上的此处找到。