查看关联历史记录

您可以使用 DescribeAssociationExecutions API 操作查看特定关联 ID 的所有执行。使用此操作可查看 State Manager 关联的状态、详细状态、结果、上次执行时间以及其他信息。State Manager 是 AWS Systems Manager 的一种功能。此 API 操作还包括筛选条件，帮助您根据指定的条件快速找到关联。例如，您可以指定一个确切的日期和时间，并使用 GREATER_THAN 筛选条件以查看在该指定的日期和时间之后处理的那些执行。

例如，如果一个关联执行失败，则可使用 DescribeAssociationExecutionTargets API 操作来深入了解特定执行的详细信息。此操作将为您显示资源，例如节点 ID、关联运行的位置和各种关联状态。您可以查看哪些资源或节点无法运行关联。利用资源 ID，您随后可以查看命令执行详细信息，以了解命令中的哪个步骤已失败。

本节中的示例还包括有关如何在创建时使用 StartAssociationsOnce API 操作运行一次关联的信息。在调查失败的关联执行时，可以使用此 API 操作。如果发现一个关联失败，则可以在资源上进行更改，然后立即运行关联以查看对资源所做的更改是否可让关联成功运行。

注意

在关联运行期间由 SSM 文档发起的 API 操作未登录 AWS CloudTrail。

查看关联历史记录（控制台）

使用以下过程可查看特定关联 ID 的执行历史记录，然后查看一个或多个资源的执行详细信息。

查看特定关联 ID 的执行历史记录

访问 https://console.aws.amazon.com/systems-manager/，打开 AWS Systems Manager 控制台。
选择State Manager。
在 Association id (关联 ID) 字段中，选择要查看其历史记录的关联。
选择 View details (查看详细信息) 按钮。
选择 Execution history (执行历史记录) 选项卡。
选择要查看其资源级别执行详细信息的关联。例如，选择显示 Failed (失败) 状态的关联。然后，您可以查看无法运行关联的节点的执行详细信息。

使用搜索框筛选条件以找到要查看其详细信息的执行。
选择执行 ID。此时将打开 Association execution targets (关联执行目标) 页面。此页面显示所有已运行关联的资源。
选择一个资源 ID 以查看有关此资源的特定信息。

使用搜索框筛选条件以找到要查看其详细信息的资源。
如果您正在调查无法运行的关联，则在创建时可使用 Apply association now (立即应用关联) 按钮来运行一次关联。在对无法运行关联的资源进行更改后，在导航位置提示中选择 Association ID (关联 ID) 链接。
选择 Apply association now (立即应用关联) 按钮。在执行完成后，验证关联执行是否成功。

查看关联历史记录（命令行）

以下过程介绍了如何使用 AWS Command Line Interface (AWS CLI)（在 Linux 或 Windows 上）或 AWS Tools for PowerShell 查看特定关联 ID 的执行历史记录。然后，该过程介绍了如何查看一个或多个资源的执行详细信息。

查看特定关联 ID 的执行历史记录

安装并配置 AWS CLI 或 AWS Tools for PowerShell（如果尚未执行该操作）。

有关信息，请参阅安装或更新 AWS CLI 的最新版本以及安装 AWS Tools for PowerShell。

运行以下命令以查看特定关联 ID 的执行列表。

系统将返回类似于以下内容的信息。

Linux & macOS

{
   "AssociationExecutions":[
      {
         "Status":"Success",
         "DetailedStatus":"Success",
         "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE",
         "ExecutionId":"76a5a04f-caf6-490c-b448-92c02EXAMPLE",
         "CreatedTime":1523986028.219,
         "AssociationVersion":"1"
      },
      {
         "Status":"Success",
         "DetailedStatus":"Success",
         "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE",
         "ExecutionId":"791b72e0-f0da-4021-8b35-f95dfEXAMPLE",
         "CreatedTime":1523984226.074,
         "AssociationVersion":"1"
      },
      {
         "Status":"Success",
         "DetailedStatus":"Success",
         "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE",
         "ExecutionId":"ecec60fa-6bb0-4d26-98c7-140308EXAMPLE",
         "CreatedTime":1523982404.013,
         "AssociationVersion":"1"
      }
   ]
}

Windows

{
   "AssociationExecutions":[
      {
         "Status":"Success",
         "DetailedStatus":"Success",
         "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE",
         "ExecutionId":"76a5a04f-caf6-490c-b448-92c02EXAMPLE",
         "CreatedTime":1523986028.219,
         "AssociationVersion":"1"
      },
      {
         "Status":"Success",
         "DetailedStatus":"Success",
         "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE",
         "ExecutionId":"791b72e0-f0da-4021-8b35-f95dfEXAMPLE",
         "CreatedTime":1523984226.074,
         "AssociationVersion":"1"
      },
      {
         "Status":"Success",
         "DetailedStatus":"Success",
         "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE",
         "ExecutionId":"ecec60fa-6bb0-4d26-98c7-140308EXAMPLE",
         "CreatedTime":1523982404.013,
         "AssociationVersion":"1"
      }
   ]
}

PowerShell

AssociationId         : c336d2ab-09de-44ba-8f6a-6136cEXAMPLE
AssociationVersion    : 1
CreatedTime           : 8/18/2019 2:00:50 AM
DetailedStatus        : Success
ExecutionId           : 76a5a04f-caf6-490c-b448-92c02EXAMPLE
LastExecutionDate     : 1/1/0001 12:00:00 AM
ResourceCountByStatus : {Success=1}
Status                : Success

AssociationId         : c336d2ab-09de-44ba-8f6a-6136cEXAMPLE
AssociationVersion    : 1
CreatedTime           : 8/11/2019 2:00:54 AM
DetailedStatus        : Success
ExecutionId           : 791b72e0-f0da-4021-8b35-f95dfEXAMPLE
LastExecutionDate     : 1/1/0001 12:00:00 AM
ResourceCountByStatus : {Success=1}
Status                : Success

AssociationId         : c336d2ab-09de-44ba-8f6a-6136cEXAMPLE
AssociationVersion    : 1
CreatedTime           : 8/4/2019 2:01:00 AM
DetailedStatus        : Success
ExecutionId           : ecec60fa-6bb0-4d26-98c7-140308EXAMPLE
LastExecutionDate     : 1/1/0001 12:00:00 AM
ResourceCountByStatus : {Success=1}
Status                : Success

您可以使用一个或多个筛选条件来限制结果。以下示例返回在特定日期和时间之前运行的所有关联。

下面返回在特定日期和时间之后成功运行的所有关联。

运行以下命令可查看已运行特定执行的所有目标。

您可以使用一个或多个筛选条件来限制结果。以下示例返回有关所有无法运行特定关联的目标的信息。

以下示例返回有关无法运行关联的特定托管式节点的信息。

如果您正在调查无法运行的关联，则可使用 StartAssociationsOnce API 操作来立即运行且仅运行一次关联。在更改关联无法运行的资源后，运行以下命令以立即运行关联，并且仅运行一次。
Linux & macOS
```
aws ssm start-associations-once \
  --association-id ID 
```
Windows
```
aws ssm start-associations-once ^
  --association-id ID 
```
PowerShell
```
Start-SSMAssociationsOnce `
  -AssociationId ID 
```

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

运行 Auto Scaling 组

使用 IAM 处理关联