# AWS::AppRunner Construct Library

This module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project.

```ts
import * as apprunner from 'aws-cdk-lib/aws-apprunner';
```

There are no official hand-written ([L2](https://docs.aws.amazon.com/cdk/latest/guide/constructs.html#constructs_lib)) constructs for this service yet. Here are some suggestions on how to proceed:

- Search [Construct Hub for AppRunner construct libraries](https://constructs.dev/search?q=apprunner)
- Use the automatically generated [L1](https://docs.aws.amazon.com/cdk/latest/guide/constructs.html#constructs_l1_using) constructs, in the same way you would use [the CloudFormation AWS::AppRunner resources](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_AppRunner.html) directly.

> An experimental construct library for this service is available in preview. Since it is not stable yet, it is distributed
> as a separate package so that you can pin its version independently of the rest of the CDK. See the package:
>
> <span class="package-reference">@aws-cdk/aws-apprunner-alpha</span>

There are no hand-written ([L2](https://docs.aws.amazon.com/cdk/latest/guide/constructs.html#constructs_lib)) constructs for this service yet.
However, you can still use the automatically generated [L1](https://docs.aws.amazon.com/cdk/latest/guide/constructs.html#constructs_l1_using) constructs, and use this service exactly as you would using CloudFormation directly.

For more information on the resources and properties available for this service, see the [CloudFormation documentation for AWS::AppRunner](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_AppRunner.html).

(Read the [CDK Contributing Guide](https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md) and submit an RFC if you are interested in contributing to this construct library.)

## Types

| Name | Kind | Summary |
| --- | --- | --- |
| [`CfnAutoScalingConfiguration`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnAutoScalingConfiguration) | Construct (L1) | Specify an AWS App Runner Automatic Scaling configuration by using the `AWS::AppRunner::AutoScalingConfiguration` resource in an AWS CloudFormation template. |
| [`CfnObservabilityConfiguration`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnObservabilityConfiguration) | Construct (L1) | Specify an AWS App Runner observability configuration by using the `AWS::AppRunner::ObservabilityConfiguration` resource in an AWS CloudFormation template. |
| [`CfnService`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService) | Construct (L1) | Specify an AWS App Runner service by using the `AWS::AppRunner::Service` resource in an AWS CloudFormation template. |
| [`CfnVpcConnector`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnVpcConnector) | Construct (L1) | Specify an AWS App Runner VPC connector by using the `AWS::AppRunner::VpcConnector` resource in an AWS CloudFormation template. |
| [`CfnVpcIngressConnection`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnVpcIngressConnection) | Construct (L1) | Specify an AWS App Runner VPC Ingress Connection by using the `AWS::AppRunner::VpcIngressConnection` resource in an AWS CloudFormation template. |
| [`CfnAutoScalingConfigurationProps`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnAutoScalingConfigurationProps) | Struct | Properties for defining a `CfnAutoScalingConfiguration`. |
| [`CfnObservabilityConfiguration.TraceConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnObservabilityConfiguration.TraceConfigurationProperty) | Struct | Describes the configuration of the tracing feature within an AWS App Runner observability configuration. |
| [`CfnObservabilityConfigurationProps`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnObservabilityConfigurationProps) | Struct | Properties for defining a `CfnObservabilityConfiguration`. |
| [`CfnService.AuthenticationConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.AuthenticationConfigurationProperty) | Struct | Describes resources needed to authenticate access to some source repositories. |
| [`CfnService.CodeConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.CodeConfigurationProperty) | Struct | Describes the configuration that AWS App Runner uses to build and run an App Runner service from a source code repository. |
| [`CfnService.CodeConfigurationValuesProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.CodeConfigurationValuesProperty) | Struct | Describes the basic configuration needed for building and running an AWS App Runner service. |
| [`CfnService.CodeRepositoryProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.CodeRepositoryProperty) | Struct | Describes a source code repository. |
| [`CfnService.EgressConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.EgressConfigurationProperty) | Struct | Describes configuration settings related to outbound network traffic of an AWS App Runner service. |
| [`CfnService.EncryptionConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.EncryptionConfigurationProperty) | Struct | Describes a custom encryption key that AWS App Runner uses to encrypt copies of the source repository and service logs. |
| [`CfnService.HealthCheckConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.HealthCheckConfigurationProperty) | Struct | Describes the settings for the health check that AWS App Runner performs to monitor the health of a service. |
| [`CfnService.ImageConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.ImageConfigurationProperty) | Struct | Describes the configuration that AWS App Runner uses to run an App Runner service using an image pulled from a source image repository. |
| [`CfnService.ImageRepositoryProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.ImageRepositoryProperty) | Struct | Describes a source image repository. |
| [`CfnService.IngressConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.IngressConfigurationProperty) | Struct | Network configuration settings for inbound network traffic. |
| [`CfnService.InstanceConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.InstanceConfigurationProperty) | Struct | Describes the runtime configuration of an AWS App Runner service instance (scaling unit). |
| [`CfnService.KeyValuePairProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.KeyValuePairProperty) | Struct | Describes a key-value pair, which is a string-to-string mapping. |
| [`CfnService.NetworkConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.NetworkConfigurationProperty) | Struct | Describes configuration settings related to network traffic of an AWS App Runner service. |
| [`CfnService.ServiceObservabilityConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.ServiceObservabilityConfigurationProperty) | Struct | Describes the observability configuration of an AWS App Runner service. |
| [`CfnService.SourceCodeVersionProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.SourceCodeVersionProperty) | Struct | Identifies a version of code that AWS App Runner refers to within a source code repository. |
| [`CfnService.SourceConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnService.SourceConfigurationProperty) | Struct | Describes the source deployed to an AWS App Runner service. |
| [`CfnServiceProps`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnServiceProps) | Struct | Properties for defining a `CfnService`. |
| [`CfnVpcConnectorProps`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnVpcConnectorProps) | Struct | Properties for defining a `CfnVpcConnector`. |
| [`CfnVpcIngressConnection.IngressVpcConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnVpcIngressConnection.IngressVpcConfigurationProperty) | Struct | Specifications for the customer’s VPC and related PrivateLink VPC endpoint that are used to associate with the VPC Ingress Connection resource. |
| [`CfnVpcIngressConnectionProps`](/v2/docs/aws-cdk-lib.aws_apprunner.CfnVpcIngressConnectionProps) | Struct | Properties for defining a `CfnVpcIngressConnection`. |
