aws-sdk-evs 1.11.0 → 1.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93e60bcc79377b9e43553eec8d4695907333aa4788d0f6ff7ec08eb0f2b2654b
-  data.tar.gz: 7d0d9ae768dd7e9541aa982de5c64c2d3e5289dd94896569c31cf520585116a9
+  metadata.gz: 634068a774618eb2e87fc5417deb23b76a87421c253e4550a45fc4c4ef88695d
+  data.tar.gz: d7705a4bb22e1eb6b7828ca5020e37313280cc78c88cf7230c423e0cd0cc79cd
 SHA512:
-  metadata.gz: 0db47e5765f6edb01b6cd7b4cb77a7534bc1d308b3c0c7e3510f4ac2fa461f859fe212f72500c7f4b4b40c0d6da9042b484f9b71c09d1aaecfb18f0687498304
-  data.tar.gz: 20e3ef6be9115d677f2729abf9b25bda569b37c3b7897225ed836a17bd64b7894eb81a4f50d6de20d681c20bc3781aa4f6db506568552a5cfea49f7929386957
+  metadata.gz: aa66c9613b9d5c1a9747691788aad393794ef160402c3a78cc1f0281cb7421667e4ba60ff0244a2d9a0301d7ecfdb823900bcadf18e47d72f78b45b9a55d930e
+  data.tar.gz: e03898f13d265fed572c4bf728b6c8685e5eab6d236cf091b146587ac2e9373e5c54ec6164631aa255773a33048af71145a5f97fc0d0f1d83fb182c3aef4d77e

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.12.0 (2026-01-15)
+------------------
+
+* Feature - A new GetVersions API has been added to retrieve VCF, ESX versions, and EC2 instances provided by Amazon EVS. The CreateEnvironment API now allows you to select a VCF version and the CreateEnvironmentHost API introduces a optional esxVersion parameter.
+
 1.11.0 (2026-01-08)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.11.0
+1.12.0

data/lib/aws-sdk-evs/client.rb

@@ -563,6 +563,12 @@ module Aws::Evs
     # deployment completes, you can configure VCF in the vSphere user
     # interface according to your needs.
     #
+    # When creating a new environment, the default ESX version for the
+    # selected VCF version will be used, you cannot choose a specific ESX
+    # version in `CreateEnvironment` action. When a host has been added with
+    # a specific ESX version, it can only be upgraded using vCenter
+    # Lifecycle Manager.
+    #
     # <note markdown="1"> You cannot use the `dedicatedHostId` and `placementGroupId` parameters
     # together in the same `CreateEnvironment` action. This results in a
     # `ValidationException` response.
@@ -639,7 +645,7 @@ module Aws::Evs
     #   Connect virtual private gateway associations.
     #
     #   <note markdown="1"> Ensure that you specify a VPC that is adequately sized to accommodate
-    #   the \{evws} subnets.
+    #   the Amazon EVS subnets.
     #
     #    </note>
     #
@@ -650,8 +656,7 @@ module Aws::Evs
     #   environment.
     #
     # @option params [required, String] :vcf_version
-    #   The VCF version to use for the environment. Amazon EVS only supports
-    #   VCF version 5.2.1 at this time.
+    #   The VCF version to use for the environment.
     #
     # @option params [required, Boolean] :terms_accepted
     #   Customer confirmation that the customer has purchased and will
@@ -684,7 +689,7 @@ module Aws::Evs
     #    </note>
     #
     # @option params [required, Array<Types::HostInfoForCreate>] :hosts
-    #   The ESXi hosts to add to the environment. Amazon EVS requires that you
+    #   The ESX hosts to add to the environment. Amazon EVS requires that you
     #   provide details for a minimum of 4 hosts during environment creation.
     #
     #   For each host, you must provide the desired hostname, EC2 SSH keypair
@@ -731,7 +736,7 @@ module Aws::Evs
     #     },
     #     vpc_id: "VpcId", # required
     #     service_access_subnet_id: "SubnetId", # required
-    #     vcf_version: "VCF-5.2.1", # required, accepts VCF-5.2.1
+    #     vcf_version: "VCF-5.2.1", # required, accepts VCF-5.2.1, VCF-5.2.2
     #     terms_accepted: false, # required
     #     license_info: [ # required
     #       {
@@ -810,7 +815,7 @@ module Aws::Evs
     #   resp.environment.environment_name #=> String
     #   resp.environment.vpc_id #=> String
     #   resp.environment.service_access_subnet_id #=> String
