View a markdown version of this page

Delete an EVS-deployed environment - Amazon Elastic VMware Service

Delete an EVS-deployed environment

This page applies to EVS-deployed environments (VCF 5.2.x). For Self-deployed environments that run VCF 9.x, see Deploy in Self-deployed mode.

Delete the Amazon Elastic VMware Service hosts and then the environment with the Amazon EVS console or the AWS CLI. After that, delete the network resources that you created for the environment. For a Self-deployed environment, see Clean up a Self-deployed environment.

Warning

Deleting the hosts and the environment deletes the VMware Cloud Foundation (VCF) installation that runs in your Amazon EVS environment. You can’t undo this action.

You must delete all hosts in an environment before you can delete the environment. To remove one host and keep the environment, see Delete a host (VCF 5.x).

Delete the hosts and the environment

You can delete the hosts and the environment by using the Amazon EVS console or the AWS CLI.

Example
Console
  1. Open the Amazon EVS console.

  2. In the navigation pane, choose Environments.

  3. Select the environment that contains the hosts to delete.

  4. Choose the Hosts tab.

  5. Select a host and choose Delete. Repeat this step for each host in the environment.

  6. Wait until the Hosts tab shows no hosts.

  7. At the top of the Environments page, choose Delete and then Delete environment.

  8. If you have Amazon EC2 Capacity Reservations that you no longer need, cancel them. For more information, see Cancel a Capacity Reservation in the Amazon EC2 User Guide.

AWS CLI
  1. Open a terminal session.

  2. Identify the environment that contains the hosts to delete.

    aws evs list-environments

    The following is a sample response.

    { "environmentSummaries": [ { "environmentId": "env-abcde12345", "environmentName": "testEnv", "vcfVersion": "VCF-5.2.2", "environmentState": "CREATED", "createdAt": "2025-04-13T14:42:41.430000+00:00", "modifiedAt": "2025-04-13T14:43:33.412000+00:00", "environmentArn": "arn:aws:evs:us-east-2:111122223333:environment/env-abcde12345" }, { "environmentId": "env-edcbaEXAMPLE", "environmentName": "testEnv2", "vcfVersion": "VCF-5.2.2", "environmentState": "CREATED", "createdAt": "2025-04-13T13:39:49.546000+00:00", "modifiedAt": "2025-04-13T13:52:13.342000+00:00", "environmentArn": "arn:aws:evs:us-east-2:111122223333:environment/env-edcbaEXAMPLE" } ] }

    The ARNs in the sample use the aws partition. In other partitions, the ARN starts with that partition name.

  3. Delete a host from the environment. The following is a sample aws evs delete-environment-host request.

    aws evs delete-environment-host \ --environment-id env-abcde12345 \ --host-name esx01
  4. Repeat the previous step for each remaining host in the environment.

  5. Wait until the following command returns no hosts.

    aws evs list-environment-hosts --environment-id env-abcde12345
  6. Delete the environment.

    aws evs delete-environment --environment-id env-abcde12345
  7. If you have Amazon EC2 Capacity Reservations that you no longer need, cancel them. For more information, see Cancel a Capacity Reservation in the Amazon EC2 User Guide.

You have deleted the hosts and the environment.

What environment deletion removes

Environment deletion also deletes the Amazon EVS VLAN subnets and the AWS Secrets Manager secrets that Amazon EVS created.

Important

Environment deletion doesn’t delete the AWS resources that you created, such as the VPC, the service access subnet, the route server, and the network ACL. These resources can continue to incur charges until you delete them.

Next step

Delete the network resources that you created for the environment, including IPAM resources if you configured HCX internet connectivity. For more information, see Clean up network resources.