associateApplicationStatusCheck

Associates an application status check with instances or tags. Once you create an association, health monitoring automatically begins for the specified instances or for instances that match the specified tags. The following rules apply:

  • You must specify either TargetTagAssociations or InstanceIds, but not both. Specifying both results in an InvalidParameterCombination error.

  • You must own the application status check. The check must already exist in your account.

  • You must not leave tag keys blank.

  • You can create a maximum of 50 tag associations for each application status check.

  • You can use DisassociateApplicationStatusCheck to remove associations.

  • You can associate tags so that the application status check automatically monitors all current and future instances that have the specified tags.

Samples

// This example associates an application status check with instances matching the specified tag.
val resp = ec2Client.associateApplicationStatusCheck {
    applicationStatusCheckId = "asc-0123456789abcdef0"
    targetTagAssociations = listOf<CustomTagKeyValueRequestPair>(
        CustomTagKeyValueRequestPair {
            key = "env"
            value = "prod"
        }            
    )
}