describeApplicationStatus

abstract suspend fun describeApplicationStatus(input: DescribeApplicationStatusRequest = DescribeApplicationStatusRequest { }): DescribeApplicationStatusResponse

Describes the application status for the specified instances. Returns the aggregated application health status for each instance. The following rules apply:

  • The instance-level status is derived from all application status checks with the aggregation setting set to included.

  • Use DescribeApplicationStatusChecks to view the configuration of individual checks.

  • Use EnableApplicationStatusCheckSuppression to temporarily suppress health check results from affecting the instance-level status.

Samples

// This example describes the application status for the specified instance.
val resp = ec2Client.describeApplicationStatus {
    instanceIds = listOf<String>(
        "i-0123456789abcdef0"
    )
}
// This example uses a filter to describe impaired application status in a specific Availability Zone.
val resp = ec2Client.describeApplicationStatus {
    filters = listOf<Filter>(
        Filter {
            name = "availability-zone-id"
            values = listOf<String>(
                "use1-az1"
            )
        },
        Filter {
            name = "status"
            values = listOf<String>(
                "impaired"
            )
        }            
    )
    maxResults = 10
}