-    #   resp.environment.vcf_version #=> String, one of "VCF-5.2.1"
+    #   resp.environment.vcf_version #=> String, one of "VCF-5.2.1", "VCF-5.2.2"
     #   resp.environment.terms_accepted #=> Boolean
     #   resp.environment.license_info #=> Array
     #   resp.environment.license_info[0].solution_key #=> String
@@ -847,18 +852,26 @@ module Aws::Evs
       req.send_request(options)
     end
 
-    # Creates an ESXi host and adds it to an Amazon EVS environment. Amazon
+    # Creates an ESX 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.
     #
     # You can use the `dedicatedHostId` parameter to specify an Amazon EC2
-    # Dedicated Host for ESXi host creation.
+    # 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.
     #
+    # <note markdown="1"> If you don't specify an ESX version when adding hosts using
+    # `CreateEnvironmentHost` action, Amazon EVS automatically uses the
+    # default ESX version associated with your environment's VCF version.
+    # To find the default ESX version for a particular VCF version, use the
+    # `GetVersions` action.
+    #
+    #  </note>
+    #
     # <note markdown="1"> You cannot use the `dedicatedHostId` and `placementGroupId` parameters
     # together in the same `CreateEnvironmentHost` action. This results in a
     # `ValidationException` response.
@@ -886,6 +899,9 @@ module Aws::Evs
     # @option params [required, Types::HostInfoForCreate] :host
     #   The host that is created and added to the environment.
     #
+    # @option params [String] :esx_version
+    #   The ESX version to use for the host.
+    #
     # @return [Types::CreateEnvironmentHostResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateEnvironmentHostResponse#environment_summary #environment_summary} => Types::EnvironmentSummary
@@ -903,13 +919,14 @@ module Aws::Evs
     #       placement_group_id: "PlacementGroupId",
     #       dedicated_host_id: "DedicatedHostId",
     #     },
+    #     esx_version: "EsxVersion",
     #   })
     #
     # @example Response structure
     #
     #   resp.environment_summary.environment_id #=> String
     #   resp.environment_summary.environment_name #=> String
-    #   resp.environment_summary.vcf_version #=> String, one of "VCF-5.2.1"
+    #   resp.environment_summary.vcf_version #=> String, one of "VCF-5.2.1", "VCF-5.2.2"
     #   resp.environment_summary.environment_status #=> String, one of "PASSED", "FAILED", "UNKNOWN"
     #   resp.environment_summary.environment_state #=> String, one of "CREATING", "CREATED", "DELETING", "DELETED", "CREATE_FAILED"
     #   resp.environment_summary.created_at #=> Time
@@ -989,7 +1006,7 @@ module Aws::Evs
     #   resp.environment.environment_name #=> String
     #   resp.environment.vpc_id #=> String
     #   resp.environment.service_access_subnet_id #=> String
-    #   resp.environment.vcf_version #=> String, one of "VCF-5.2.1"
+    #   resp.environment.vcf_version #=> String, one of "VCF-5.2.1", "VCF-5.2.2"
     #   resp.environment.terms_accepted #=> Boolean
     #   resp.environment.license_info #=> Array
     #   resp.environment.license_info[0].solution_key #=> String
@@ -1072,7 +1089,7 @@ module Aws::Evs
     #
     #   resp.environment_summary.environment_id #=> String
     #   resp.environment_summary.environment_name #=> String
-    #   resp.environment_summary.vcf_version #=> String, one of "VCF-5.2.1"
+    #   resp.environment_summary.vcf_version #=> String, one of "VCF-5.2.1", "VCF-5.2.2"
     #   resp.environment_summary.environment_status #=> String, one of "PASSED", "FAILED", "UNKNOWN"
     #   resp.environment_summary.environment_state #=> String, one of "CREATING", "CREATED", "DELETING", "DELETED", "CREATE_FAILED"
     #   resp.environment_summary.created_at #=> Time
@@ -1196,7 +1213,7 @@ module Aws::Evs
     #   resp.environment.environment_name #=> String
     #   resp.environment.vpc_id #=> String
     #   resp.environment.service_access_subnet_id #=> String
-    #   resp.environment.vcf_version #=> String, one of "VCF-5.2.1"
+    #   resp.environment.vcf_version #=> String, one of "VCF-5.2.1", "VCF-5.2.2"
     #   resp.environment.terms_accepted #=> Boolean
     #   resp.environment.license_info #=> Array
     #   resp.environment.license_info[0].solution_key #=> String
