# Host
<a name="API_Host"></a>

An ESX host that runs on an Amazon EC2 bare metal instance. Four hosts are created in an Amazon EVS environment during environment creation. You can add hosts to an environment using the `CreateEnvironmentHost` operation. Amazon EVS supports 4-16 hosts per environment.

## Contents
<a name="API_Host_Contents"></a>

**Note**  
In the following list, the required parameters are described first.

 ** createdAt **   <a name="evs-Type-Host-createdAt"></a>
 The date and time that the host was created.  
Type: Timestamp  
Required: No

 ** dedicatedHostId **   <a name="evs-Type-Host-dedicatedHostId"></a>
The unique ID of the Amazon EC2 Dedicated Host.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 25.  
Pattern: `h-[a-f0-9]{8}([a-f0-9]{9})?`   
Required: No

 ** ec2InstanceId **   <a name="evs-Type-Host-ec2InstanceId"></a>
The unique ID of the EC2 instance that represents the host.  
Type: String  
Required: No

 ** hostName **   <a name="evs-Type-Host-hostName"></a>
The DNS hostname of the host. DNS hostnames for hosts must be unique across Amazon EVS environments and within VCF.  
Type: String  
Pattern: `([a-zA-Z0-9\-]*)`   
Required: No

 ** hostState **   <a name="evs-Type-Host-hostState"></a>
 The state of the host.  
Type: String  
Valid Values: `CREATING | CREATED | UPDATING | DELETING | DELETED | CREATE_FAILED | UPDATE_FAILED`   
Required: No

 ** instanceType **   <a name="evs-Type-Host-instanceType"></a>
The EC2 instance type of the host.  
Currently, Amazon EVS supports only the `i4i.metal` instance type.
EC2 instances created through Amazon EVS do not support associating an IAM instance profile.
Type: String  
Valid Values: `i4i.metal`   
Required: No

 ** ipAddress **   <a name="evs-Type-Host-ipAddress"></a>
The IP address of the host.  
Type: String  
Pattern: `(\d{1,3}\.){3}\d{1,3}`   
Required: No

 ** keyName **   <a name="evs-Type-Host-keyName"></a>
The name of the SSH key that is used to access the host.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Pattern: `[a-zA-Z0-9_-]+`   
Required: No

 ** modifiedAt **   <a name="evs-Type-Host-modifiedAt"></a>
 The date and time that the host was modified.  
Type: Timestamp  
Required: No

 ** networkInterfaces **   <a name="evs-Type-Host-networkInterfaces"></a>
The elastic network interfaces that are attached to the host.  
Type: Array of [NetworkInterface](API_NetworkInterface.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 2 items.  
Required: No

 ** placementGroupId **   <a name="evs-Type-Host-placementGroupId"></a>
The unique ID of the placement group where the host is placed.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 25.  
Pattern: `pg-[a-f0-9]{8}([a-f0-9]{9})?`   
Required: No

 ** stateDetails **   <a name="evs-Type-Host-stateDetails"></a>
 A detailed description of the `hostState` of a host.  
Type: String  
Required: No

## See Also
<a name="API_Host_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/evs-2023-07-27/Host) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/evs-2023-07-27/Host) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/evs-2023-07-27/Host)