本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
您可以使用 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://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 Tools for PowerShell如果您尚未安裝和設定 AWS CLI 或 。
如需相關資訊,請參閱安裝或更新 AWS CLI的最新版本和安裝 AWS Tools for PowerShell。
-
執行以下命令來檢視特定關聯 ID 的執行清單。
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
值。系統會傳回相關資訊,如下所示。
{ "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" } ] }
您可以使用一或多個篩選條件來限制結果。以下範例傳回所有於特定日期和時間之前執行的關聯。
aws ssm describe-association-executions \ --association-id
ID
\ --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=LESS_THAN以下範例傳回所有於特定日期和時間之後成功執行的關聯。
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 -
執行以下命令來檢視執行特定執行的所有目標。
aws ssm describe-association-execution-targets \ --association-id
ID
\ --execution-idID
您可以使用一或多個篩選條件來限制結果。以下範例傳回所有執行特定關聯失敗的目標相關資訊。
aws ssm describe-association-execution-targets \ --association-id
ID
\ --execution-idID
\ --filters Key=Status,Value="Failed"以下範例傳回執行關聯失敗的特定受管節點相關資訊。
aws ssm describe-association-execution-targets \ --association-id
ID
\ --execution-idID
\ --filters Key=Status,Value=Failed Key=ResourceId,Value="i-02573cafcfEXAMPLE
" Key=ResourceType,Value=ManagedInstance -
若您正在調查執行失敗的關聯,您可以使用 StartAssociationsOnce API 操作來立即執行關聯 (僅限一次)。在您變更關聯執行失敗的資源後,請執行以下命令來立即執行關聯,並僅限一次。
aws ssm start-associations-once \ --association-id
ID