@@ -1233,6 +1250,37 @@ module Aws::Evs
       req.send_request(options)
     end
 
+    # Returns information about VCF versions, ESX versions and EC2 instance
+    # types provided by Amazon EVS. For each VCF version, the response also
+    # includes the default ESX version and provided EC2 instance types.
+    #
+    # @return [Types::GetVersionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetVersionsResponse#vcf_versions #vcf_versions} => Array&lt;Types::VcfVersionInfo&gt;
+    #   * {Types::GetVersionsResponse#instance_type_esx_versions #instance_type_esx_versions} => Array&lt;Types::InstanceTypeEsxVersionsInfo&gt;
+    #
+    # @example Response structure
+    #
+    #   resp.vcf_versions #=> Array
+    #   resp.vcf_versions[0].vcf_version #=> String, one of "VCF-5.2.1", "VCF-5.2.2"
+    #   resp.vcf_versions[0].status #=> String
+    #   resp.vcf_versions[0].default_esx_version #=> String
+    #   resp.vcf_versions[0].instance_types #=> Array
+    #   resp.vcf_versions[0].instance_types[0] #=> String, one of "i4i.metal"
+    #   resp.instance_type_esx_versions #=> Array
+    #   resp.instance_type_esx_versions[0].instance_type #=> String, one of "i4i.metal"
+    #   resp.instance_type_esx_versions[0].esx_versions #=> Array
+    #   resp.instance_type_esx_versions[0].esx_versions[0] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/evs-2023-07-27/GetVersions AWS API Documentation
+    #
+    # @overload get_versions(params = {})
+    # @param [Hash] params ({})
+    def get_versions(params = {}, options = {})
+      req = build_request(:get_versions, params)
+      req.send_request(options)
+    end
+
     # List the hosts within an environment.
     #
     # @option params [String] :next_token
@@ -1394,7 +1442,7 @@ module Aws::Evs
     #   resp.environment_summaries #=> Array
     #   resp.environment_summaries[0].environment_id #=> String
     #   resp.environment_summaries[0].environment_name #=> String
-    #   resp.environment_summaries[0].vcf_version #=> String, one of "VCF-5.2.1"
+    #   resp.environment_summaries[0].vcf_version #=> String, one of "VCF-5.2.1", "VCF-5.2.2"
     #   resp.environment_summaries[0].environment_status #=> String, one of "PASSED", "FAILED", "UNKNOWN"
     #   resp.environment_summaries[0].environment_state #=> String, one of "CREATING", "CREATED", "DELETING", "DELETED", "CREATE_FAILED"
     #   resp.environment_summaries[0].created_at #=> Time
@@ -1522,7 +1570,7 @@ module Aws::Evs
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-evs'
-      context[:gem_version] = '1.11.0'
+      context[:gem_version] = '1.12.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-evs/client_api.rb

@@ -49,8 +49,12 @@ module Aws::Evs
     EnvironmentStateList = Shapes::ListShape.new(name: 'EnvironmentStateList')
     EnvironmentSummary = Shapes::StructureShape.new(name: 'EnvironmentSummary')
     EnvironmentSummaryList = Shapes::ListShape.new(name: 'EnvironmentSummaryList')
+    EsxVersion = Shapes::StringShape.new(name: 'EsxVersion')
+    EsxVersionList = Shapes::ListShape.new(name: 'EsxVersionList')
     GetEnvironmentRequest = Shapes::StructureShape.new(name: 'GetEnvironmentRequest')
     GetEnvironmentResponse = Shapes::StructureShape.new(name: 'GetEnvironmentResponse')
+    GetVersionsRequest = Shapes::StructureShape.new(name: 'GetVersionsRequest')
+    GetVersionsResponse = Shapes::StructureShape.new(name: 'GetVersionsResponse')
     Host = Shapes::StructureShape.new(name: 'Host')
     HostInfoForCreate = Shapes::StructureShape.new(name: 'HostInfoForCreate')
     HostInfoForCreateList = Shapes::ListShape.new(name: 'HostInfoForCreateList')
@@ -60,7 +64,11 @@ module Aws::Evs
     InitialVlanInfo = Shapes::StructureShape.new(name: 'InitialVlanInfo')
     InitialVlans = Shapes::StructureShape.new(name: 'InitialVlans')
     InstanceType = Shapes::StringShape.new(name: 'InstanceType')
