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

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.

    Using getApplicationStatusCheck

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getApplicationStatusCheck(args: GetApplicationStatusCheckArgs, opts?: InvokeOptions): Promise<GetApplicationStatusCheckResult>
    function getApplicationStatusCheckOutput(args: GetApplicationStatusCheckOutputArgs, opts?: InvokeOutputOptions): Output<GetApplicationStatusCheckResult>
    def get_application_status_check(arn: Optional[str] = None,
                                     opts: Optional[InvokeOptions] = None) -> GetApplicationStatusCheckResult
    def get_application_status_check_output(arn: pulumi.Input[Optional[str]] = None,
                                     opts: Optional[InvokeOutputOptions] = None) -> Output[GetApplicationStatusCheckResult]
    func LookupApplicationStatusCheck(ctx *Context, args *LookupApplicationStatusCheckArgs, opts ...InvokeOption) (*LookupApplicationStatusCheckResult, error)
    func LookupApplicationStatusCheckOutput(ctx *Context, args *LookupApplicationStatusCheckOutputArgs, opts ...InvokeOption) LookupApplicationStatusCheckResultOutput

    > Note: This function is named LookupApplicationStatusCheck in the Go SDK.

    public static class GetApplicationStatusCheck 
    {
        public static Task<GetApplicationStatusCheckResult> InvokeAsync(GetApplicationStatusCheckArgs args, InvokeOptions? opts = null)
        public static Output<GetApplicationStatusCheckResult> Invoke(GetApplicationStatusCheckInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetApplicationStatusCheckResult> Invoke(GetApplicationStatusCheckInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetApplicationStatusCheckResult> getApplicationStatusCheck(GetApplicationStatusCheckArgs args, InvokeOptions options)
    public static Output<GetApplicationStatusCheckResult> getApplicationStatusCheck(GetApplicationStatusCheckArgs args, InvokeOptions options)
    public static Output<GetApplicationStatusCheckResult> getApplicationStatusCheck(GetApplicationStatusCheckArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: aws-native:ec2:getApplicationStatusCheck
      arguments:
        # arguments dictionary
    data "aws-native_ec2_get_application_status_check" "name" {
        # arguments
    }

    The following arguments are supported:

    Arn string
    The Amazon Resource Name (ARN) of the application status check.
    Arn string
    The Amazon Resource Name (ARN) of the application status check.
    arn string
    The Amazon Resource Name (ARN) of the application status check.
    arn String
    The Amazon Resource Name (ARN) of the application status check.
    arn string
    The Amazon Resource Name (ARN) of the application status check.
    arn str
    The Amazon Resource Name (ARN) of the application status check.
    arn String
    The Amazon Resource Name (ARN) of the application status check.

    getApplicationStatusCheck Result

    The following output properties are available:

    Aggregation Pulumi.AwsNative.Ec2.ApplicationStatusCheckAggregation
    Whether this check is included in the rolled-up application status.
    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).
    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.Outputs.ApplicationStatusCheckHealthCheckPath>
    The source/destination network paths used for the health check.
    InitializationGracePeriodSeconds int
    Seconds to wait after instance launch before beginning health checks.
    IpVersion Pulumi.AwsNative.Ec2.ApplicationStatusCheckIpVersion
    The IP version used for the health check.
    Path string
    The HTTP path used for the health check.
    Port int
    The port used for the health check.
    Protocol Pulumi.AwsNative.Ec2.ApplicationStatusCheckProtocol
    The network protocol 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.Outputs.Tag>
    Tags to apply to the application status check.
    Timeout int
    The timeout, in seconds, for each health check probe.
    Aggregation ApplicationStatusCheckAggregation
    Whether this check is included in the rolled-up application status.
    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).
    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 []ApplicationStatusCheckHealthCheckPath
    The source/destination network paths used for the health check.
    InitializationGracePeriodSeconds int
    Seconds to wait after instance launch before beginning health checks.
    IpVersion ApplicationStatusCheckIpVersion
    The IP version used for the health check.
    Path string
    The HTTP path used for the health check.
    Port int
    The port used for the health check.
    Protocol ApplicationStatusCheckProtocol
    The network protocol 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 Tag
    Tags to apply to the application status check.
    Timeout int
    The timeout, in seconds, for each health check probe.
    aggregation "included" | "excluded"
    Whether this check is included in the rolled-up application status.
    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).
    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.
    ip_version "ipv4" | "ipv6"
    The IP version used for the health check.
    path string
    The HTTP path used for the health check.
    port number
    The port used for the health check.
    protocol "http" | "https"
    The network protocol 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.
    aggregation ApplicationStatusCheckAggregation
    Whether this check is included in the rolled-up application status.
    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).
    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.
    ipVersion ApplicationStatusCheckIpVersion
    The IP version used for the health check.
    path String
    The HTTP path used for the health check.
    port Integer
    The port used for the health check.
    protocol ApplicationStatusCheckProtocol
    The network protocol 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.
    aggregation ApplicationStatusCheckAggregation
    Whether this check is included in the rolled-up application status.
    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).
    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.
    ipVersion ApplicationStatusCheckIpVersion
    The IP version used for the health check.
    path string
    The HTTP path used for the health check.
    port number
    The port used for the health check.
    protocol ApplicationStatusCheckProtocol
    The network protocol 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.
    aggregation ApplicationStatusCheckAggregation
    Whether this check is included in the rolled-up application status.
    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).
    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[ApplicationStatusCheckHealthCheckPath]
    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.
    ip_version ApplicationStatusCheckIpVersion
    The IP version used for the health check.
    path str
    The HTTP path used for the health check.
    port int
    The port used for the health check.
    protocol ApplicationStatusCheckProtocol
    The network protocol 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[root_Tag]
    Tags to apply to the application status check.
    timeout int
    The timeout, in seconds, for each health check probe.
    aggregation "included" | "excluded"
    Whether this check is included in the rolled-up application status.
    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).
    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.
    ipVersion "ipv4" | "ipv6"
    The IP version used for the health check.
    path String
    The HTTP path used for the health check.
    port Number
    The port used for the health check.
    protocol "http" | "https"
    The network protocol 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.

    Supporting Types

    ApplicationStatusCheckAggregation

    ApplicationStatusCheckHealthCheckPath

    ApplicationStatusCheckHealthCheckPathDestination

    ApplicationStatusCheckHealthCheckPathSource

    ApplicationStatusCheckIpVersion

    ApplicationStatusCheckProtocol

    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 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