參考：ec2messages、ssmmessages 和其他API操作 - AWS Systems Manager
客服人員相關API操作 （ssmmessages 和 ec2messages 端點）ssm:* 命名空間執行個體相關API操作

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

參考：ec2messages、ssmmessages 和其他API操作

如果您監控API操作，您可能會看到對下列操作的呼叫：

  • ec2messages:AcknowledgeMessage

  • ec2messages:DeleteMessage

  • ec2messages:FailMessage

  • ec2messages:GetEndpoint

  • ec2messages:GetMessages

  • ec2messages:SendReply

  • ssmmessages:CreateControlChannel

  • ssmmessages:CreateDataChannel

  • ssmmessages:OpenControlChannel

  • ssmmessages:OpenDataChannel

  • ssm:DescribeDocumentParameters

  • ssm:DescribeInstanceProperties

  • ssm:GetCalendar

  • ssm:GetManifest

  • ssm:ListInstanceAssociations

  • ssm:PutCalendar

  • ssm:PutConfigurePackageResult

  • ssm:RegisterManagedInstance

  • ssm:RequestManagedInstanceRoleToken

  • ssm:UpdateInstanceAssociationStatus

  • ssm:UpdateInstanceInformation

  • ssm:UpdateManagedInstancePublicKey

這些是 使用的特殊操作 AWS Systems Manager，如本主題的其餘部分所述。

客服人員相關API操作 （ssmmessages 和 ec2messages 端點）

ssmmessages API操作

Systems Manager 會將ssmmessages端點用於下列類型的API操作：

  • Systems Manager Agent 的操作 （SSM Agent） 至雲端中的 Systems Manager 服務。

  • 來自 的操作 SSM Agent 至 Session Manager， 是 AWS Systems Manager雲端中的 功能。此端點是使用 建立和刪除工作階段頻道的必要項目 Session Manager 雲端中的 服務。此外，如果允許連線，SSM Agent 透過此 接收Command文件 Amazon Message Gateway Service。 如果不允許連線，SSM Agent 透過 接收Command文件 Amazon Message Delivery Service。 如需詳細資訊，請參閱 的動作、資源和條件索引鍵 Amazon Message Gateway Service.

  • 來自 的操作 Run Command.

ec2messages API操作

ec2messages:* API 操作會對 Amazon Message Delivery Service 端點。Systems Manager 將此端點用於 API Systems Manager Agent （SSM Agent） 至雲端中的 Systems Manager 服務。

重要

ec2messages:* API 操作僅在 2024 年之前啟動 AWS 區域 的 中受支援。在 2024 年及之後啟動的區域中，僅支援 ssmmessages:* API 操作。

端點連線優先順序

從 3.3.40.0 版開始 SSM Agent，Systems Manager 開始使用ssmmessages:*端點 （Amazon Message Gateway Service） 隨時可用，而不是ec2messages:*端點 （Amazon Message Delivery Service).

如果您在 AWS Identity and Access Management （IAM） 許可政策ssmmessages:*中提供對 的存取權，SSM Agent 會連線至ssmmessages:*端點，即使您的IAM執行個體設定檔設定為允許兩個端點。這包括您自行建立的IAM執行個體設定檔IAM和服務角色的政策，以及 建立的IAM執行個體設定檔的政策 Quick Setup 主機管理組態和預設主機管理組態 。

如果您已提供兩個端點的許可，並使用例如 CloudWatch 指標監控API操作，則不會看到對 的呼叫ec2messages:*。

2024 年之前 AWS 區域 啟動的 ：您現在可以安全地從政策中移除ec2messages:*許可。

端點連線容錯移轉

僅適用於 2024 年之前 AWS 區域 啟動的：如果您的IAM執行個體設定檔ssmmessages:*在代理程式啟動時未提供 的許可，但僅 ec2messages:*，SSM Agent 會連線至ec2messages:*端點。如果您同時擁有 ssmmessages:*和 ec2messages:* ，SSM Agent 會啟動，但在客服人員啟動ssmmessages:*後移除，SSM Agent 很快就會切換到ec2messages:*端點的連線。對於 2024 年及之後啟動的區域，僅支援ssmmessages:*端點。

如需 ssmmessages和 ec2messages:*端點的詳細資訊，請參閱AWS 服務授權參考 中的下列主題。

ssm:* 命名空間執行個體相關API操作

DescribeDocumentParameters

Systems Manager 執行此操作API以在 Amazon EC2主控台中轉譯特定節點。DescribeDocumentParameters 操作的結果會顯示在文件節點中。

DescribeInstanceProperties

Systems Manager 會執行此操作API，以在 Amazon EC2主控台中轉譯特定節點。DescribeInstanceProperties 操作的結果會顯示在 中 Fleet Manager 節點。

GetCalendar

Systems Manager 執行API此操作以轉譯 Change Calendar 在 中輸入文件 Change Calendar 主控台。

GetManifest

SSM Agent 會執行此操作API來判斷安裝或更新指定版本AWS Systems Manager Distributor套件的系統需求。此為舊版API操作，不適用於 2017 年之後 AWS 區域 推出的 。

ListInstanceAssociations

SSM Agent 會執行此操作API，以查看是否有新的 State Manager 關聯可用。需要API此操作才能 State Manager 以運作。

PutCalendar

Systems Manager 執行API此操作以更新 Change Calendar 在 中輸入文件 Change Calendar 主控台。

PutConfigurePackageResult

SSM Agent 會執行此操作API，將公有經銷商套件的安裝錯誤和延遲指標發佈至套件擁有者的帳戶。

RegisterManagedInstance

SSM Agent 針對下列案例執行API此操作：

  • 使用啟用碼和 ID，向 Systems Manager 註冊內部部署伺服器或虛擬機器 （VM） 作為受管執行個體。

  • 註冊 AWS IoT Greengrass Version 2 憑證。

執行中的 Amazon EC2執行個體也會呼叫此操作 SSM Agent 3.1.x 版或更新版本。

RequestManagedInstanceRoleToken

SSM Agent 會執行此操作API來擷取臨時憑證，以存取受管節點。

UpdateInstanceAssociationStatus

SSM Agent 會執行此操作API來更新關聯。需要API此操作才能 State Manager，一種 功能 AWS Systems Manager，可運作。

UpdateInstanceInformation

SSM Agent 每 5 分鐘呼叫一次雲端中的 Systems Manager 服務，以提供活動訊號資訊。必須要有此呼叫維持與代理程式的活動訊號，讓服務知道代理程式運作正常。

UpdateManagedInstancePublicKey

SSM Agent 在受管節點上輪換金鑰對後， 會執行此操作API以提供公有金鑰。公有金鑰用於驗證使用私有金鑰簽署的請求，以便從 Systems Manager 取得臨時憑證。