Editar uma associação (console)Editar uma associação (linha de comando)

Edita e criar uma nova versão de uma associação

Você pode editar uma associação do State Manager para especificar um novo nome, agendamento, nível de gravidade, destinos ou outros valores. Para associações baseadas em documentos do tipo SSM Command, você pode também optar por gravar a saída do comando em um bucket do Amazon Simple Storage Service (Amazon S3). Depois de editar uma associação, o State Manager cria uma nova versão. Você pode visualizar diferentes versões após a edição, conforme descrito nos seguintes procedimentos.

Os procedimentos a seguir descrevem como editar e criar uma nova versão de uma associação usando o console do Systems Manager, a AWS Command Line Interface (AWS CLI) e o AWS Tools for PowerShell (Tools for PowerShell).

Importante

O State Manager não é compatível com a execução de associações que usam uma nova versão de um documento se esse documento for compartilhado de outra conta. O State Manager sempre executa a versão default de um documento se ele for compartilhado de outra conta, mesmo que o console do Systems Manager mostre que uma nova versão foi processada. Se você quiser executar uma associação usando uma nova versão de um documento compartilhado de outra conta, você deverá definir a versão do documento como default.

Editar uma associação (console)

O seguinte procedimento descreve como usar o console do Systems Manager para editar e criar uma nova versão de uma associação.

nota

Para associações que usam documentos do SSM Command, não runbooks do Automation, esse procedimento exige que você tenha acesso de gravação a um bucket do Amazon S3 existente. Se você nunca usou o Amazon S3 antes, não será cobrado por alterações pelo uso do Amazon S3. Para obter informações sobre como criar um bucket, consulte Criar um bucket.

Para editar uma associação do State Manager

Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.
No painel de navegação, escolha State Manager.
Escolha uma associação existente e, em seguida, Edit.
Reconfigure a associação para atender aos seus requisitos atuais.

Para obter informações sobre opções de associação com documentos Command e Policy, consulte Criar associações. Para obter informações sobre opções de associação com runbooks do Automation, consulte Programação de automações com associações do State Manager.
Escolha Save Changes (Salvar alterações).
(Opcional) Para ver informações de associação, na página Associations, escolha o nome da associação que você editou e depois escolha Versions. O sistema lista cada versão da associação que você criou e editou.
(Opcional) Para ver a saída de associações com base em documentos do SSM Command, faça o seguinte:
1. Abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.
2. Selecione o nome do bucket do Amazon S3 que você especificou para armazenamento da saída de comando e, em seguida, escolha a pasta denominada com o ID do nó que executou a associação. (Se tiver optado por armazenar a saída em uma pasta no bucket, abra-a primeiro.)
3. Desça vários níveis na hierarquia da pasta awsrunPowerShell, até o arquivo stdout.
4. Escolha Open (Abrir) ou Download (Fazer download) para visualizar o nome do host.

Editar uma associação (linha de comando)

O seguinte procedimento descreve como usar a AWS CLI (no Linux ou no Windows) ou o AWS Tools for PowerShell para editar e criar uma nova versão de uma associação.

Para editar uma associação do State Manager

Instale e configure a AWS CLI ou o AWS Tools for PowerShell, caso ainda não o tenha feito.

Para obter informações, consulte Instalar ou atualizar a versão mais recente da AWS CLI e Instalar o AWS Tools for PowerShell.

Use o seguinte formato para criar um comando para editar e criar uma nova versão de uma associação existente do State Manager. Substitua cada espaço reservado para recurso de exemplo por suas próprias informações.

Importante

Quando você chama o update-association, o sistema descarta todos os parâmetros opcionais da solicitação e substitui a associação com valores nulos para esses parâmetros. Isso faz parte do design. Você deve especificar todos os parâmetros opcionais na chamada, mesmo se você não estiver alterando os parâmetros. Isso inclui o parâmetro --name. Antes de chamar essa ação, recomendamos que você chame a operação de API describe-association e anote todos os parâmetros opcionais necessários para a chamada 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 \
    --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 ^
    --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 `
    -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

O seguinte exemplo atualiza uma associação existente para alterar o nome para TestHostnameAssociation2. A nova versão de associação é executada a cada hora e grava a saída de comandos no bucket do Amazon S3 especificado.

O seguinte exemplo atualiza uma associação existente para alterar o nome para CalendarAssociation. A nova associação é executada quando o calendário está aberto e grava a saída do comando no bucket do Amazon S3 especificado.

O seguinte exemplo atualiza uma associação existente para alterar o nome para MultiCalendarAssociation. A nova associação é executada quando os calendários estão abertos e grava a saída do comando no bucket do Amazon S3 especificado.

Para visualizar a nova versão da associação, execute o seguinte comando.

O sistema retorna informações como estas.

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}

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Criar associações

Excluir associações