HEX
Server: Apache
System: Linux vps-cdc32557.vps.ovh.ca 5.15.0-156-generic #166-Ubuntu SMP Sat Aug 9 00:02:46 UTC 2025 x86_64
User: hanode (1017)
PHP: 7.4.33
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare,
Upload Files
File: //lib/python3/dist-packages/awscli/examples/ssm/list-associations.rst
**Example 1: To list your associations for a specific instance**

The following `list-associations` example lists all associations with the AssociationName, UpdateSSMAgent. ::

    aws ssm list-associations /
        --association-filter-list "key=AssociationName,value=UpdateSSMAgent"

Output::

    {
        "Associations": [
            {
                "Name": "AWS-UpdateSSMAgent",
                "InstanceId": "i-1234567890abcdef0",
                "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab",
                "AssociationVersion": "1",
                "Targets": [
                    {
                        "Key": "InstanceIds",
                        "Values": [
                            "i-016648b75dd622dab"
                        ]
                    }
                ],
                "Overview": {
                    "Status": "Pending",
                    "DetailedStatus": "Associated",
                    "AssociationStatusAggregatedCount": {
                        "Pending": 1
                    }
                },
                "ScheduleExpression": "cron(0 00 12 ? * SUN *)",
                "AssociationName": "UpdateSSMAgent"
            }
        ]
    }

For more information, see `Working with associations in Systems Manager <https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-associations.html>`__ in the *Systems Manager User Guide*.

**Example 2: To list your associations for a specific document**

The following `list-associations` example lists all associations for the specified document. ::

    aws ssm list-associations /
        --association-filter-list "key=Name,value=AWS-UpdateSSMAgent"

Output::

    {
        "Associations": [
            {
                "Name": "AWS-UpdateSSMAgent",
                "InstanceId": "i-1234567890abcdef0",
                "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab",
                "AssociationVersion": "1",
                "Targets": [
                    {
                        "Key": "InstanceIds",
                        "Values": [
                            "i-1234567890abcdef0"
                        ]
                    }
                ],
                "LastExecutionDate": 1550505828.548,
                "Overview": {
                    "Status": "Success",
                    "DetailedStatus": "Success",
                    "AssociationStatusAggregatedCount": {
                        "Success": 1
                    }
                },
                "ScheduleExpression": "cron(0 00 12 ? * SUN *)",
                "AssociationName": "UpdateSSMAgent"
            },
        {
                "Name": "AWS-UpdateSSMAgent",
                "InstanceId": "i-9876543210abcdef0",
                "AssociationId": "fbc07ef7-b985-4684-b82b-0123456789ab",
                "AssociationVersion": "1",
                "Targets": [
                    {
                        "Key": "InstanceIds",
                        "Values": [
                            "i-9876543210abcdef0"
                        ]
                    }
                ],
                "LastExecutionDate": 1550507531.0,
                "Overview": {
                    "Status": "Success",
                    "AssociationStatusAggregatedCount": {
                        "Success": 1
                    }
                }
            }
        ]
    }

For more information, see `Working with associations in Systems Manager <https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-associations.html>`__ in the *Systems Manager User Guide*.