+    InstanceTypeEsxVersionsInfo = Shapes::StructureShape.new(name: 'InstanceTypeEsxVersionsInfo')
+    InstanceTypeEsxVersionsList = Shapes::ListShape.new(name: 'InstanceTypeEsxVersionsList')
+    InstanceTypeList = Shapes::ListShape.new(name: 'InstanceTypeList')
     Integer = Shapes::IntegerShape.new(name: 'Integer')
+    InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
     IpAddress = Shapes::StringShape.new(name: 'IpAddress')
     KeyName = Shapes::StringShape.new(name: 'KeyName')
     LicenseInfo = Shapes::StructureShape.new(name: 'LicenseInfo')
@@ -113,6 +121,8 @@ module Aws::Evs
     ValidationExceptionReason = Shapes::StringShape.new(name: 'ValidationExceptionReason')
     VcfHostnames = Shapes::StructureShape.new(name: 'VcfHostnames')
     VcfVersion = Shapes::StringShape.new(name: 'VcfVersion')
+    VcfVersionInfo = Shapes::StructureShape.new(name: 'VcfVersionInfo')
+    VcfVersionList = Shapes::ListShape.new(name: 'VcfVersionList')
     Vlan = Shapes::StructureShape.new(name: 'Vlan')
     VlanId = Shapes::IntegerShape.new(name: 'VlanId')
     VlanList = Shapes::ListShape.new(name: 'VlanList')
@@ -141,6 +151,7 @@ module Aws::Evs
     CreateEnvironmentHostRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "clientToken", metadata: {"idempotencyToken" => true}))
     CreateEnvironmentHostRequest.add_member(:environment_id, Shapes::ShapeRef.new(shape: EnvironmentId, required: true, location_name: "environmentId"))
     CreateEnvironmentHostRequest.add_member(:host, Shapes::ShapeRef.new(shape: HostInfoForCreate, required: true, location_name: "host"))
+    CreateEnvironmentHostRequest.add_member(:esx_version, Shapes::ShapeRef.new(shape: EsxVersion, location_name: "esxVersion"))
     CreateEnvironmentHostRequest.struct_class = Types::CreateEnvironmentHostRequest
 
     CreateEnvironmentHostResponse.add_member(:environment_summary, Shapes::ShapeRef.new(shape: EnvironmentSummary, location_name: "environmentSummary"))
@@ -235,12 +246,20 @@ module Aws::Evs
 
     EnvironmentSummaryList.member = Shapes::ShapeRef.new(shape: EnvironmentSummary)
 
+    EsxVersionList.member = Shapes::ShapeRef.new(shape: String)
+
     GetEnvironmentRequest.add_member(:environment_id, Shapes::ShapeRef.new(shape: EnvironmentId, required: true, location_name: "environmentId"))
     GetEnvironmentRequest.struct_class = Types::GetEnvironmentRequest
 
     GetEnvironmentResponse.add_member(:environment, Shapes::ShapeRef.new(shape: Environment, location_name: "environment"))
     GetEnvironmentResponse.struct_class = Types::GetEnvironmentResponse
 
+    GetVersionsRequest.struct_class = Types::GetVersionsRequest
+
+    GetVersionsResponse.add_member(:vcf_versions, Shapes::ShapeRef.new(shape: VcfVersionList, required: true, location_name: "vcfVersions"))
+    GetVersionsResponse.add_member(:instance_type_esx_versions, Shapes::ShapeRef.new(shape: InstanceTypeEsxVersionsList, required: true, location_name: "instanceTypeEsxVersions"))
+    GetVersionsResponse.struct_class = Types::GetVersionsResponse
+
     Host.add_member(:host_name, Shapes::ShapeRef.new(shape: HostName, location_name: "hostName"))
     Host.add_member(:ip_address, Shapes::ShapeRef.new(shape: IpAddress, location_name: "ipAddress"))
     Host.add_member(:key_name, Shapes::ShapeRef.new(shape: KeyName, location_name: "keyName"))
@@ -283,6 +302,17 @@ module Aws::Evs
     InitialVlans.add_member(:hcx_network_acl_id, Shapes::ShapeRef.new(shape: NetworkAclId, location_name: "hcxNetworkAclId"))
     InitialVlans.struct_class = Types::InitialVlans
 
