AWS SDK调用CloudWatch getMetricData报MaxQueryTimeRangeExceeded

出现MaxQueryTimeRangeExceeded报错是两个问题叠加导致的：

• 参数类型错误：代码中Period字段传的是字符串'600'，但getMetricData接口要求该字段为整数类型，CloudWatch服务端无法识别到合法的周期参数，会默认按最细粒度（1秒）的查询规则做时间窗口校验，1秒粒度的查询仅允许查询最近3小时内的数据。
• 查询语法限制：你用的SELECT ...是CloudWatch Metrics Insights的SQL查询语法，该语法即使在正确指定大周期参数的情况下，最长也仅支持查询最近63天内的指标数据。你代码里指定的查询时间是2022年6月，距离当前时间远远超出63天的上限，就算修正参数类型也会触发同样的报错。

根据你的查询时间范围选对应方案即可：

• 如果你要查询最近63天内的指标数据：仅需把Period的字符串值改成数字类型，同时把查询时间调整到63天范围内，修正后参数片段如下：

var params = {
    StartTime: new Date('你的查询开始时间，需在最近63天内'),
    EndTime: new Date('你的查询结束时间'), 
    MetricDataQueries: [ 
      {
        Id: 'q1', 
        Expression: "SELECT AVG(CPUUtilization) FROM SCHEMA(\"AWS/EC2\", InstanceId) WHERE InstanceId = 'i-**********'",
        Period: 600 // 去掉引号，传数字类型
      },
    ],
};

• 如果你要查询超过63天的历史指标（比如你示例里写的2022年的数据）：必须放弃Metrics Insights SQL写法，改用传统的MetricStat结构传参，该方式支持查询CloudWatch指标全保留周期（15个月）内的数据，完整可运行代码如下：

const AWS = require("aws-sdk");
AWS.config.loadFromPath("./config.json");

var cloudwatch = new AWS.CloudWatch({apiVersion: "2010-08-01", region: "替换为目标EC2实例所在区域，例如us-east-1"});

var params = {
    StartTime: new Date('june 06, 2022 17:30'),
    EndTime: new Date('june 06, 2022 18:00'), 
    MetricDataQueries: [ 
      {
        Id: 'q1', 
        MetricStat: {
          Metric: {
            Namespace: 'AWS/EC2',
            MetricName: 'CPUUtilization',
            Dimensions: [
              {
                Name: 'InstanceId',
                Value: 'i-**********' // 替换为真实实例ID
              }
            ]
          },
          Period: 600,
          Stat: 'Average'
        },
        ReturnData: true
      },
    ],
};
cloudwatch.getMetricData(params, function(err, data) {
  if (err) console.log(err, err.stack); 
  else     console.log(data);           
});

额外提醒：调用接口前请确认配置的AWS凭证所属账号、区域和目标EC2实例所属的账号、区域一致，否则就算参数正确也会返回空的指标数据。

内容的提问来源于stack exchange，提问作者Pa3k.m