了解命令状态

Run Command 是 AWS Systems Manager 的一项功能，报告关于处理过程中命令经历的不同状态以及处理该命令的每个托管式节点的详细状态信息。您可以使用以下方法监控命令状态：

Run Command 状态

Run Command 报告以下三个区域的状态详情：插件、调用和总体命令状态。插件是在命令的 SSM 文档中定义的代码执行数据块。有关插件的更多信息，请参阅 命令文档插件参考。

在将一条命令同时发送给多个托管式节点时，针对每个节点的命令的每个副本均为一个命令调用。例如，如果您使用 AWS-RunShellScript 文档并将一个 ifconfig 命令发送到 20 个 Linux 实例，则该命令具有 20 个调用。每个命令调用都会单独报告状态。给定命令调用的插件也会单独报告状态。

最后，Run Command 包含适用于所有插件和调用的聚合命令状态。聚合命令状态可能不同于插件或调用报告的状态，如下表所述。

了解命令超时值

在运行命令时，Systems Manager 强制执行以下超时值。

总超时

在 Systems Manager 控制台中，您可以在 Timeout (seconds)（超时（秒））字段中指定超时值。发送命令后，Run Command 会检查命令是否已过期。如果命令达到命令过期限制（总超时），它会将所有状态为 InProgress (正在进行)、Pending (待处理) 或 Delayed (延迟) 的调用的状态更改为 DeliveryTimedOut (传输超时)。

在更深的技术层面上，总超时（Timeout (seconds)（超时（秒）））是两个超时值的总和，如下所示：

Total timeout = "Timeout(seconds)" from the console + "timeoutSeconds": "{{ executionTimeout }}" from your SSM document

例如，在 Systems Manager 控制台中，Timeout (seconds) (超时 (秒)) 的默认值是 600 秒。如果使用 AWS-RunShellScript SSM 文档运行命令，则 "timeoutSeconds": "{{ executionTimeout }}" 的默认值为 3600 秒，如以下示例文档所示：

  "executionTimeout": {
      "type": "String",
      "default": "3600",

  "runtimeConfig": {
    "aws:runShellScript": {
      "properties": [
        {
          "timeoutSeconds": "{{ executionTimeout }}"

这意味着，在系统将命令状态设置为 DeliveryTimedOut 之前，该命令运行了 4200 秒（70 分钟）。

执行超时

在 Systems Manager 控制台中，您可以在 Execution Timeout (执行超时) 字段中指定执行超时值（如果可用）。并非所有 SSM 文档都要求指定执行超时值。Execution Timeout（执行超时）字段仅在 SSM 文档中定义了相应的输入参数时才会显示。如果已指定该值，则命令必须在此时段内完成。

默认执行超时

如果 SSM 文档不要求您明确指定执行超时值，则 Systems Manager 会强制执行硬编码的默认执行超时。

Systems Manager 如何报告超时

如果 Systems Manager 收到来自目标上的 SSM Agent 的 execution timeout 回复，则 Systems Manager 会将命令调用标记为 executionTimeout。

如果 Run Command 没有收到 SSM Agent 文档最终响应，则命令调用被标记为 deliveryTimeout。

为了确定目标的超时状态，SSM Agent 将合并 SSM 文档的所有参数和内容来计算 executionTimeout。如果 SSM Agent 确定某条命令已超时，它会向服务发送 executionTimeout。

Timeout (seconds) (超时 (秒)) 的默认值为 3600 秒。Execution Timeout (执行超时) 的默认值也为 3600 秒。因此，命令的总超时默认为 7200 秒。