We recommend new projects start with resources from the AWS provider.
published on Wednesday, Nov 18, 2026 by Pulumi
We recommend new projects start with resources from the AWS provider.
published on Wednesday, Nov 18, 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.
Aws Native. Ec2. Application Status Check Protocol - The network protocol used for the health check.
- Aggregation
Pulumi.
Aws Native. Ec2. Application Status Check Aggregation - 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 List<Pulumi.Paths Aws Native. Ec2. Inputs. Application Status Check Health Check Path> - The source/destination network paths used for the health check.
- Initialization
Grace intPeriod Seconds - Seconds to wait after instance launch before beginning health checks.
- Interval int
- The interval, in seconds, between health check probes.
- Ip
Scope Pulumi.Aws Native. Ec2. Application Status Check Ip Scope - The IP scope used for the health check.
- Ip
Version Pulumi.Aws Native. Ec2. Application Status Check Ip Version - The IP version used for the health check.
- Path string
- The HTTP path used for the health check.
- Status
Code stringMatcher - 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.
-
List<Pulumi.
Aws Native. 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
Application
Status Check Protocol - The network protocol used for the health check.
- Aggregation
Application
Status Check Aggregation - 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 []ApplicationPaths Status Check Health Check Path Args - The source/destination network paths used for the health check.
- Initialization
Grace intPeriod Seconds - Seconds to wait after instance launch before beginning health checks.
- Interval int
- The interval, in seconds, between health check probes.
- Ip
Scope ApplicationStatus Check Ip Scope - The IP scope used for the health check.
- Ip
Version ApplicationStatus Check Ip Version - The IP version used for the health check.
- Path string
- The HTTP path used for the health check.
- Status
Code stringMatcher - 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.
-
Tag
Args - 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_ list(object)paths - The source/destination network paths used for the health check.
- initialization_
grace_ numberperiod_ seconds - 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_ stringmatcher - 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.
- 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
Application
Status Check Protocol - The network protocol used for the health check.
- aggregation
Application
Status Check Aggregation - Whether this check is included in the rolled-up application status.
- device
Index Integer - The network interface device index used for the health check.
- failure
Threshold Integer - The number of consecutive failed probes required to mark the instance unhealthy.
- health
Check List<ApplicationPaths Status Check Health Check Path> - The source/destination network paths used for the health check.
- initialization
Grace IntegerPeriod Seconds - Seconds to wait after instance launch before beginning health checks.
- interval Integer
- The interval, in seconds, between health check probes.
- ip
Scope ApplicationStatus Check Ip Scope - The IP scope used for the health check.
- ip
Version ApplicationStatus Check Ip Version - The IP version used for the health check.
- path String
- The HTTP path used for the health check.
- status
Code StringMatcher - The HTTP status codes considered successful (e.g., "200-299").
- success
Threshold Integer - The number of consecutive successful probes required to mark the instance healthy.
- 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
Application
Status Check Protocol - The network protocol used for the health check.
- aggregation
Application
Status Check Aggregation - 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 ApplicationPaths Status Check Health Check Path[] - The source/destination network paths used for the health check.
- initialization
Grace numberPeriod Seconds - Seconds to wait after instance launch before beginning health checks.
- interval number
- The interval, in seconds, between health check probes.
- ip
Scope ApplicationStatus Check Ip Scope - The IP scope used for the health check.
- ip
Version ApplicationStatus Check Ip Version - The IP version used for the health check.
- path string
- The HTTP path used for the health check.
- status
Code stringMatcher - 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.
- 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
Application
Status Check Protocol - The network protocol used for the health check.
- aggregation
Application
Status Check Aggregation - 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_ Sequence[Applicationpaths Status Check Health Check Path Args] - The source/destination network paths used for the health check.
- initialization_
grace_ intperiod_ seconds - Seconds to wait after instance launch before beginning health checks.
- interval int
- The interval, in seconds, between health check probes.
- ip_
scope ApplicationStatus Check Ip Scope - The IP scope used for the health check.
- ip_
version ApplicationStatus Check Ip Version - The IP version used for the health check.
- path str
- The HTTP path used for the health check.
- status_
code_ strmatcher - 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.
-
Sequence[Tag
Args] - 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 List<Property Map>Paths - The source/destination network paths used for the health check.
- initialization
Grace NumberPeriod Seconds - 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 StringMatcher - 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.
- 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:
- Application
Status stringCheck Id - 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.
- Application
Status stringCheck Id - 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.
- application_
status_ stringcheck_ id - 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.
- application
Status StringCheck Id - 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.
- application
Status stringCheck Id - 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.
- application_
status_ strcheck_ id - 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.
- application
Status StringCheck Id - 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.
Look up Existing ApplicationStatusCheck Resource
Get an existing ApplicationStatusCheck resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, opts?: CustomResourceOptions): ApplicationStatusCheck@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None) -> ApplicationStatusCheckfunc GetApplicationStatusCheck(ctx *Context, name string, id IDInput, state *ApplicationStatusCheckState, opts ...ResourceOption) (*ApplicationStatusCheck, error)public static ApplicationStatusCheck Get(string name, Input<string> id, CustomResourceOptions? opts = null)public static ApplicationStatusCheck get(String name, Output<String> id, CustomResourceOptions options)resources: existingApplicationStatusCheck: type: aws-native:ec2:ApplicationStatusCheck get: id: ${id}import {
to = aws-native_ec2_application_status_check.example
id = "${id}"
}
- name string
- The unique name of the resulting resource.
- id Input<ID>
- The unique provider ID of the resource to look up.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resulting resource.
- id str
- The unique provider ID of the resource to look up.
- 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 resulting resource.
- id IDInput
- The unique provider ID of the resource to look up.
- state ApplicationStatusCheckState
- Pass nil. This resource has no state arguments.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resulting resource.
- id Input<string>
- The unique provider ID of the resource to look up.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resulting resource.
- id Output<String>
- The unique provider ID of the resource to look up.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Supporting Types
ApplicationStatusCheckAggregation
Whether this check is included in the rolled-up application status.
| Name | Value |
|---|---|
| Included | included |
| Excluded | excluded |
| Name | Value |
|---|---|
| Application | included |
| Application | excluded |
| Value |
|---|
included |
excluded |
| Name | Value |
|---|---|
| Included | included |
| Excluded | excluded |
| Name | Value |
|---|---|
| Included | included |
| Excluded | excluded |
| Name | Value |
|---|---|
| INCLUDED | included |
| EXCLUDED | excluded |
| Value |
|---|
included |
excluded |
ApplicationStatusCheckHealthCheckPath, ApplicationStatusCheckHealthCheckPathArgs
ApplicationStatusCheckHealthCheckPathDestination, ApplicationStatusCheckHealthCheckPathDestinationArgs
- Security
Group stringId - Subnet
Id string
- Security
Group stringId - Subnet
Id string
- security_
group_ stringid - subnet_
id string
- security
Group StringId - subnet
Id String
- security
Group stringId - subnet
Id string
- security_
group_ strid - subnet_
id str
- security
Group StringId - subnet
Id String
ApplicationStatusCheckHealthCheckPathSource, ApplicationStatusCheckHealthCheckPathSourceArgs
- Security
Group stringId - Subnet
Id string
- Security
Group stringId - Subnet
Id string
- security_
group_ stringid - subnet_
id string
- security
Group StringId - subnet
Id String
- security
Group stringId - subnet
Id string
- security_
group_ strid - subnet_
id str
- security
Group StringId - subnet
Id String
ApplicationStatusCheckIpScope
The IP scope used for the health check.
| Name | Value |
|---|---|
| Private | private |
| Name | Value |
|---|---|
| Application | private |
| Value |
|---|
private |
| Name | Value |
|---|---|
| Private | private |
| Name | Value |
|---|---|
| Private | private |
| Name | Value |
|---|---|
| PRIVATE | private |
| Value |
|---|
private |
ApplicationStatusCheckIpVersion
The IP version used for the health check.
| Name | Value |
|---|---|
| Ipv4 | ipv4 |
| Ipv6 | ipv6 |
| Name | Value |
|---|---|
| Application | ipv4 |
| Application | ipv6 |
| Value |
|---|
ipv4 |
ipv6 |
| Name | Value |
|---|---|
| Ipv4 | ipv4 |
| Ipv6 | ipv6 |
| Name | Value |
|---|---|
| Ipv4 | ipv4 |
| Ipv6 | ipv6 |
| Name | Value |
|---|---|
| IPV4 | ipv4 |
| IPV6 | ipv6 |
| Value |
|---|
ipv4 |
ipv6 |
ApplicationStatusCheckProtocol
The network protocol used for the health check.
| Name | Value |
|---|---|
| Http | http |
| Https | https |
| Name | Value |
|---|---|
| Application | http |
| Application | https |
| Value |
|---|
http |
https |
| Name | Value |
|---|---|
| Http | http |
| Https | https |
| Name | Value |
|---|---|
| Http | http |
| Https | https |
| Name | Value |
|---|---|
| HTTP | http |
| HTTPS | https |
| Value |
|---|
http |
https |
Tag, TagArgs
A set of tags to apply to the resource.
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
published on Wednesday, Nov 18, 2026 by Pulumi