+    InstanceTypeEsxVersionsInfo.add_member(:instance_type, Shapes::ShapeRef.new(shape: InstanceType, required: true, location_name: "instanceType"))
+    InstanceTypeEsxVersionsInfo.add_member(:esx_versions, Shapes::ShapeRef.new(shape: EsxVersionList, required: true, location_name: "esxVersions"))
+    InstanceTypeEsxVersionsInfo.struct_class = Types::InstanceTypeEsxVersionsInfo
+
+    InstanceTypeEsxVersionsList.member = Shapes::ShapeRef.new(shape: InstanceTypeEsxVersionsInfo)
+
+    InstanceTypeList.member = Shapes::ShapeRef.new(shape: InstanceType)
+
+    InternalServerException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
+    InternalServerException.struct_class = Types::InternalServerException
+
     LicenseInfo.add_member(:solution_key, Shapes::ShapeRef.new(shape: SolutionKey, required: true, location_name: "solutionKey"))
     LicenseInfo.add_member(:vsan_key, Shapes::ShapeRef.new(shape: VSanLicenseKey, required: true, location_name: "vsanKey"))
     LicenseInfo.struct_class = Types::LicenseInfo
@@ -399,6 +429,14 @@ module Aws::Evs
     VcfHostnames.add_member(:cloud_builder, Shapes::ShapeRef.new(shape: HostName, required: true, location_name: "cloudBuilder"))
     VcfHostnames.struct_class = Types::VcfHostnames
 
+    VcfVersionInfo.add_member(:vcf_version, Shapes::ShapeRef.new(shape: VcfVersion, required: true, location_name: "vcfVersion"))
+    VcfVersionInfo.add_member(:status, Shapes::ShapeRef.new(shape: String, required: true, location_name: "status"))
+    VcfVersionInfo.add_member(:default_esx_version, Shapes::ShapeRef.new(shape: String, required: true, location_name: "defaultEsxVersion"))
+    VcfVersionInfo.add_member(:instance_types, Shapes::ShapeRef.new(shape: InstanceTypeList, required: true, location_name: "instanceTypes"))
+    VcfVersionInfo.struct_class = Types::VcfVersionInfo
+
+    VcfVersionList.member = Shapes::ShapeRef.new(shape: VcfVersionInfo)
+
     Vlan.add_member(:vlan_id, Shapes::ShapeRef.new(shape: VlanId, location_name: "vlanId"))
     Vlan.add_member(:cidr, Shapes::ShapeRef.new(shape: Cidr, location_name: "cidr"))
     Vlan.add_member(:availability_zone, Shapes::ShapeRef.new(shape: String, location_name: "availabilityZone"))
@@ -508,6 +546,16 @@ module Aws::Evs
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
 
