Deleting an App Runner service - AWS App Runner

Deleting an App Runner service

When you want to terminate the web application that's running in your AWS App Runner service, you can delete the service. Deleting a service stops the running web service, removes the underlying resources, and deletes your associated data.

You might want to delete an App Runner service for one or more of the following reasons:

  • You don't need the web application anymore – For example, it's retired, or it's a development version that you're done using.

  • You've reached the App Runner service quota – You want to create a new service in the same AWS Region and you've reached the quota associated with your account. For more information, see App Runner resource quotas.

  • Security or privacy considerations – You want App Runner to delete the data that it stores for your service.

Pausing and deleting compared

Pause your App Runner service to temporarily disable it. Only compute resources are terminated, and your stored data (for example, the container image with your application version) remains intact. Resuming your service is quick—your application is ready to be deployed to new compute resources. Your App Runner domain remains the same.

Delete your App Runner service to permanently remove it. Your stored data is deleted. If you need to recreate the service, App Runner needs to fetch your source again, and also to build it if it's a code repository. Your web application gets a new App Runner domain.

What does App Runner delete?

When you delete your service, App Runner deletes some associated items, and doesn't delete others. The following lists provide the details.

Items that App Runner deletes:
  • Container image – A copy of the image that you deployed or the image that App Runner built from your source code. It's stored in Amazon Elastic Container Registry (Amazon ECR) using internal AWS accounts that are owned by App Runner.

  • Service configuration – The configuration settings that are associated with your App Runner service. They're stored in Amazon DynamoDB using internal AWS accounts that are owned by App Runner.

Items that App Runner doesn't delete:
  • Connection – You might have a connection that's associated with your service. An App Runner connection is a separate resource that might be shared among several App Runner services. If you don't need the connection anymore, you can explicitly delete it. For more information, see Managing App Runner connections.

  • Custom domain certificates – If you link custom domains to an App Runner service, App Runner internally creates certificates that track domain validity. They're stored in AWS Certificate Manager (ACM). App Runner doesn't delete the certificate for seven days after a domain is unlinked from your service or after the service is deleted. For more information, see Managing custom domain names for an App Runner service.

Delete your service

Delete your App Runner service using one of the following methods:

App Runner console
To delete your service using the App Runner console
  1. Open the App Runner console, and in the Regions list, select your AWS Region.

  2. In the navigation pane, choose Services, and then choose your App Runner service.

    The console displays the service dashboard with a Service overview.

    App Runner service dashboard page showing Activity list
  3. Choose Actions, and then choose Delete.

    The console takes you to the Services page. The deleted service displays the Operation in progress status, and then the service disappears from the list. Your service is now deleted.

App Runner API or AWS CLI

To delete your service using the App Runner API or AWS CLI, call the DeleteService API action. If the call returns a successful response with a Service object showing "Status": "OPERATION_IN_PROGRESS", App Runner starts deleting your service.