• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Referenza: ec2messages, ssmmessages e altre operazioni API Quando si monitorano le operazioni API, è possibile vedere le chiamate alle seguenti operazioni: + `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` Si tratta di operazioni speciali utilizzate da AWS Systems Manager, come descritto nel resto di questo argomento. ## Operazioni API (endpoint `ssmmessages` e `ec2messages`) relative agli agenti **Operazioni API ssmmessages** Systems Manager utilizza l'endpoint `ssmmessages` per i seguenti tipi di operazioni API: + Operazioni dall'agente Systems Manager (SSM Agent) al servizio Systems Manager nel cloud. + Operazioni da SSM Agent a Session Manager AWS Systems Manager, uno strumento nel cloud. Questo endpoint è necessario per creare ed eliminare canali di sessione con il servizio Session Manager in cloud. Inoltre, quando la connettività è consentita, SSM Agent riceve i documenti di `Command` tramite questo Amazon Message Gateway Service. Invece, quando la connettività non è consentita, l'SSM Agent riceve i documenti di `Command` tramite Amazon Message Delivery Service. Per ulteriori informazioni, consulta [Operazioni, risorse e chiavi di condizione per Amazon Message Gateway Service](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonmessagegatewayservice.html). **Nota** Se l'`ssmmessages:OpenControlChannel`autorizzazione viene rimossa dalle policy allegate al profilo dell'istanza IAM o al ruolo del servizio IAM, SSM Agent sul nodo gestito perde la connettività al servizio Systems Manager nel cloud. Tuttavia, può essere necessaria fino a 1 ora prima che una connessione venga interrotta dopo la rimozione dell'autorizzazione. Si tratta dello stesso comportamento che si verifica quando il ruolo dell'istanza IAM o il ruolo del servizio IAM vengono eliminati. Tieni presente che l'`ssmmessages:OpenControlChannel`autorizzazione è inclusa nella policy gestita [Amazon SSMManaged InstanceCore](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonSSMManagedInstanceCore.html), utilizzata nelle istruzioni per [creare un profilo di istanza IAM per le istanze](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-instance-permissions.html#instance-profile-add-permissions) EC2 e per [creare un ruolo di servizio IAM](https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-service-role.html) per le istanze non EC2. + Operazioni da Run Command. **Operazioni API ec2messages** Le operazioni API `ec2messages:*` vengono effettuate per l'endpoint Amazon Message Delivery Service. Systems Manager utilizza questo endpoint per effettuare operazioni API da Systems Manager Agent (SSM Agent) al servizio Systems Manager nel cloud. **Importante** Le operazioni API `ec2messages:*` sono supportate solo nelle Regioni AWS avviate prima del 2024. Nelle regioni avviate dal 2024 in poi, sono supportate solo le operazioni API `ssmmessages:*`. **Priorità delle connessioni all'endpoint** A partire dalla versione 3.3.40.0 dell'SSM Agent, Systems Manager ha iniziato a utilizzare endpoint `ssmmessages:*` (Amazon Message Gateway Service) ogni volta che era disponibile, al posto dell'endpoint `ec2messages:*` (Amazon Message Delivery Service). Se fornisci l'accesso alle `ssmmessages:*` tue politiche di autorizzazione AWS Identity and Access Management (IAM), SSM Agent si connette all'`ssmmessages:*`endpoint, anche se il profilo dell'istanza IAM è configurato per consentire entrambi gli endpoint. Ciò include le policy per i [profili dell'istanza](setup-instance-permissions.md#instance-profile-add-permissions) e i [ruoli di servizio IAM](hybrid-multicloud-service-role.md) creati, nonché per i profili dell'istanza IAM creati dalla [Configurazione di gestione host di Quick Setup](quick-setup-host-management.md) e dalla [Configurazione di gestione host predefinita](quick-setup-default-host-management-configuration.md). Se hai fornito le autorizzazioni per entrambi gli endpoint e monitorato le operazioni delle API utilizzando, ad esempio, CloudWatch Metrics, non vedrai alcuna chiamata a. `ec2messages:*` Per il Regioni AWS lancio precedente al 2024: in questo momento puoi rimuovere in sicurezza `ec2messages:*` le autorizzazioni dalle tue politiche. **Failover della connessione all'endpoint** Solo per Regioni AWS versioni lanciate prima del 2024: se il profilo dell'istanza IAM non fornisce le autorizzazioni `ssmmessages:*` al momento dell'avvio dell'agente, ma si limita a SSM Agent connettersi all'`ec2messages:*`endpoint. `ec2messages:*` Quando si dispone sia di `ssmmessages:*` che di `ec2messages:*` al momento dell'avvio dell'SSM Agent, ma si rimuove `ssmmessages:*` dopo l'avvio dell'agente, SSM Agent passa presto la connessione all'endpoint `ec2messages:*`. Per le regioni avviate dal 2024 in poi, è supportato solo l'endpoint `ssmmessages:*`. Per ulteriori informazioni sugli endpoint `ssmmessages` e `ec2messages:*`, consulta gli argomenti seguenti nella *Referenza sull'autorizzazione del servizio AWS *. + [Operazioni, risorse e chiavi di condizione per Amazon Message Gateway Service](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonmessagegatewayservice.html) (`ssmmessages`). + [Operazioni, risorse e chiavi di condizione per Amazon Message Delivery Service](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonmessagedeliveryservice.html) (`ec2messages:*`) ## Operazioni API relative alle istanze del namespace `ssm:*` `DescribeDocumentParameters` Systems Manager esegue questa operazione API per il rendering di nodi specifici nella console di Amazon EC2. I risultati delle operazioni `DescribeDocumentParameters` sono visualizzati nel nodo Documenti. `DescribeInstanceProperties` Systems Manager esegue queste operazioni API per il rendering di nodi specifici nella console di Amazon EC2. I risultati delle operazioni `DescribeInstanceProperties` sono visualizzati nel nodo Fleet Manager. `GetCalendar` Systems Manager esegue questa operazione API per eseguire il rendering dei documenti di tipo Change Calendar nella console Change Calendar. `GetManifest` SSM Agent esegue questa operazione API per determinare i requisiti di sistema per l'installazione o l'aggiornamento di una versione specificata di un pacchetto [AWS Systems Manager Distributor](distributor.md). Si tratta di un'operazione API legacy e non è disponibile nelle versioni Regioni AWS lanciate dopo il 2017. `ListInstanceAssociations` SSM Agent: avvia questa operazione API per vedere se è disponibile una nuova associazione State Manager. Questa operazione API è necessaria per il funzionamento di State Manager. `PutCalendar` Systems Manager esegue questa operazione API per aggiornare i documenti di tipo Change Calendar nella console Change Calendar. `PutConfigurePackageResult` SSM Agent esegue questa operazione API per pubblicare i parametri degli errori di installazione e latenza per i pacchetti Distributor pubblici sull'account del proprietario del pacchetto. `RegisterManagedInstance` SSM Agent esegue questa operazione API per i seguenti scenari: + Per registrare un server on-premises o macchina virtuale (VM) con Systems Manager come istanza gestita utilizzando un codice di attivazione e un ID. + Per registrare AWS IoT Greengrass Version 2 le credenziali. Questa operazione viene chiamata anche dalle istanze Amazon EC2 che eseguono SSM Agent nella versione 3.1.x o successiva. `RequestManagedInstanceRoleToken` SSM Agent esegue questa operazione API per recuperare le credenziali temporanee per accedere al nodo gestito. `UpdateInstanceAssociationStatus` SSM Agent: esegue questa operazione API per aggiornare un'associazione. Questa operazione API è necessaria per State Manager il funzionamento di AWS Systems Manager uno strumento. `UpdateInstanceInformation` SSM Agent chiama il servizio Systems Manager in cloud ogni cinque minuti per fornire le informazioni di heartbeat. Questa chiamata è necessaria per mantenere l'heartbeat con l'agente in modo che il servizio sappia che l'agente funziona correttamente. `UpdateManagedInstancePublicKey` SSM Agent esegue questa operazione API per fornire la chiave pubblica dopo aver ruotato la coppia di chiavi sul nodo gestito. La chiave pubblica viene utilizzata per autenticare le richieste, firmate con la chiave privata, col fine di ottenere credenziali temporanee da Systems Manager. ## ssm:\$1 namespace per altre operazioni API `ExecuteApi` Gli amministratori delegati di Systems Manager che gestiscono gli OpsItems in OpsCenter richiedono l'accesso a questa operazione API in modo da visualizzare i dettagli su OpsItems tramite diversi Account AWS. In particolare, questa API fornisce a un amministratore delegato l'autorizzazione a visualizzare OpsItem i seguenti dettagli in Console di gestione AWS: OpsItem descrizione, tag, CloudFormation modello, AWS Config modifiche, CloudWatch registri, allarmi ed eventi. AWS CloudTrail Per ulteriori informazioni su come utilizzare gli OpsItems negli account, consulta [(Facoltativo) Configurazione manuale di OpsCenter per la gestione centralizzata di OpsItems su più account](OpsCenter-getting-started-multiple-accounts.md). Per ulteriori informazioni sui dettagli delle risorse correlate per gli OpsItems, consulta [Aggiunta di risorse correlate a un OpsItem](OpsCenter-working-with-OpsItems-adding-related-resources.md).