+      api.add_operation(:get_versions, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetVersions"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetVersionsRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetVersionsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+      end)
+
       api.add_operation(:list_environment_hosts, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListEnvironmentHosts"
         o.http_method = "POST"

data/lib/aws-sdk-evs/errors.rb

@@ -27,6 +27,7 @@ module Aws::Evs
   # See {Seahorse::Client::RequestContext} for more information.
   #
   # ## Error Classes
+  # * {InternalServerException}
   # * {ResourceNotFoundException}
   # * {ServiceQuotaExceededException}
   # * {TagPolicyException}
@@ -40,6 +41,25 @@ module Aws::Evs
 
     extend Aws::Errors::DynamicErrors
 
+    class InternalServerException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::Evs::Types::InternalServerException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+
+      def retryable?
+        true
+      end
+    end
+
     class ResourceNotFoundException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

data/lib/aws-sdk-evs/types.rb

@@ -84,7 +84,7 @@ module Aws::Evs
     #     the environment, this check fails.
     #
     #   * `HOST_COUNT`: Checks that your environment has a minimum of 4
-    #     hosts, which is a requirement for VCF 5.2.1.
+    #     hosts.
     #
     #     If this check fails, you will need to add hosts so that your
     #     environment meets this minimum requirement. Amazon EVS only
@@ -150,12 +150,17 @@ module Aws::Evs
     #   The host that is created and added to the environment.
     #   @return [Types::HostInfoForCreate]
     #
+    # @!attribute [rw] esx_version
+    #   The ESX version to use for the host.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/evs-2023-07-27/CreateEnvironmentHostRequest AWS API Documentation
     #
     class CreateEnvironmentHostRequest < Struct.new(
       :client_token,
       :environment_id,
-      :host)
+      :host,
+      :esx_version)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -254,7 +259,7 @@ module Aws::Evs
     #   Connect virtual private gateway associations.
     #
     #   <note markdown="1"> Ensure that you specify a VPC that is adequately sized to
-    #   accommodate the \{evws} subnets.
+    #   accommodate the Amazon EVS subnets.
     #
     #    </note>
     #   @return [String]
@@ -267,8 +272,7 @@ module Aws::Evs
     #   @return [String]
     #
     # @!attribute [rw] vcf_version
-    #   The VCF version to use for the environment. Amazon EVS only supports
-    #   VCF version 5.2.1 at this time.
+    #   The VCF version to use for the environment.
     #   @return [String]
     #
     # @!attribute [rw] terms_accepted
@@ -306,7 +310,7 @@ module Aws::Evs
     #   @return [Types::InitialVlans]
     #
     # @!attribute [rw] hosts
-    #   The ESXi hosts to add to the environment. Amazon EVS requires that
+    #   The ESX hosts to add to the environment. Amazon EVS requires that
     #   you provide details for a minimum of 4 hosts during environment
     #   creation.
     #
@@ -770,11 +774,34 @@ module Aws::Evs
       include Aws::Structure
     end
 
-    # An ESXi 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.
+    # @api private
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/evs-2023-07-27/GetVersionsRequest AWS API Documentation
+    #
+    class GetVersionsRequest < Aws::EmptyStructure; end
+
+    # @!attribute [rw] vcf_versions
+    #   A list of VCF versions with their availability status, default ESX
+    #   version, and instance types.
+    #   @return [Array<Types::VcfVersionInfo>]
+    #
+    # @!attribute [rw] instance_type_esx_versions
+    #   A list of EC2 instance types and their available ESX versions.
+    #   @return [Array<Types::InstanceTypeEsxVersionsInfo>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/evs-2023-07-27/GetVersionsResponse AWS API Documentation
+    #
+    class GetVersionsResponse < Struct.new(
+      :vcf_versions,
+      :instance_type_esx_versions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # 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.
     #
     # @!attribute [rw] host_name
     #   The DNS hostname of the host. DNS hostnames for hosts must be unique
@@ -792,6 +819,10 @@ module Aws::Evs
     # @!attribute [rw] instance_type
     #   The EC2 instance type of the host.
     #
+    #   <note markdown="1"> Currently, Amazon EVS supports only the `i4i.metal` instance type.
+    #
+    #    </note>
+    #
     #   <note markdown="1"> EC2 instances created through Amazon EVS do not support associating
     #   an IAM instance profile.
     #
@@ -868,6 +899,10 @@ module Aws::Evs
     #
     # @!attribute [rw] instance_type
     #   The EC2 instance type that represents the host.
+    #
+    #   <note markdown="1"> Currently, Amazon EVS supports only the `i4i.metal` instance type.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] placement_group_id
@@ -925,8 +960,8 @@ module Aws::Evs
     #
     # @!attribute [rw] vmk_management
     #   The host VMkernel management VLAN subnet. This VLAN subnet carries
-    #   traffic for managing ESXi hosts and communicating with VMware
-    #   vCenter Server.
+    #   traffic for managing ESX hosts and communicating with VMware vCenter
+    #   Server.
     #   @return [Types::InitialVlanInfo]
     #
     # @!attribute [rw] vm_management
@@ -941,7 +976,7 @@ module Aws::Evs
     #
     # @!attribute [rw] v_san
     #   The vSAN VLAN subnet. This VLAN subnet carries the communication
-    #   between ESXi hosts to implement a vSAN shared storage pool.
+    #   between ESX hosts to implement a vSAN shared storage pool.
     #   @return [Types::InitialVlanInfo]
     #
     # @!attribute [rw] v_tep
@@ -974,7 +1009,7 @@ module Aws::Evs
     #   * The HCX public VLAN CIDR block must be added to the VPC as a
     #     secondary CIDR block.
     #
-    #   * Must have at least three Elastic IP addresses to be allocated from
+    #   * Must have at least two Elastic IP addresses to be allocated from
     #     the public IPAM pool for HCX components.
     #   @return [Types::InitialVlanInfo]
     #
@@ -1023,6 +1058,39 @@ module Aws::Evs
       include Aws::Structure
     end
 
+    # Information about ESX versions offered for each EC2 instance type.
+    #
+    # @!attribute [rw] instance_type
+    #   The EC2 instance type.
+    #   @return [String]
+    #
+    # @!attribute [rw] esx_versions
+    #   The list of ESX versions offered for this instance type.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/evs-2023-07-27/InstanceTypeEsxVersionsInfo AWS API Documentation
+    #
+    class InstanceTypeEsxVersionsInfo < Struct.new(
+      :instance_type,
+      :esx_versions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # An internal server error occurred. Retry your request.
+    #
+    # @!attribute [rw] message
+    #   Describes the error encountered.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/evs-2023-07-27/InternalServerException AWS API Documentation
+    #
+    class InternalServerException < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The license information that Amazon EVS requires to create an
     # environment. Amazon EVS requires two license keys: a VCF solution key
     # and a vSAN license key.
@@ -1369,9 +1437,9 @@ module Aws::Evs
     #
     class TagResourceResponse < Aws::EmptyStructure; end
 
-    # The operation couldn't be performed because the service is throttling
-    # requests. This exception is thrown when there are too many requests
-    # accepted concurrently from the service endpoint.
+    # The operation could not be performed because the service is throttling
+    # requests. This exception is thrown when the service endpoint receives
+    # too many concurrent requests.
     #
     # @!attribute [rw] message
     #   Describes the error encountered.
@@ -1542,6 +1610,52 @@ module Aws::Evs
       include Aws::Structure
     end
 
+    # Information about a VCF versions provided by Amazon EVS, including its
+    # status, default ESX version, and EC2 instance types.
+    #
+    # @!attribute [rw] vcf_version
+    #   The VCF version number.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The status for this VCF version. Valid values are:
+    #
+    #   * `AVAILABLE` - This VCF version is available to you.
+    #
+    #   * `RESTRICTED` - This VCF version has limited availability.
+    #
+    #   <note markdown="1"> If the version you need shows RESTRICTED, and you require, check out
+    #   [VCF versions and EC2 instance types provided by Amazon EVS][1] for
+    #   more information.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/evs/latest/userguide/versions-provided.html
+    #   @return [String]
+    #
+    # @!attribute [rw] default_esx_version
+    #   The default ESX version for this VCF version. It is based on
+    #   Broadcom's Bill Of Materials (BOM).
+    #   @return [String]
+    #
+    # @!attribute [rw] instance_types
+    #   EC2 instance types provided by Amazon EVS for this VCF version for
+    #   creating environments.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/evs-2023-07-27/VcfVersionInfo AWS API Documentation
+    #
+    class VcfVersionInfo < Struct.new(
+      :vcf_version,
+      :status,
+      :default_esx_version,
+      :instance_types)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The VLANs that Amazon EVS creates during environment creation.
     #
     # @!attribute [rw] vlan_id

data/lib/aws-sdk-evs.rb

@@ -55,7 +55,7 @@ module Aws::Evs
   autoload :EndpointProvider, 'aws-sdk-evs/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-evs/endpoints'
 
-  GEM_VERSION = '1.11.0'
+  GEM_VERSION = '1.12.0'
 
 end
 

data/sig/client.rbs

@@ -107,7 +107,7 @@ module Aws
                                 },
                                 vpc_id: ::String,
                                 service_access_subnet_id: ::String,
-                                vcf_version: ("VCF-5.2.1"),
+                                vcf_version: ("VCF-5.2.1" | "VCF-5.2.2"),
                                 terms_accepted: bool,
                                 license_info: Array[
                                   {
@@ -191,7 +191,8 @@ module Aws
                                        instance_type: ("i4i.metal"),
                                        placement_group_id: ::String?,
                                        dedicated_host_id: ::String?
-                                     }
+                                     },
+                                     ?esx_version: ::String
                                    ) -> _CreateEnvironmentHostResponseSuccess
                                  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateEnvironmentHostResponseSuccess
 
@@ -242,6 +243,16 @@ module Aws
                            ) -> _GetEnvironmentResponseSuccess
                          | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetEnvironmentResponseSuccess
 
