• 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à. # Modifica e creazione di una nuova versione di un'associazione È possibile modificare un'associazione di State Manager per specificare un nome, una pianificazione, un livello di gravità, destinazioni e nuovi valori. Per le associazioni basate su Command-type documenti SSM, puoi anche scegliere di scrivere l'output del comando in un bucket Amazon Simple Storage Service (Amazon S3). Dopo la modifica di un'associazione, State Manager crea una nuova versione. È possibile visualizzare diverse versioni dopo la modifica, come descritto nelle procedure seguenti. **Nota** Affinché le associazioni create con i runbook Automation vengano applicate quando vengono rilevati nuovi nodi di destinazione, è necessario che vengano soddisfatte determinate condizioni. Per informazioni, consulta [Informazioni sugli aggiornamenti di destinazione con i runbook Automation](state-manager-about.md#runbook-target-updates). Le procedure seguenti descrivono come modificare e creare una nuova versione di un'associazione utilizzando la console Systems Manager, AWS Command Line Interface (AWS CLI) e AWS Strumenti per PowerShell (Tools for PowerShell). **Importante** State Manager non supporta associazioni in esecuzione che utilizzano una nuova versione di un documento se tale documento è condiviso da un altro account. State Manager gestisce sempre la versione `default` di un documento se condivisa da un altro account, anche se la console di Systems Manager mostra che è stata elaborata una nuova versione. Se si desidera eseguire un'associazione utilizzando una nuova versione di un documento condiviso da un altro account, è necessario impostare la versione del documento su `default`. ## Modifica di un'associazione (console) La procedura seguente descrive come utilizzare la console di Systems Manager per modificare e creare una nuova versione di un'associazione. **Nota** Per le associazioni che utilizzano documenti SSM Command e non runbook Automation, per svolgere questa procedura è necessario disporre dell'accesso in scrittura a un bucket Amazon S3 esistente. Se non hai mai utilizzato Amazon S3, tieni presente che ti saranno addebitati costi per l'utilizzo. Per informazioni su come creare un bucket, consulta [Crea un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingABucket.html). **Per modificare un'associazione di State Manager** 1. Aprire la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. Nel pannello di navigazione, scegli **State Manager**. 1. Scegliere un'associazione esistente, quindi **Modifica**. 1. Riconfigurare l'associazione per soddisfare i requisiti correnti. Per informazioni sulle opzioni di associazione sui documenti `Command` e `Policy`, consulta [Creazione di associazioni](state-manager-associations-creating.md). Per informazioni sulle opzioni di associazione con i runbook Automation, consulta [Pianificazione di automazioni con associazioni State Manager](scheduling-automations-state-manager-associations.md). 1. Scegli **Salva modifiche**. 1. (Facoltativo) Per visualizzare le informazioni sull'associazione, nella pagina **Associations (Associazioni)**, scegliere il nome dell'associazione modificata, quindi selezionare la scheda **Versions (Versioni)**. Il sistema elenca tutte le versioni dell'associazione create e modificate. 1. (Facoltativo) Per visualizzare l'output delle associazioni basate su documenti SSM `Command`, procedi come segue: 1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 1. Scegliere il nome del bucket Amazon S3 specificato per archiviare l'output del comando, quindi selezionare la cartella denominata con l'ID del nodo che ha eseguito l'associazione. Se è stato scelto di archiviare l'output in una cartella del bucket, aprire innanzitutto tale cartella. 1. Eseguire il drill-down su diversi livelli nella cartella `awsrunPowerShell` fino al file `stdout`. 1. Per visualizzare il nome host, scegliere **Open (Apri)** o **Download (Scarica)**. ## Modifica di un'associazione (riga di comando) La procedura seguente descrive come utilizzare AWS CLI (su Linux oWindows Server) o AWS Strumenti per PowerShell modificare e creare una nuova versione di un'associazione. **Per modificare un'associazione di State Manager** 1. Installa e configura il AWS CLI o il AWS Strumenti per PowerShell, se non l'hai già fatto. Per informazioni, consulta le pagine [Installazione o aggiornamento della versione più recente di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) e [Installazione di AWS Strumenti per PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html). 1. Utilizza il formato seguente per creare un comando per modificare e creare una nuova versione di un'associazione State Manager esistente. Sostituisci ogni {{example resource placeholder}} con le tue informazioni. **Importante** Quando chiami `[https://docs.aws.amazon.com/cli/latest/reference/ssm/desupdatecribe-association.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/desupdatecribe-association.html)`, il sistema elimina tutti i parametri opzionali dalla richiesta e sovrascrive l'associazione con valori nulli per tali parametri. Si tratta di un'impostazione predefinita. È necessario specificare tutti i parametri opzionali nella chiamata, anche se non si modificano i parametri. Questo include il parametro `--name`. Prima di chiamare questa azione, consigliamo di chiamare l'operazione `[https://docs.aws.amazon.com/cli/latest/reference/ssm/describe-association.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/describe-association.html)` e prendere nota di tutti i parametri opzionali richiesti per la chiamata `update-association`. ------ #### [ Linux & macOS ] ``` aws ssm update-association \ --name {{document_name}} \ --document-version {{version_of_document_applied}} \ --instance-id {{instances_to_apply_association_on}} \ --parameters {{(if any)}} \ --targets {{target_options}} \ --association-dispatch-assume-role {{arn_of_role_to_be_used_when_dispatching_configurations}} \ --schedule-expression "{{cron_or_rate_expression}}" \ --schedule-offset "{{number_between_1_and_6}}" \ --output-location {{s3_bucket_to_store_output_details}} \ --association-name {{association_name}} \ --max-errors {{a_number_of_errors_or_a_percentage_of_target_set}} \ --max-concurrency {{a_number_of_instances_or_a_percentage_of_target_set}} \ --compliance-severity {{severity_level}} \ --calendar-names {{change_calendar_names}} \ --target-locations {{aws_region_or_account}} ``` ------ #### [ Windows ] ``` aws ssm update-association ^ --name {{document_name}} ^ --document-version {{version_of_document_applied}} ^ --instance-id {{instances_to_apply_association_on}} ^ --parameters {{(if any)}} ^ --targets {{target_options}} ^ --association-dispatch-assume-role {{arn_of_role_to_be_used_when_dispatching_configurations}} ^ --schedule-expression "{{cron_or_rate_expression}}" ^ --schedule-offset "{{number_between_1_and_6}}" ^ --output-location {{s3_bucket_to_store_output_details}} ^ --association-name {{association_name}} ^ --max-errors {{a_number_of_errors_or_a_percentage_of_target_set}} ^ --max-concurrency {{a_number_of_instances_or_a_percentage_of_target_set}} ^ --compliance-severity {{severity_level}} ^ --calendar-names {{change_calendar_names}} ^ --target-locations {{aws_region_or_account}} ``` ------ #### [ PowerShell ] ``` Update-SSMAssociation ` -Name {{document_name}} ` -DocumentVersion {{version_of_document_applied}} ` -InstanceId {{instances_to_apply_association_on}} ` -Parameters {{(if any)}} ` -Target {{target_options}} ` -AssociationDispatchAssumeRole {{arn_of_role_to_be_used_when_dispatching_configurations}} ` -ScheduleExpression "{{cron_or_rate_expression}}" ` -ScheduleOffset "{{number_between_1_and_6}}" ` -OutputLocation {{s3_bucket_to_store_output_details}} ` -AssociationName {{association_name}} ` -MaxError {{ a_number_of_errors_or_a_percentage_of_target_set}} -MaxConcurrency {{a_number_of_instances_or_a_percentage_of_target_set}} ` -ComplianceSeverity {{severity_level}} ` -CalendarNames {{change_calendar_names}} ` -TargetLocations {{aws_region_or_account}} ``` ------ L'esempio seguente aggiorna un'associazione esistente per modificare il nome in `TestHostnameAssociation2`. La nuova versione di associazione viene eseguita ogni ora e scrive l'output dei comandi nel bucket Amazon S3 specificato. ------ #### [ Linux & macOS ] ``` aws ssm update-association \ --association-id 8dfe3659-4309-493a-8755-01234EXAMPLE \ --association-name TestHostnameAssociation2 \ --parameters commands="echo Association" \ --association-dispatch-assume-role arn:aws:iam::123456789012:role/myAssociationDispatchAssumeRole \ --output-location S3Location='{OutputS3Region=us-east-1,OutputS3BucketName=amzn-s3-demo-bucket,OutputS3KeyPrefix=logs}' \ --schedule-expression "cron(0 */1 * * ? *)" ``` ------ #### [ Windows ] ``` aws ssm update-association ^ --association-id 8dfe3659-4309-493a-8755-01234EXAMPLE ^ --association-name TestHostnameAssociation2 ^ --parameters commands="echo Association" ^ --association-dispatch-assume-role arn:aws:iam::123456789012:role/myAssociationDispatchAssumeRole ^ --output-location S3Location='{OutputS3Region=us-east-1,OutputS3BucketName=amzn-s3-demo-bucket,OutputS3KeyPrefix=logs}' ^ --schedule-expression "cron(0 */1 * * ? *)" ``` ------ #### [ PowerShell ] ``` Update-SSMAssociation ` -AssociationId b85ccafe-9f02-4812-9b81-01234EXAMPLE ` -AssociationName TestHostnameAssociation2 ` -Parameter @{"commands"="echo Association"} ` -AssociationDispatchAssumeRole "arn:aws:iam::123456789012:role/myAssociationDispatchAssumeRole" ` -S3Location_OutputS3BucketName amzn-s3-demo-bucket ` -S3Location_OutputS3KeyPrefix logs ` -S3Location_OutputS3Region us-east-1 ` -ScheduleExpression "cron(0 */1 * * ? *)" ``` ------ L'esempio seguente aggiorna un'associazione esistente per modificare il nome in `CalendarAssociation`. La nuova associazione viene eseguita quando il calendario è aperto e scrive l'output del comando nel bucket Amazon S3 specificato. ------ #### [ Linux & macOS ] ``` aws ssm update-association \ --association-id 8dfe3659-4309-493a-8755-01234EXAMPLE \ --association-name CalendarAssociation \ --parameters commands="echo Association" \ --output-location S3Location='{OutputS3Region=us-east-1,OutputS3BucketName=amzn-s3-demo-bucket,OutputS3KeyPrefix=logs}' \ --calendar-names "arn:aws:ssm:us-east-1:123456789012:document/testCalendar2" ``` ------ #### [ Windows ] ``` aws ssm update-association ^ --association-id 8dfe3659-4309-493a-8755-01234EXAMPLE ^ --association-name CalendarAssociation ^ --parameters commands="echo Association" ^ --output-location S3Location='{OutputS3Region=us-east-1,OutputS3BucketName=amzn-s3-demo-bucket,OutputS3KeyPrefix=logs}' ^ --calendar-names "arn:aws:ssm:us-east-1:123456789012:document/testCalendar2" ``` ------ #### [ PowerShell ] ``` Update-SSMAssociation ` -AssociationId b85ccafe-9f02-4812-9b81-01234EXAMPLE ` -AssociationName CalendarAssociation ` -AssociationName OneTimeAssociation ` -Parameter @{"commands"="echo Association"} ` -S3Location_OutputS3BucketName amzn-s3-demo-bucket ` -CalendarNames "arn:aws:ssm:us-east-1:123456789012:document/testCalendar2" ``` ------ L'esempio seguente aggiorna un'associazione esistente per modificare il nome in `MultiCalendarAssociation`. La nuova associazione viene eseguita quando i calendari sono aperti e scrive l'output del comando nel bucket Amazon S3 specificato. ------ #### [ Linux & macOS ] ``` aws ssm update-association \ --association-id 8dfe3659-4309-493a-8755-01234EXAMPLE \ --association-name MultiCalendarAssociation \ --parameters commands="echo Association" \ --output-location S3Location='{OutputS3Region=us-east-1,OutputS3BucketName=amzn-s3-demo-bucket,OutputS3KeyPrefix=logs}' \ --calendar-names "arn:aws:ssm:us-east-1:123456789012:document/testCalendar1" "arn:aws:ssm:us-east-2:123456789012:document/testCalendar2" ``` ------ #### [ Windows ] ``` aws ssm update-association ^ --association-id 8dfe3659-4309-493a-8755-01234EXAMPLE ^ --association-name MultiCalendarAssociation ^ --parameters commands="echo Association" ^ --output-location S3Location='{OutputS3Region=us-east-1,OutputS3BucketName=amzn-s3-demo-bucket,OutputS3KeyPrefix=logs}' ^ --calendar-names "arn:aws:ssm:us-east-1:123456789012:document/testCalendar1" "arn:aws:ssm:us-east-2:123456789012:document/testCalendar2" ``` ------ #### [ PowerShell ] ``` Update-SSMAssociation ` -AssociationId b85ccafe-9f02-4812-9b81-01234EXAMPLE ` -AssociationName MultiCalendarAssociation ` -Parameter @{"commands"="echo Association"} ` -S3Location_OutputS3BucketName amzn-s3-demo-bucket ` -CalendarNames "arn:aws:ssm:us-east-1:123456789012:document/testCalendar1" "arn:aws:ssm:us-east-2:123456789012:document/testCalendar2" ``` ------ 1. Per visualizzare la nuova versione dell'associazione, esegui il comando seguente. ------ #### [ Linux & macOS ] ``` aws ssm describe-association \ --association-id b85ccafe-9f02-4812-9b81-01234EXAMPLE ``` ------ #### [ Windows ] ``` aws ssm describe-association ^ --association-id b85ccafe-9f02-4812-9b81-01234EXAMPLE ``` ------ #### [ PowerShell ] ``` Get-SSMAssociation ` -AssociationId b85ccafe-9f02-4812-9b81-01234EXAMPLE | Select-Object * ``` ------ Il sistema restituisce informazioni simili alle seguenti. ------ #### [ Linux & macOS ] ``` { "AssociationDescription": { "ScheduleExpression": "cron(0 */1 * * ? *)", "OutputLocation": { "S3Location": { "OutputS3KeyPrefix": "logs", "OutputS3BucketName": "amzn-s3-demo-bucket", "OutputS3Region": "us-east-1" } }, "Name": "AWS-RunPowerShellScript", "Parameters": { "commands": [ "echo Association" ] }, "LastExecutionDate": 1559316400.338, "Overview": { "Status": "Success", "DetailedStatus": "Success", "AssociationStatusAggregatedCount": {} }, "AssociationId": "b85ccafe-9f02-4812-9b81-01234EXAMPLE", "DocumentVersion": "$DEFAULT", "LastSuccessfulExecutionDate": 1559316400.338, "LastUpdateAssociationDate": 1559316389.753, "Date": 1559314038.532, "AssociationVersion": "2", "AssociationName": "TestHostnameAssociation2", "Targets": [ { "Values": [ "Windows" ], "Key": "tag:Environment" } ] } } ``` ------ #### [ Windows ] ``` { "AssociationDescription": { "ScheduleExpression": "cron(0 */1 * * ? *)", "OutputLocation": { "S3Location": { "OutputS3KeyPrefix": "logs", "OutputS3BucketName": "amzn-s3-demo-bucket", "OutputS3Region": "us-east-1" } }, "Name": "AWS-RunPowerShellScript", "Parameters": { "commands": [ "echo Association" ] }, "LastExecutionDate": 1559316400.338, "Overview": { "Status": "Success", "DetailedStatus": "Success", "AssociationStatusAggregatedCount": {} }, "AssociationId": "b85ccafe-9f02-4812-9b81-01234EXAMPLE", "DocumentVersion": "$DEFAULT", "LastSuccessfulExecutionDate": 1559316400.338, "LastUpdateAssociationDate": 1559316389.753, "Date": 1559314038.532, "AssociationVersion": "2", "AssociationName": "TestHostnameAssociation2", "Targets": [ { "Values": [ "Windows" ], "Key": "tag:Environment" } ] } } ``` ------ #### [ PowerShell ] ``` AssociationId : b85ccafe-9f02-4812-9b81-01234EXAMPLE AssociationName : TestHostnameAssociation2 AssociationVersion : 2 AutomationTargetParameterName : ComplianceSeverity : Date : 5/31/2019 2:47:18 PM DocumentVersion : $DEFAULT InstanceId : LastExecutionDate : 5/31/2019 3:26:40 PM LastSuccessfulExecutionDate : 5/31/2019 3:26:40 PM LastUpdateAssociationDate : 5/31/2019 3:26:29 PM MaxConcurrency : MaxErrors : Name : AWS-RunPowerShellScript OutputLocation : Amazon.SimpleSystemsManagement.Model.InstanceAssociationOutputLocation Overview : Amazon.SimpleSystemsManagement.Model.AssociationOverview Parameters : {[commands, Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]]} ScheduleExpression : cron(0 */1 * * ? *) Status : Targets : {tag:Environment} ``` ------