1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. ec2
  6. ApplicationStatusCheck

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.82.0
published on Monday, Oct 5, 2026 by Pulumi
aws-native logo aws-native logo AWS Cloud Control

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.82.0
published on Monday, Oct 5, 2026 by Pulumi

    An application status check monitors an HTTP or HTTPS endpoint on Amazon EC2 instances and reports application-layer health. Configure a health check with a Protocol, Port, and Path, and then associate it with EC2 instances via AWS::EC2::ApplicationStatusCheckInstanceAssociation or AWS::EC2::ApplicationStatusCheckTagAssociation.

    Create ApplicationStatusCheck Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new ApplicationStatusCheck(name: string, args: ApplicationStatusCheckArgs, opts?: CustomResourceOptions);
    @overload
    def ApplicationStatusCheck(resource_name: str,
                               args: ApplicationStatusCheckArgs,
                               opts: Optional[ResourceOptions] = None)
    
    @overload
    def ApplicationStatusCheck(resource_name: str,
                               opts: Optional[ResourceOptions] = None,
                               port: Optional[int] = None,
                               protocol: Optional[ApplicationStatusCheckProtocol] = None,
                               health_check_paths: Optional[Sequence[ApplicationStatusCheckHealthCheckPathArgs]] = None,
                               aggregation: Optional[ApplicationStatusCheckAggregation] = None,
                               initialization_grace_period_seconds: Optional[int] = None,
                               interval: Optional[int] = None,
                               ip_scope: Optional[ApplicationStatusCheckIpScope] = None,
                               ip_version: Optional[ApplicationStatusCheckIpVersion] = None,
                               path: Optional[str] = None,
                               failure_threshold: Optional[int] = None,
                               device_index: Optional[int] = None,
                               status_code_matcher: Optional[str] = None,
                               success_threshold: Optional[int] = None,
                               tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
                               timeout: Optional[int] = None)
    func NewApplicationStatusCheck(ctx *Context, name string, args ApplicationStatusCheckArgs, opts ...ResourceOption) (*ApplicationStatusCheck, error)
    public ApplicationStatusCheck(string name, ApplicationStatusCheckArgs args, CustomResourceOptions? opts = null)
    public ApplicationStatusCheck(String name, ApplicationStatusCheckArgs args)
    public ApplicationStatusCheck(String name, ApplicationStatusCheckArgs args, CustomResourceOptions options)
    
    type: aws-native:ec2:ApplicationStatusCheck
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_ec2_application_status_check" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args ApplicationStatusCheckArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args ApplicationStatusCheckArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args ApplicationStatusCheckArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ApplicationStatusCheckArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ApplicationStatusCheckArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    ApplicationStatusCheck Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The ApplicationStatusCheck resource accepts the following input properties:

    Port int
    The port used for the health check.
    Protocol Pulumi.AwsNative.Ec2.ApplicationStatusCheckProtocol
    The network protocol used for the health check.
    Aggregation Pulumi.AwsNative.Ec2.ApplicationStatusCheckAggregation
    Whether this check is included in the rolled-up application status.
    DeviceIndex int
    The network interface device index used for the health check.
    FailureThreshold int
    The number of consecutive failed probes required to mark the instance unhealthy.
    HealthCheckPaths List<Pulumi.AwsNative.Ec2.Inputs.ApplicationStatusCheckHealthCheckPath>
    The source/destination network paths used for the health check.
    InitializationGracePeriodSeconds int
    Seconds to wait after instance launch before beginning health checks.
    Interval int
    The interval, in seconds, between health check probes.
    IpScope Pulumi.AwsNative.Ec2.ApplicationStatusCheckIpScope
    The IP scope used for the health check.
    IpVersion Pulumi.AwsNative.Ec2.ApplicationStatusCheckIpVersion
    The IP version used for the health check.
    Path string
    The HTTP path used for the health check.
    StatusCodeMatcher string
    The HTTP status codes considered successful (e.g., "200-299").
    SuccessThreshold int
    The number of consecutive successful probes required to mark the instance healthy.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    Tags to apply to the application status check.
    Timeout int
    The timeout, in seconds, for each health check probe.
    Port int
    The port used for the health check.
    Protocol ApplicationStatusCheckProtocol
    The network protocol used for the health check.
    Aggregation ApplicationStatusCheckAggregation
    Whether this check is included in the rolled-up application status.
    DeviceIndex int
    The network interface device index used for the health check.
    FailureThreshold int
    The number of consecutive failed probes required to mark the instance unhealthy.
    HealthCheckPaths []ApplicationStatusCheckHealthCheckPathArgs
    The source/destination network paths used for the health check.
    InitializationGracePeriodSeconds int
    Seconds to wait after instance launch before beginning health checks.
    Interval int
    The interval, in seconds, between health check probes.
    IpScope ApplicationStatusCheckIpScope
    The IP scope used for the health check.
    IpVersion ApplicationStatusCheckIpVersion
    The IP version used for the health check.
    Path string
    The HTTP path used for the health check.
    StatusCodeMatcher string
    The HTTP status codes considered successful (e.g., "200-299").
    SuccessThreshold int
    The number of consecutive successful probes required to mark the instance healthy.
    Tags TagArgs
    Tags to apply to the application status check.
    Timeout int
    The timeout, in seconds, for each health check probe.
    port number
    The port used for the health check.
    protocol "http" | "https"
    The network protocol used for the health check.
    aggregation "included" | "excluded"
    Whether this check is included in the rolled-up application status.
    device_index number
    The network interface device index used for the health check.
    failure_threshold number
    The number of consecutive failed probes required to mark the instance unhealthy.
    health_check_paths list(object)
    The source/destination network paths used for the health check.
    initialization_grace_period_seconds number
    Seconds to wait after instance launch before beginning health checks.
    interval number
    The interval, in seconds, between health check probes.
    ip_scope "private"
    The IP scope used for the health check.
    ip_version "ipv4" | "ipv6"
    The IP version used for the health check.
    path string
    The HTTP path used for the health check.
    status_code_matcher string
    The HTTP status codes considered successful (e.g., "200-299").
    success_threshold number
    The number of consecutive successful probes required to mark the instance healthy.
    tags list(object)
    Tags to apply to the application status check.
    timeout number
    The timeout, in seconds, for each health check probe.
    port Integer
    The port used for the health check.
    protocol ApplicationStatusCheckProtocol
    The network protocol used for the health check.
    aggregation ApplicationStatusCheckAggregation
    Whether this check is included in the rolled-up application status.
    deviceIndex Integer
    The network interface device index used for the health check.
    failureThreshold Integer
    The number of consecutive failed probes required to mark the instance unhealthy.
    healthCheckPaths List<ApplicationStatusCheckHealthCheckPath>
    The source/destination network paths used for the health check.
    initializationGracePeriodSeconds Integer
    Seconds to wait after instance launch before beginning health checks.
    interval Integer
    The interval, in seconds, between health check probes.
    ipScope ApplicationStatusCheckIpScope
    The IP scope used for the health check.
    ipVersion ApplicationStatusCheckIpVersion
    The IP version used for the health check.
    path String
    The HTTP path used for the health check.
    statusCodeMatcher String
    The HTTP status codes considered successful (e.g., "200-299").
    successThreshold Integer
    The number of consecutive successful probes required to mark the instance healthy.
    tags List<Tag>
    Tags to apply to the application status check.
    timeout Integer
    The timeout, in seconds, for each health check probe.
    port number
    The port used for the health check.
    protocol ApplicationStatusCheckProtocol
    The network protocol used for the health check.
    aggregation ApplicationStatusCheckAggregation
    Whether this check is included in the rolled-up application status.
    deviceIndex number
    The network interface device index used for the health check.
    failureThreshold number
    The number of consecutive failed probes required to mark the instance unhealthy.
    healthCheckPaths ApplicationStatusCheckHealthCheckPath[]
    The source/destination network paths used for the health check.
    initializationGracePeriodSeconds number
    Seconds to wait after instance launch before beginning health checks.
    interval number
    The interval, in seconds, between health check probes.
    ipScope ApplicationStatusCheckIpScope
    The IP scope used for the health check.
    ipVersion ApplicationStatusCheckIpVersion
    The IP version used for the health check.
    path string
    The HTTP path used for the health check.
    statusCodeMatcher string
    The HTTP status codes considered successful (e.g., "200-299").
    successThreshold number
    The number of consecutive successful probes required to mark the instance healthy.
    tags Tag[]
    Tags to apply to the application status check.
    timeout number
    The timeout, in seconds, for each health check probe.
    port int
    The port used for the health check.
    protocol ApplicationStatusCheckProtocol
    The network protocol used for the health check.
    aggregation ApplicationStatusCheckAggregation
    Whether this check is included in the rolled-up application status.
    device_index int
    The network interface device index used for the health check.
    failure_threshold int
    The number of consecutive failed probes required to mark the instance unhealthy.
    health_check_paths Sequence[ApplicationStatusCheckHealthCheckPathArgs]
    The source/destination network paths used for the health check.
    initialization_grace_period_seconds int
    Seconds to wait after instance launch before beginning health checks.
    interval int
    The interval, in seconds, between health check probes.
    ip_scope ApplicationStatusCheckIpScope
    The IP scope used for the health check.
    ip_version ApplicationStatusCheckIpVersion
    The IP version used for the health check.
    path str
    The HTTP path used for the health check.
    status_code_matcher str
    The HTTP status codes considered successful (e.g., "200-299").
    success_threshold int
    The number of consecutive successful probes required to mark the instance healthy.
    tags Sequence[TagArgs]
    Tags to apply to the application status check.
    timeout int
    The timeout, in seconds, for each health check probe.
    port Number
    The port used for the health check.
    protocol "http" | "https"
    The network protocol used for the health check.
    aggregation "included" | "excluded"
    Whether this check is included in the rolled-up application status.
    deviceIndex Number
    The network interface device index used for the health check.
    failureThreshold Number
    The number of consecutive failed probes required to mark the instance unhealthy.
    healthCheckPaths List<Property Map>
    The source/destination network paths used for the health check.
    initializationGracePeriodSeconds Number
    Seconds to wait after instance launch before beginning health checks.
    interval Number
    The interval, in seconds, between health check probes.
    ipScope "private"
    The IP scope used for the health check.
    ipVersion "ipv4" | "ipv6"
    The IP version used for the health check.
    path String
    The HTTP path used for the health check.
    statusCodeMatcher String
    The HTTP status codes considered successful (e.g., "200-299").
    successThreshold Number
    The number of consecutive successful probes required to mark the instance healthy.
    tags List<Property Map>
    Tags to apply to the application status check.
    timeout Number
    The timeout, in seconds, for each health check probe.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the ApplicationStatusCheck resource produces the following output properties:

    ApplicationStatusCheckId string
    The unique identifier of the application status check.
    Arn string
    The Amazon Resource Name (ARN) of the application status check.
    CreationTime string
    When the application status check was created (ISO 8601).
    Id string
    The provider-assigned unique ID for this managed resource.
    ApplicationStatusCheckId string
    The unique identifier of the application status check.
    Arn string
    The Amazon Resource Name (ARN) of the application status check.
    CreationTime string
    When the application status check was created (ISO 8601).
    Id string
    The provider-assigned unique ID for this managed resource.
    application_status_check_id string
    The unique identifier of the application status check.
    arn string
    The Amazon Resource Name (ARN) of the application status check.
    creation_time string
    When the application status check was created (ISO 8601).
    id string
    The provider-assigned unique ID for this managed resource.
    applicationStatusCheckId String
    The unique identifier of the application status check.
    arn String
    The Amazon Resource Name (ARN) of the application status check.
    creationTime String
    When the application status check was created (ISO 8601).
    id String
    The provider-assigned unique ID for this managed resource.
    applicationStatusCheckId string
    The unique identifier of the application status check.
    arn string
    The Amazon Resource Name (ARN) of the application status check.
    creationTime string
    When the application status check was created (ISO 8601).
    id string
    The provider-assigned unique ID for this managed resource.
    application_status_check_id str
    The unique identifier of the application status check.
    arn str
    The Amazon Resource Name (ARN) of the application status check.
    creation_time str
    When the application status check was created (ISO 8601).
    id str
    The provider-assigned unique ID for this managed resource.
    applicationStatusCheckId String
    The unique identifier of the application status check.
    arn String
    The Amazon Resource Name (ARN) of the application status check.
    creationTime String
    When the application status check was created (ISO 8601).
    id String
    The provider-assigned unique ID for this managed resource.

    Supporting Types

    ApplicationStatusCheckAggregation, ApplicationStatusCheckAggregationArgs

    Included
    included
    Excluded
    excluded
    ApplicationStatusCheckAggregationIncluded
    included
    ApplicationStatusCheckAggregationExcluded
    excluded
    "included"
    included
    "excluded"
    excluded
    Included
    included
    Excluded
    excluded
    Included
    included
    Excluded
    excluded
    INCLUDED
    included
    EXCLUDED
    excluded
    "included"
    included
    "excluded"
    excluded

    ApplicationStatusCheckHealthCheckPath, ApplicationStatusCheckHealthCheckPathArgs

    ApplicationStatusCheckHealthCheckPathDestination, ApplicationStatusCheckHealthCheckPathDestinationArgs

    ApplicationStatusCheckHealthCheckPathSource, ApplicationStatusCheckHealthCheckPathSourceArgs

    ApplicationStatusCheckIpScope, ApplicationStatusCheckIpScopeArgs

    Private
    private
    ApplicationStatusCheckIpScopePrivate
    private
    "private"
    private
    Private
    private
    Private
    private
    PRIVATE
    private
    "private"
    private

    ApplicationStatusCheckIpVersion, ApplicationStatusCheckIpVersionArgs

    Ipv4
    ipv4
    Ipv6
    ipv6
    ApplicationStatusCheckIpVersionIpv4
    ipv4
    ApplicationStatusCheckIpVersionIpv6
    ipv6
    "ipv4"
    ipv4
    "ipv6"
    ipv6
    Ipv4
    ipv4
    Ipv6
    ipv6
    Ipv4
    ipv4
    Ipv6
    ipv6
    IPV4
    ipv4
    IPV6
    ipv6
    "ipv4"
    ipv4
    "ipv6"
    ipv6

    ApplicationStatusCheckProtocol, ApplicationStatusCheckProtocolArgs

    Http
    http
    Https
    https
    ApplicationStatusCheckProtocolHttp
    http
    ApplicationStatusCheckProtocolHttps
    https
    "http"
    http
    "https"
    https
    Http
    http
    Https
    https
    Http
    http
    Https
    https
    HTTP
    http
    HTTPS
    https
    "http"
    http
    "https"
    https

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo AWS Cloud Control

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.82.0
    published on Monday, Oct 5, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial