How do I delete a Device Farm project?

Resolution

Important: If you delete a Device Farm project, then Device Farm permanently deletes all the project's underlying resources, including runs, reports, device pools, and files. After you delete the resources, you can't recover them.

Use the Device Farm console to delete a project

1. Open the Device Farm console.
2. In the navigation pane, choose Projects under either Mobile Device Testing or Desktop Browser Testing.
3. Select the check box for the card that lists the name of the project that you want to delete, and then choose Delete.
4. In the Delete project dialog box, select the I understand and want to delete this project check box.
5. Choose Delete.

Use the AWS CLI to delete a project

Note: If you receive errors when you run AWS Command Line Interface (AWS CLI) commands, then see Troubleshooting errors for the AWS CLI. Also, make sure that you're using the most recent AWS CLI version.

Complete the following steps:

1. To get the Amazon Resource Name (ARN) of the project that you want to delete, run the following list-projects AWS CLI command:

   aws devicefarm list-projects --region us-west-2

   The command output includes the names, ARNs, and creation timestamps for all your Device Farm projects.
2. To delete the project, run the following delete-project AWS CLI command:

   aws devicefarm delete-project \
       --arn PROJECT_ARN \
       --region us-west-2

   Note: Replace PROJECT_ARN with the ARN of the project that you want to delete.

Unblock project deletion for runs stuck in the STOPPING state

If you can't delete your project because runs are stuck in the STOPPING state, then the StopRun API operation can't resolve the issue. Long-abandoned runs don't respond to stop requests.

To resolve this issue, complete the following steps:

1. To confirm that the run is stuck in the STOPPING state, run the following list-runs AWS CLI command:

   aws devicefarm list-runs \
       --arn PROJECT_ARN \
       --region us-west-2

   Note: Replace PROJECT_ARN with the ARN of your Device Farm project.
2. Review the output and identify runs with a status of STOPPING that don't transition to COMPLETED.
3. Open an AWS Support case and request a cancellation of the stuck runs. Include the project ARN and the ARNs of the stuck runs in your support case.

After AWS Support cancels the stuck runs, use the Device Farm console or AWS CLI to delete the project.