Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1422147110.4 KB

Creates an ESX host and adds it to an Amazon EVS environment.

This action can only be used after the Amazon EVS environment is deployed.

You can use the dedicatedHostId parameter to specify an Amazon EC2 Dedicated Host for ESX host creation.

You can use the placementGroupId parameter to specify a cluster or partition placement group to launch EC2 instances into.

If you don't specify an ESX version when adding hosts using CreateEnvironmentHost action, Amazon EVS automatically uses the default ESX version for your environment's VCF version. To find the available ESX versions for a particular VCF version, use the GetVersions action.

You cannot use the dedicatedHostId and placementGroupId parameters together in the same CreateEnvironmentHost action. This results in a ValidationException response.

post/#X-Amz-Target=AmazonElasticVMwareService.CreateEnvironmentHost

Headers

X-Amz-Target'AmazonElasticVMwareService.CreateEnvironmentHost' required

Request body

clientTokenstring
<p><note> <p>This parameter is not used in Amazon EVS currently. If you supply input for this parameter, it will have no effect.</p> </note> <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the host creation request. If you do not specify a client token, a randomly generated token is used for the request to ensure idempotency.</p></p>
environmentIdstring required

A unique ID for the environment that the host is added to.

esxVersionstring

The ESX version to use for the host.

Response

Success