+      interface _GetVersionsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::GetVersionsResponse]
+        def vcf_versions: () -> ::Array[Types::VcfVersionInfo]
+        def instance_type_esx_versions: () -> ::Array[Types::InstanceTypeEsxVersionsInfo]
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Evs/Client.html#get_versions-instance_method
+      def get_versions: (
+                        ) -> _GetVersionsResponseSuccess
+                      | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetVersionsResponseSuccess
+
       interface _ListEnvironmentHostsResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ListEnvironmentHostsResponse]
         def next_token: () -> ::String

data/sig/errors.rbs

@@ -11,6 +11,9 @@ module Aws
       class ServiceError < ::Aws::Errors::ServiceError
       end
 
+      class InternalServerException < ::Aws::Errors::ServiceError
+        def message: () -> ::String
+      end
       class ResourceNotFoundException < ::Aws::Errors::ServiceError
         def message: () -> ::String
         def resource_id: () -> ::String

data/sig/types.rbs

@@ -37,6 +37,7 @@ module Aws::Evs
       attr_accessor client_token: ::String
       attr_accessor environment_id: ::String
       attr_accessor host: Types::HostInfoForCreate
+      attr_accessor esx_version: ::String
       SENSITIVE: []
     end
 
@@ -54,7 +55,7 @@ module Aws::Evs
       attr_accessor service_access_security_groups: Types::ServiceAccessSecurityGroups
       attr_accessor vpc_id: ::String
       attr_accessor service_access_subnet_id: ::String
