查看关联历史记录 - Amazon Web Services Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

查看关联历史记录

您可以使用特定关联 ID 的所有执行,方法是使用DescribeAssociationExecutionsAPI 操作。此操作可让您查看状态、详细状态、结果、上次执行时间以及有关状态 Manager 关联的详细信息。此 API 操作还包括筛选器,帮助您根据指定的条件找到关联。例如,您可以指定确切的日期和时间,并使用 GREATER_THAN 筛选器查看在指定的日期和时间之后处理的执行。

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

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

查看关联历史记录(控制台)

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

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

  1. 打开Amazon Web Services Systems Manager控制台,位于https://console.aws.amazon.com/systems-manager/

  2. 选择状态管理器

  3. Association id (关联 ID) 字段中,选择要查看其历史记录的关联。

  4. 选择 View details (查看详细信息) 按钮。

  5. 选择 Execution history (执行历史记录) 选项卡。

  6. 选择要查看其资源级别执行详细信息的关联。例如,选择显示 Failed (失败) 状态的关联。然后,您可以查看无法运行关联的实例的执行详细信息。

    注意

    使用搜索框筛选条件以找到要查看其详细信息的执行。

    
                                    筛选 State Manager 关联执行的列表。
  7. 选择执行 ID。此时将打开 Association execution targets (关联执行目标) 页面。此页面显示所有已运行关联的资源。

  8. 选择一个资源 ID 以查看有关此资源的特定信息。

    注意

    使用搜索框筛选条件以找到要查看其详细信息的资源。

    
                                    筛选 State Manager 关联执行目标的列表。
  9. 如果您正在调查无法运行的关联,则可使用立即应用关联按钮可在创建时运行一次关联。在对无法运行关联的资源进行更改后,在导航位置提示中选择 Association ID (关联 ID) 链接。

  10. 选择 Apply association now (立即应用关联) 按钮。在执行完成后,验证关联执行是否成功。

查看关联历史记录(命令行)

以下过程介绍如何使用Amazon命令行界面 (AmazonCLI)(在 Linux 或 Windows 上)或AmazonTools for PowerShell 查看特定关联 ID 的执行历史记录的工具。然后,该过程介绍了如何查看一个或多个资源的执行详细信息。

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

  1. 安装和配置AmazonCLI 或AmazonTools for PowerShell,如果您还没有。

    想要了解有关信息,请参阅安装或升级Amazon命令行工具

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

    Linux & macOS
    aws ssm describe-association-executions \ --association-id ID \ --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN
    注意

    此命令包含一个筛选器,可将结果限定为仅在特定日期和时间之后发生的那些执行。如果要查看特定关联 ID 的所有执行,请删除 --filters 参数和 Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN 值。

    Windows
    aws ssm describe-association-executions ^ --association-id ID ^ --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN
    注意

    此命令包含一个筛选器,可将结果限定为仅在特定日期和时间之后发生的那些执行。如果要查看特定关联 ID 的所有执行,请删除 --filters 参数和 Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN 值。

    PowerShell
    Get-SSMAssociationExecution ` -AssociationId ID ` -Filter @{"Key"="CreatedTime";"Value"="2019-06-01T19:15:38.372Z";"Type"="GREATER_THAN"}
    注意

    此命令包含一个筛选器,可将结果限定为仅在特定日期和时间之后发生的那些执行。如果要查看特定关联 ID 的所有执行,请删除 -Filter 参数和 @{"Key"="CreatedTime";"Value"="2019-06-01T19:15:38.372Z";"Type"="GREATER_THAN"} 值。

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

    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

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

    Linux & macOS
    aws ssm describe-association-executions \ --association-id ID \ --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=LESS_THAN
    Windows
    aws ssm describe-association-executions ^ --association-id ID ^ --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=LESS_THAN
    PowerShell
    Get-SSMAssociationExecution ` -AssociationId 14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE ` -Filter @{"Key"="CreatedTime";"Value"="2019-06-01T19:15:38.372Z";"Type"="LESS_THAN"}

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

    Linux & macOS
    aws ssm describe-association-executions \ --association-id ID \ --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN Key=Status,Value=Success,Type=EQUAL
    Windows
    aws ssm describe-association-executions ^ --association-id ID ^ --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN Key=Status,Value=Success,Type=EQUAL
    PowerShell
    Get-SSMAssociationExecution ` -AssociationId 14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE ` -Filter @{ "Key"="CreatedTime"; "Value"="2019-06-01T19:15:38.372Z"; "Type"="GREATER_THAN" }, @{ "Key"="Status"; "Value"="Success"; "Type"="EQUAL" }
  3. 运行以下命令可查看已运行特定执行的所有目标。

    Linux & macOS
    aws ssm describe-association-execution-targets \ --association-id ID \ --execution-id ID
    Windows
    aws ssm describe-association-execution-targets ^ --association-id ID ^ --execution-id ID
    PowerShell
    Get-SSMAssociationExecutionTarget ` -AssociationId 14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE ` -ExecutionId 76a5a04f-caf6-490c-b448-92c02EXAMPLE

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

    Linux & macOS
    aws ssm describe-association-execution-targets \ --association-id ID \ --execution-id ID \ --filters Key=Status,Value="Failed"
    Windows
    aws ssm describe-association-execution-targets ^ --association-id ID ^ --execution-id ID ^ --filters Key=Status,Value="Failed"
    PowerShell
    Get-SSMAssociationExecutionTarget ` -AssociationId 14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE ` -ExecutionId 76a5a04f-caf6-490c-b448-92c02EXAMPLE ` -Filter @{ "Key"="Status"; "Value"="Failed" }

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

    Linux & macOS
    aws ssm describe-association-execution-targets \ --association-id ID \ --execution-id ID \ --filters Key=Status,Value=Failed Key=ResourceId,Value="i-02573cafcfEXAMPLE" Key=ResourceType,Value=ManagedInstance
    Windows
    aws ssm describe-association-execution-targets ^ --association-id ID ^ --execution-id ID ^ --filters Key=Status,Value=Failed Key=ResourceId,Value="i-02573cafcfEXAMPLE" Key=ResourceType,Value=ManagedInstance
    PowerShell
    Get-SSMAssociationExecutionTarget ` -AssociationId 14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE ` -ExecutionId 76a5a04f-caf6-490c-b448-92c02EXAMPLE ` -Filter @{ "Key"="Status"; "Value"="Success" }, @{ "Key"="ResourceId"; "Value"="i-02573cafcfEXAMPLE" }, @{ "Key"="ResourceType"; "Value"="ManagedInstance" }
  4. 如果您正在调查无法运行的关联,则可使用StartAssociationsOnceAPI 操作立即运行且仅运行一次关联。在更改关联无法运行的资源后,运行以下命令以立即运行关联,并且仅运行一次。

    Linux & macOS
    aws ssm start-associations-once \ --association-id ID
    Windows
    aws ssm start-associations-once ^ --association-id ID
    PowerShell
    Start-SSMAssociationsOnce ` -AssociationId ID