View Source AWS.Evs (aws-elixir v1.0.7)

Amazon Elastic VMware Service (Amazon EVS) is a service that you can use to deploy a VMware Cloud Foundation (VCF) software environment directly on EC2 bare metal instances within an Amazon Virtual Private Cloud (VPC).

Workloads running on Amazon EVS are fully compatible with workloads running on any standard VMware vSphere environment. This means that you can migrate any VMware-based workload to Amazon EVS without workload modification.

Link to this section Summary

Functions

Creates an Amazon EVS environment that runs VCF software, such as SDDC Manager, NSX Manager, and vCenter Server.

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

Deletes an Amazon EVS environment.

Deletes a host from an Amazon EVS environment.

Returns a description of the specified environment.

List the hosts within an environment.

Lists environment VLANs that are associated with the specified environment.

Lists the Amazon EVS environments in your Amazon Web Services account in the specified Amazon Web Services Region.

Lists the tags for an Amazon EVS resource.

Associates the specified tags to an Amazon EVS resource with the specified resourceArn.

Deletes specified tags from an Amazon EVS resource.

Link to this section Functions

Link to this function

create_environment(client, input, options \\ [])

View Source

Creates an Amazon EVS environment that runs VCF software, such as SDDC Manager, NSX Manager, and vCenter Server.

During environment creation, Amazon EVS performs validations on DNS settings, provisions VLAN subnets and hosts, and deploys the supplied version of VCF.

It can take several hours to create an environment. After the deployment completes, you can configure VCF according to your unique requirements.

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

EC2 instances created through Amazon EVS do not support associating an IAM instance profile.

Link to this function

create_environment_host(client, input, options \\ [])

View Source

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

Amazon EVS supports 4-16 hosts per environment.

This action can only be used after the Amazon EVS environment is deployed. All Amazon EVS hosts are created with the latest AMI release version for the respective VCF version of the environment.

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

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

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

EC2 instances created through Amazon EVS do not support associating an IAM instance profile.

Link to this function

delete_environment(client, input, options \\ [])

View Source

Deletes an Amazon EVS environment.

Amazon EVS environments will only be enabled for deletion once the hosts are deleted. You can delete hosts using the DeleteEnvironmentHost action.

Environment deletion also deletes the associated Amazon EVS VLAN subnets. Other associated Amazon Web Services resources are not deleted. These resources may continue to incur costs.

Link to this function

delete_environment_host(client, input, options \\ [])

View Source

Deletes a host from an Amazon EVS environment.

Before deleting a host, you must unassign and decommission the host from within the SDDC Manager user interface. Not doing so could impact the availability of your virtual machines or result in data loss.

Link to this function

get_environment(client, input, options \\ [])

View Source

Returns a description of the specified environment.

Link to this function

list_environment_hosts(client, input, options \\ [])

View Source

List the hosts within an environment.

Link to this function

list_environment_vlans(client, input, options \\ [])

View Source

Lists environment VLANs that are associated with the specified environment.

Link to this function

list_environments(client, input, options \\ [])

View Source

Lists the Amazon EVS environments in your Amazon Web Services account in the specified Amazon Web Services Region.

Link to this function

list_tags_for_resource(client, input, options \\ [])

View Source

Lists the tags for an Amazon EVS resource.

Link to this function

tag_resource(client, input, options \\ [])

View Source

Associates the specified tags to an Amazon EVS resource with the specified resourceArn.

If existing tags on a resource are not specified in the request parameters, they aren't changed. When a resource is deleted, the tags associated with that resource are also deleted. Tags that you create for Amazon EVS resources don't propagate to any other resources associated with the environment. For example, if you tag an environment with this operation, that tag doesn't automatically propagate to the VLAN subnets and hosts associated with the environment.

Link to this function

untag_resource(client, input, options \\ [])

View Source

Deletes specified tags from an Amazon EVS resource.