-      attr_accessor vcf_version: ("VCF-5.2.1")
+      attr_accessor vcf_version: ("VCF-5.2.1" | "VCF-5.2.2")
       attr_accessor terms_accepted: bool
       attr_accessor license_info: ::Array[Types::LicenseInfo]
       attr_accessor initial_vlans: Types::InitialVlans
@@ -124,7 +125,7 @@ module Aws::Evs
       attr_accessor environment_name: ::String
       attr_accessor vpc_id: ::String
       attr_accessor service_access_subnet_id: ::String
-      attr_accessor vcf_version: ("VCF-5.2.1")
+      attr_accessor vcf_version: ("VCF-5.2.1" | "VCF-5.2.2")
       attr_accessor terms_accepted: bool
       attr_accessor license_info: ::Array[Types::LicenseInfo]
       attr_accessor site_id: ::String
@@ -141,7 +142,7 @@ module Aws::Evs
     class EnvironmentSummary
       attr_accessor environment_id: ::String
       attr_accessor environment_name: ::String
-      attr_accessor vcf_version: ("VCF-5.2.1")
+      attr_accessor vcf_version: ("VCF-5.2.1" | "VCF-5.2.2")
       attr_accessor environment_status: ("PASSED" | "FAILED" | "UNKNOWN")
       attr_accessor environment_state: ("CREATING" | "CREATED" | "DELETING" | "DELETED" | "CREATE_FAILED")
       attr_accessor created_at: ::Time
@@ -160,6 +161,15 @@ module Aws::Evs
       SENSITIVE: []
     end
 
+    class GetVersionsRequest < Aws::EmptyStructure
+    end
+
+    class GetVersionsResponse
+      attr_accessor vcf_versions: ::Array[Types::VcfVersionInfo]
+      attr_accessor instance_type_esx_versions: ::Array[Types::InstanceTypeEsxVersionsInfo]
+      SENSITIVE: []
+    end
+
     class Host
       attr_accessor host_name: ::String
       attr_accessor ip_address: ::String
@@ -206,6 +216,17 @@ module Aws::Evs
       SENSITIVE: []
     end
 
+    class InstanceTypeEsxVersionsInfo
+      attr_accessor instance_type: ("i4i.metal")
+      attr_accessor esx_versions: ::Array[::String]
+      SENSITIVE: []
+    end
+
+    class InternalServerException
+      attr_accessor message: ::String
+      SENSITIVE: []
+    end
+
     class LicenseInfo
       attr_accessor solution_key: ::String
       attr_accessor vsan_key: ::String
@@ -348,6 +369,14 @@ module Aws::Evs
       SENSITIVE: []
     end
 
+    class VcfVersionInfo
+      attr_accessor vcf_version: ("VCF-5.2.1" | "VCF-5.2.2")
+      attr_accessor status: ::String
+      attr_accessor default_esx_version: ::String
+      attr_accessor instance_types: ::Array[("i4i.metal")]
+      SENSITIVE: []
+    end
+
     class Vlan
       attr_accessor vlan_id: ::Integer
       attr_accessor cidr: ::String

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-evs
 version: !ruby/object:Gem::Version
-  version: 1.11.0
+  version: 1.12.0
 platform: ruby
 authors:
 - Amazon Web Services