aws-sdk-evs 1.2.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9691f1eacbf0ff3921f9fd9e7e8e85655b189c477743b14bf86237d6921c0cb0
4
- data.tar.gz: 9ef6033ee3bd3387edf7ce6e6bdc968c10398a1f77e018c467b6b2e83cbac5e0
3
+ metadata.gz: 5b0595430b2dc55bd308a7d89e91e1fc24f0d805f0771dd86050424dab09ec51
4
+ data.tar.gz: 9435366fbfd44633ee9431b290381edc2aff6c2db8c11b1b3f518d2389dfe597
5
5
  SHA512:
6
- metadata.gz: 03ae47dc8f3873037ad6cb96b82efff4192fe982c55cee46ffcc312815f1682e30dbb8cf462eb9f1b2006f0d872a7e0ac2db12679cad75d446b5e605e4aab607
7
- data.tar.gz: e1008bc5a68bc020a1ce7d2ef84a3e715628fc651c9eab9b89a49742260d154d3a69db3fc450468a160dedb5766be1d648d5022e51fbd2c6ffa1beea628d0f68
6
+ metadata.gz: 1f3353d6ad47e39e152ced1647f89d8050b96454703f9352ef8d3b67eec541b3f2e3bd94c9d92d072a8956092ac25b8c631dc7589dc9a8c684334570154819dd
7
+ data.tar.gz: 77f50a2cf9e169eed50d53034173e3d9930c9323ffa6346ef0def077c8c240b62e62ff1fc147e6e876bc8b442523da6afbe242a1b46e4777246b62438a1ad0c0
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.3.0 (2025-08-04)
5
+ ------------------
6
+
7
+ * Feature - TagResource API now throws ServiceQuotaExceededException when the number of tags on the Amazon EVS resource exceeds the maximum allowed. TooManyTagsException is deprecated.
8
+
4
9
  1.2.0 (2025-07-31)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.2.0
1
+ 1.3.0
@@ -95,8 +95,8 @@ module Aws::Evs
95
95
  # class name or an instance of a plugin class.
96
96
  #
97
97
  # @option options [required, Aws::CredentialProvider] :credentials
98
- # Your AWS credentials used for authentication. This can be an instance of any one of the
99
- # following classes:
98
+ # Your AWS credentials used for authentication. This can be any class that includes and implements
99
+ # `Aws::CredentialProvider`, or instance of any one of the following classes:
100
100
  #
101
101
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
102
102
  # credentials.
@@ -124,8 +124,7 @@ module Aws::Evs
124
124
  # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
125
125
  # from the Cognito Identity service.
126
126
  #
127
- # When `:credentials` are not configured directly, the following
128
- # locations will be searched for credentials:
127
+ # When `:credentials` are not configured directly, the following locations will be searched for credentials:
129
128
  #
130
129
  # * `Aws.config[:credentials]`
131
130
  #
@@ -139,12 +138,10 @@ module Aws::Evs
139
138
  #
140
139
  # * `~/.aws/config`
141
140
  #
142
- # * EC2/ECS IMDS instance profile - When used by default, the timeouts
143
- # are very aggressive. Construct and pass an instance of
144
- # `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
145
- # enable retries and extended timeouts. Instance profile credential
146
- # fetching can be disabled by setting `ENV['AWS_EC2_METADATA_DISABLED']`
147
- # to `true`.
141
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts are very aggressive.
142
+ # Construct and pass an instance of `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
143
+ # enable retries and extended timeouts. Instance profile credential fetching can be disabled by
144
+ # setting `ENV['AWS_EC2_METADATA_DISABLED']` to `true`.
148
145
  #
149
146
  # @option options [required, String] :region
150
147
  # The AWS region to connect to. The configured `:region` is
@@ -384,8 +381,8 @@ module Aws::Evs
384
381
  # `Aws::Telemetry::OTelProvider` for telemetry provider.
385
382
  #
386
383
  # @option options [Aws::TokenProvider] :token_provider
387
- # Your Bearer token used for authentication. This can be an instance of any one of the
388
- # following classes:
384
+ # Your Bearer token used for authentication. This can be any class that includes and implements
385
+ # `Aws::TokenProvider`, or instance of any one of the following classes:
389
386
  #
390
387
  # * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
391
388
  # tokens.
@@ -486,28 +483,30 @@ module Aws::Evs
486
483
 
487
484
  # @!group API Operations
488
485
 
489
- # Creates an Amazon EVS environment that runs VCF software, such as SDDC
486
+ # <note markdown="1"> Amazon EVS is in public preview release and is
487
+ # subject to change.
488
+ #
489
+ # </note>
490
+ #
491
+ # Creates an Amazon EVS environment that runs VCF software, such as
492
+ # SDDC
490
493
  # Manager, NSX Manager, and vCenter Server.
491
494
  #
492
- # During environment creation, Amazon EVS performs validations on DNS
495
+ # During environment creation, Amazon EVS performs validations on DNS
493
496
  # settings, provisions VLAN subnets and hosts, and deploys the supplied
494
497
  # version of VCF.
495
498
  #
496
- # It can take several hours to create an environment. After the
497
- # deployment completes, you can configure VCF according to your unique
498
- # requirements.
499
+ # It can take several hours to create an environment. After the
500
+ # deployment completes, you can configure VCF in the vSphere user
501
+ # interface according to your needs.
499
502
  #
500
- # <note markdown="1"> You cannot use the `dedicatedHostId` and `placementGroupId` parameters
503
+ # <note markdown="1"> You cannot use the `dedicatedHostId` and
504
+ # `placementGroupId` parameters
501
505
  # together in the same `CreateEnvironment` action. This results in a
502
506
  # `ValidationException` response.
503
507
  #
504
508
  # </note>
505
509
  #
506
- # <note markdown="1"> EC2 instances created through Amazon EVS do not support associating an
507
- # IAM instance profile.
508
- #
509
- # </note>
510
- #
511
510
  # @option params [String] :client_token
512
511
  # <note markdown="1"> This parameter is not used in Amazon EVS
513
512
  # currently. If you supply
@@ -561,25 +560,27 @@ module Aws::Evs
561
560
  # adding or removing hosts to fail.
562
561
  #
563
562
  # @option params [required, String] :vpc_id
564
- # A unique ID for the VPC that connects to the environment control plane
565
- # for service access.
563
+ # A unique ID for the VPC that the environment is deployed inside.
566
564
  #
567
565
  # Amazon EVS requires that all VPC subnets exist in a single
568
566
  # Availability Zone in a Region where the service is available.
569
567
  #
570
- # The VPC that you select must have a valid DHCP option set with domain
568
+ # The VPC that you specify must have a valid DHCP option set with domain
571
569
  # name, at least two DNS servers, and an NTP server. These settings are
572
- # used to configure your VCF appliances and hosts.
573
- #
574
- # If you plan to use HCX over the internet, choose a VPC that has a
575
- # primary CIDR block and a /28 secondary CIDR block from an IPAM pool.
576
- # Make sure that your VPC also has an attached internet gateway.
570
+ # used to configure your VCF appliances and hosts. The VPC cannot be
571
+ # used with any other deployed Amazon EVS environment. Amazon EVS does
572
+ # not provide multi-VPC support for environments at this time.
577
573
  #
578
574
  # Amazon EVS does not support the following Amazon Web Services
579
575
  # networking options for NSX overlay connectivity: cross-Region VPC
580
576
  # peering, Amazon S3 gateway endpoints, or Amazon Web Services Direct
581
577
  # Connect virtual private gateway associations.
582
578
  #
579
+ # <note markdown="1"> Ensure that you specify a VPC that is adequately sized to accommodate
580
+ # the \{evws} subnets.
581
+ #
582
+ # </note>
583
+ #
583
584
  # @option params [required, String] :service_access_subnet_id
584
585
  # The subnet that is used to establish connectivity between the Amazon
585
586
  # EVS control plane and VPC. Amazon EVS uses this subnet to validate
@@ -591,16 +592,20 @@ module Aws::Evs
591
592
  # VCF version 5.2.1 at this time.
592
593
  #
593
594
  # @option params [required, Boolean] :terms_accepted
594
- # Customer confirmation that the customer has purchased and maintains
595
- # sufficient VCF software licenses to cover all physical processor cores
596
- # in the environment, in compliance with VMware's licensing
597
- # requirements and terms of use.
595
+ # Customer confirmation that the customer has purchased and will
596
+ # continue to maintain the required number of VCF software licenses to
597
+ # cover all physical processor cores in the Amazon EVS environment.
598
+ # Information about your VCF software in Amazon EVS will be shared with
599
+ # Broadcom to verify license compliance. Amazon EVS does not validate
600
+ # license keys. To validate license keys, visit the Broadcom support
601
+ # portal.
598
602
  #
599
603
  # @option params [required, Array<Types::LicenseInfo>] :license_info
600
604
  # The license information that Amazon EVS requires to create an
601
605
  # environment. Amazon EVS requires two license keys: a VCF solution key
602
- # and a vSAN license key. VCF licenses must have sufficient core
603
- # entitlements to cover vCPU core and vSAN storage capacity needs.
606
+ # and a vSAN license key. The VCF solution key must cover a minimum of
607
+ # 256 cores. The vSAN license key must provide at least 110 TiB of vSAN
608
+ # capacity.
604
609
  #
605
610
  # VCF licenses can be used for only one Amazon EVS environment. Amazon
606
611
  # EVS does not support reuse of VCF licenses for multiple environments.
@@ -608,23 +613,29 @@ module Aws::Evs
608
613
  # VCF license information can be retrieved from the Broadcom portal.
609
614
  #
610
615
  # @option params [required, Types::InitialVlans] :initial_vlans
611
- # The initial VLAN subnets for the environment. You must specify a
612
- # non-overlapping CIDR block for each VLAN subnet.
616
+ # The initial VLAN subnets for the Amazon EVS environment.
617
+ #
618
+ # <note markdown="1"> For each Amazon EVS VLAN subnet, you must specify a non-overlapping
619
+ # CIDR block. Amazon EVS VLAN subnets have a minimum CIDR block size of
620
+ # /28 and a maximum size of /24.
621
+ #
622
+ # </note>
613
623
  #
614
624
  # @option params [required, Array<Types::HostInfoForCreate>] :hosts
615
625
  # The ESXi hosts to add to the environment. Amazon EVS requires that you
616
626
  # provide details for a minimum of 4 hosts during environment creation.
617
627
  #
618
- # For each host, you must provide the desired hostname, EC2 SSH key, and
619
- # EC2 instance type. Optionally, you can also provide a partition or
620
- # cluster placement group to use, or use Amazon EC2 Dedicated Hosts.
628
+ # For each host, you must provide the desired hostname, EC2 SSH keypair
629
+ # name, and EC2 instance type. Optionally, you can also provide a
630
+ # partition or cluster placement group to use, or use Amazon EC2
631
+ # Dedicated Hosts.
621
632
  #
622
633
  # @option params [required, Types::ConnectivityInfo] :connectivity_info
623
634
  # The connectivity configuration for the environment. Amazon EVS
624
635
  # requires that you specify two route server peer IDs. During
625
636
  # environment creation, the route server endpoints peer with the NSX
626
- # edges over the NSX, providing BGP dynamic routing for overlay
627
- # networks.
637
+ # edges over the NSX uplink subnet, providing BGP-based dynamic routing
638
+ # for overlay networks.
628
639
  #
629
640
  # @option params [required, Types::VcfHostnames] :vcf_hostnames
630
641
  # The DNS hostnames for the virtual machines that host the VCF
@@ -772,30 +783,33 @@ module Aws::Evs
772
783
  req.send_request(options)
773
784
  end
774
785
 
775
- # Creates an ESXi host and adds it to an Amazon EVS environment. Amazon
786
+ # <note markdown="1"> Amazon EVS is in public preview release and is
787
+ # subject to change.
788
+ #
789
+ # </note>
790
+ #
791
+ # Creates an ESXi host and adds it to an Amazon EVS environment. Amazon
776
792
  # EVS supports 4-16 hosts per environment.
777
793
  #
778
- # This action can only be used after the Amazon EVS environment is
794
+ # This action can only be used after the Amazon EVS environment is
779
795
  # deployed. All Amazon EVS hosts are created with the latest AMI release
780
- # version for the respective VCF version of the environment.
796
+ # version for the respective VCF version of the environment. Amazon EVS
797
+ # hosts are commissioned in the SDDC Manager inventory as unassigned
798
+ # hosts.
781
799
  #
782
- # You can use the `dedicatedHostId` parameter to specify an Amazon EC2
800
+ # You can use the `dedicatedHostId` parameter to specify an Amazon EC2
783
801
  # Dedicated Host for ESXi host creation.
784
802
  #
785
- # You can use the `placementGroupId` parameter to specify a cluster or
803
+ # You can use the `placementGroupId` parameter to specify a cluster or
786
804
  # partition placement group to launch EC2 instances into.
787
805
  #
788
- # <note markdown="1"> You cannot use the `dedicatedHostId` and `placementGroupId` parameters
806
+ # <note markdown="1"> You cannot use the `dedicatedHostId` and
807
+ # `placementGroupId` parameters
789
808
  # together in the same `CreateEnvironmentHost` action. This results in a
790
809
  # `ValidationException` response.
791
810
  #
792
811
  # </note>
793
812
  #
794
- # <note markdown="1"> EC2 instances created through Amazon EVS do not support associating an
795
- # IAM instance profile.
796
- #
797
- # </note>
798
- #
799
813
  # @option params [String] :client_token
800
814
  # <note markdown="1"> This parameter is not used in Amazon EVS
801
815
  # currently. If you supply
@@ -869,13 +883,18 @@ module Aws::Evs
869
883
  req.send_request(options)
870
884
  end
871
885
 
872
- # Deletes an Amazon EVS environment.
886
+ # <note markdown="1"> Amazon EVS is in public preview release and is
887
+ # subject to change.
888
+ #
889
+ # </note>
873
890
  #
874
- # Amazon EVS environments will only be enabled for deletion once the
891
+ # Deletes an Amazon EVS environment.
892
+ #
893
+ # Amazon EVS environments will only be enabled for deletion once the
875
894
  # hosts are deleted. You can delete hosts using the
876
895
  # `DeleteEnvironmentHost` action.
877
896
  #
878
- # Environment deletion also deletes the associated Amazon EVS VLAN
897
+ # Environment deletion also deletes the associated Amazon EVS VLAN
879
898
  # subnets. Other associated Amazon Web Services resources are not
880
899
  # deleted. These resources may continue to incur costs.
881
900
  #
@@ -956,9 +975,15 @@ module Aws::Evs
956
975
  req.send_request(options)
957
976
  end
958
977
 
959
- # Deletes a host from an Amazon EVS environment.
978
+ # <note markdown="1"> Amazon EVS is in public preview release and is
979
+ # subject to change.
980
+ #
981
+ # </note>
982
+ #
983
+ # Deletes a host from an Amazon EVS environment.
960
984
  #
961
- # <note markdown="1"> Before deleting a host, you must unassign and decommission the host
985
+ # <note markdown="1"> Before deleting a host, you must unassign and
986
+ # decommission the host
962
987
  # from within the SDDC Manager user interface. Not doing so could impact
963
988
  # the availability of your virtual machines or result in data loss.
964
989
  #
@@ -1031,7 +1056,12 @@ module Aws::Evs
1031
1056
  req.send_request(options)
1032
1057
  end
1033
1058
 
1034
- # Returns a description of the specified environment.
1059
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1060
+ # subject to change.
1061
+ #
1062
+ # </note>
1063
+ #
1064
+ # Returns a description of the specified environment.
1035
1065
  #
1036
1066
  # @option params [required, String] :environment_id
1037
1067
  # A unique ID for the environment.
@@ -1094,7 +1124,12 @@ module Aws::Evs
1094
1124
  req.send_request(options)
1095
1125
  end
1096
1126
 
1097
- # List the hosts within an environment.
1127
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1128
+ # subject to change.
1129
+ #
1130
+ # </note>
1131
+ #
1132
+ # List the hosts within an environment.
1098
1133
  #
1099
1134
  # @option params [String] :next_token
1100
1135
  # A unique pagination token for each page. If `nextToken` is returned,
@@ -1153,7 +1188,12 @@ module Aws::Evs
1153
1188
  req.send_request(options)
1154
1189
  end
1155
1190
 
1156
- # Lists environment VLANs that are associated with the specified
1191
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1192
+ # subject to change.
1193
+ #
1194
+ # </note>
1195
+ #
1196
+ # Lists environment VLANs that are associated with the specified
1157
1197
  # environment.
1158
1198
  #
1159
1199
  # @option params [String] :next_token
@@ -1209,7 +1249,12 @@ module Aws::Evs
1209
1249
  req.send_request(options)
1210
1250
  end
1211
1251
 
1212
- # Lists the Amazon EVS environments in your Amazon Web Services account
1252
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1253
+ # subject to change.
1254
+ #
1255
+ # </note>
1256
+ #
1257
+ # Lists the Amazon EVS environments in your Amazon Web Services account
1213
1258
  # in the specified Amazon Web Services Region.
1214
1259
  #
1215
1260
  # @option params [String] :next_token
@@ -1265,7 +1310,12 @@ module Aws::Evs
1265
1310
  req.send_request(options)
1266
1311
  end
1267
1312
 
1268
- # Lists the tags for an Amazon EVS resource.
1313
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1314
+ # subject to change.
1315
+ #
1316
+ # </note>
1317
+ #
1318
+ # Lists the tags for an Amazon EVS resource.
1269
1319
  #
1270
1320
  # @option params [required, String] :resource_arn
1271
1321
  # The Amazon Resource Name (ARN) that identifies the resource to list
@@ -1295,7 +1345,12 @@ module Aws::Evs
1295
1345
  req.send_request(options)
1296
1346
  end
1297
1347
 
1298
- # Associates the specified tags to an Amazon EVS resource with the
1348
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1349
+ # subject to change.
1350
+ #
1351
+ # </note>
1352
+ #
1353
+ # Associates the specified tags to an Amazon EVS resource with the
1299
1354
  # specified `resourceArn`. If existing tags on a resource are not
1300
1355
  # specified in the request parameters, they aren't changed. When a
1301
1356
  # resource is deleted, the tags associated with that resource are also
@@ -1333,7 +1388,12 @@ module Aws::Evs
1333
1388
  req.send_request(options)
1334
1389
  end
1335
1390
 
1336
- # Deletes specified tags from an Amazon EVS resource.
1391
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1392
+ # subject to change.
1393
+ #
1394
+ # </note>
1395
+ #
1396
+ # Deletes specified tags from an Amazon EVS resource.
1337
1397
  #
1338
1398
  # @option params [required, String] :resource_arn
1339
1399
  # The Amazon Resource Name (ARN) of the resource to delete tags from.
@@ -1377,7 +1437,7 @@ module Aws::Evs
1377
1437
  tracer: tracer
1378
1438
  )
1379
1439
  context[:gem_name] = 'aws-sdk-evs'
1380
- context[:gem_version] = '1.2.0'
1440
+ context[:gem_version] = '1.3.0'
1381
1441
  Seahorse::Client::Request.new(handlers, context)
1382
1442
  end
1383
1443
 
@@ -79,6 +79,7 @@ module Aws::Evs
79
79
  SecurityGroupId = Shapes::StringShape.new(name: 'SecurityGroupId')
80
80
  SecurityGroups = Shapes::ListShape.new(name: 'SecurityGroups')
81
81
  ServiceAccessSecurityGroups = Shapes::StructureShape.new(name: 'ServiceAccessSecurityGroups')
82
+ ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
82
83
  SolutionKey = Shapes::StringShape.new(name: 'SolutionKey')
83
84
  StateDetails = Shapes::StringShape.new(name: 'StateDetails')
84
85
  String = Shapes::StringShape.new(name: 'String')
@@ -311,6 +312,9 @@ module Aws::Evs
311
312
  ServiceAccessSecurityGroups.add_member(:security_groups, Shapes::ShapeRef.new(shape: SecurityGroups, location_name: "securityGroups"))
312
313
  ServiceAccessSecurityGroups.struct_class = Types::ServiceAccessSecurityGroups
313
314
 
315
+ ServiceQuotaExceededException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
316
+ ServiceQuotaExceededException.struct_class = Types::ServiceQuotaExceededException
317
+
314
318
  TagKeys.member = Shapes::ShapeRef.new(shape: TagKey)
315
319
 
316
320
  TagPolicyException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
@@ -503,6 +507,7 @@ module Aws::Evs
503
507
  o.http_request_uri = "/"
504
508
  o.input = Shapes::ShapeRef.new(shape: TagResourceRequest)
505
509
  o.output = Shapes::ShapeRef.new(shape: TagResourceResponse)
510
+ o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
506
511
  o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
507
512
  o.errors << Shapes::ShapeRef.new(shape: TooManyTagsException)
508
513
  o.errors << Shapes::ShapeRef.new(shape: TagPolicyException)
@@ -28,6 +28,7 @@ module Aws::Evs
28
28
  #
29
29
  # ## Error Classes
30
30
  # * {ResourceNotFoundException}
31
+ # * {ServiceQuotaExceededException}
31
32
  # * {TagPolicyException}
32
33
  # * {ThrottlingException}
33
34
  # * {TooManyTagsException}
@@ -64,6 +65,21 @@ module Aws::Evs
64
65
  end
65
66
  end
66
67
 
68
+ class ServiceQuotaExceededException < ServiceError
69
+
70
+ # @param [Seahorse::Client::RequestContext] context
71
+ # @param [String] message
72
+ # @param [Aws::Evs::Types::ServiceQuotaExceededException] data
73
+ def initialize(context, message, data = Aws::EmptyStructure.new)
74
+ super(context, message, data)
75
+ end
76
+
77
+ # @return [String]
78
+ def message
79
+ @message || @data[:message]
80
+ end
81
+ end
82
+
67
83
  class TagPolicyException < ServiceError
68
84
 
69
85
  # @param [Seahorse::Client::RequestContext] context
@@ -10,7 +10,13 @@
10
10
  module Aws::Evs
11
11
  module Types
12
12
 
13
- # A check on the environment to identify environment health and validate
13
+ # <note markdown="1"> Amazon EVS is in public preview release and is
14
+ # subject to change.
15
+ #
16
+ # </note>
17
+ #
18
+ # A check on the environment to identify environment health and
19
+ # validate
14
20
  # VMware VCF licensing compliance.
15
21
  #
16
22
  # @!attribute [rw] type
@@ -56,7 +62,12 @@ module Aws::Evs
56
62
  include Aws::Structure
57
63
  end
58
64
 
59
- # The connectivity configuration for the environment. Amazon EVS
65
+ # <note markdown="1"> Amazon EVS is in public preview release and is
66
+ # subject to change.
67
+ #
68
+ # </note>
69
+ #
70
+ # The connectivity configuration for the environment. Amazon EVS
60
71
  # requires that you specify two route server peer IDs. During
61
72
  # environment creation, the route server endpoints peer with the NSX
62
73
  # uplink VLAN for connectivity to the NSX overlay network.
@@ -183,24 +194,27 @@ module Aws::Evs
183
194
  # @return [Types::ServiceAccessSecurityGroups]
184
195
  #
185
196
  # @!attribute [rw] vpc_id
186
- # A unique ID for the VPC that connects to the environment control
187
- # plane for service access.
197
+ # A unique ID for the VPC that the environment is deployed inside.
188
198
  #
189
199
  # Amazon EVS requires that all VPC subnets exist in a single
190
200
  # Availability Zone in a Region where the service is available.
191
201
  #
192
- # The VPC that you select must have a valid DHCP option set with
202
+ # The VPC that you specify must have a valid DHCP option set with
193
203
  # domain name, at least two DNS servers, and an NTP server. These
194
- # settings are used to configure your VCF appliances and hosts.
195
- #
196
- # If you plan to use HCX over the internet, choose a VPC that has a
197
- # primary CIDR block and a /28 secondary CIDR block from an IPAM pool.
198
- # Make sure that your VPC also has an attached internet gateway.
204
+ # settings are used to configure your VCF appliances and hosts. The
205
+ # VPC cannot be used with any other deployed Amazon EVS environment.
206
+ # Amazon EVS does not provide multi-VPC support for environments at
207
+ # this time.
199
208
  #
200
209
  # Amazon EVS does not support the following Amazon Web Services
201
210
  # networking options for NSX overlay connectivity: cross-Region VPC
202
211
  # peering, Amazon S3 gateway endpoints, or Amazon Web Services Direct
203
212
  # Connect virtual private gateway associations.
213
+ #
214
+ # <note markdown="1"> Ensure that you specify a VPC that is adequately sized to
215
+ # accommodate the \{evws} subnets.
216
+ #
217
+ # </note>
204
218
  # @return [String]
205
219
  #
206
220
  # @!attribute [rw] service_access_subnet_id
@@ -216,17 +230,21 @@ module Aws::Evs
216
230
  # @return [String]
217
231
  #
218
232
  # @!attribute [rw] terms_accepted
219
- # Customer confirmation that the customer has purchased and maintains
220
- # sufficient VCF software licenses to cover all physical processor
221
- # cores in the environment, in compliance with VMware's licensing
222
- # requirements and terms of use.
233
+ # Customer confirmation that the customer has purchased and will
234
+ # continue to maintain the required number of VCF software licenses to
235
+ # cover all physical processor cores in the Amazon EVS environment.
236
+ # Information about your VCF software in Amazon EVS will be shared
237
+ # with Broadcom to verify license compliance. Amazon EVS does not
238
+ # validate license keys. To validate license keys, visit the Broadcom
239
+ # support portal.
223
240
  # @return [Boolean]
224
241
  #
225
242
  # @!attribute [rw] license_info
226
243
  # The license information that Amazon EVS requires to create an
227
244
  # environment. Amazon EVS requires two license keys: a VCF solution
228
- # key and a vSAN license key. VCF licenses must have sufficient core
229
- # entitlements to cover vCPU core and vSAN storage capacity needs.
245
+ # key and a vSAN license key. The VCF solution key must cover a
246
+ # minimum of 256 cores. The vSAN license key must provide at least 110
247
+ # TiB of vSAN capacity.
230
248
  #
231
249
  # VCF licenses can be used for only one Amazon EVS environment. Amazon
232
250
  # EVS does not support reuse of VCF licenses for multiple
@@ -236,8 +254,13 @@ module Aws::Evs
236
254
  # @return [Array<Types::LicenseInfo>]
237
255
  #
238
256
  # @!attribute [rw] initial_vlans
239
- # The initial VLAN subnets for the environment. You must specify a
240
- # non-overlapping CIDR block for each VLAN subnet.
257
+ # The initial VLAN subnets for the Amazon EVS environment.
258
+ #
259
+ # <note markdown="1"> For each Amazon EVS VLAN subnet, you must specify a non-overlapping
260
+ # CIDR block. Amazon EVS VLAN subnets have a minimum CIDR block size
261
+ # of /28 and a maximum size of /24.
262
+ #
263
+ # </note>
241
264
  # @return [Types::InitialVlans]
242
265
  #
243
266
  # @!attribute [rw] hosts
@@ -245,18 +268,18 @@ module Aws::Evs
245
268
  # you provide details for a minimum of 4 hosts during environment
246
269
  # creation.
247
270
  #
248
- # For each host, you must provide the desired hostname, EC2 SSH key,
249
- # and EC2 instance type. Optionally, you can also provide a partition
250
- # or cluster placement group to use, or use Amazon EC2 Dedicated
251
- # Hosts.
271
+ # For each host, you must provide the desired hostname, EC2 SSH
272
+ # keypair name, and EC2 instance type. Optionally, you can also
273
+ # provide a partition or cluster placement group to use, or use Amazon
274
+ # EC2 Dedicated Hosts.
252
275
  # @return [Array<Types::HostInfoForCreate>]
253
276
  #
254
277
  # @!attribute [rw] connectivity_info
255
278
  # The connectivity configuration for the environment. Amazon EVS
256
279
  # requires that you specify two route server peer IDs. During
257
280
  # environment creation, the route server endpoints peer with the NSX
258
- # edges over the NSX, providing BGP dynamic routing for overlay
259
- # networks.
281
+ # edges over the NSX uplink subnet, providing BGP-based dynamic
282
+ # routing for overlay networks.
260
283
  # @return [Types::ConnectivityInfo]
261
284
  #
262
285
  # @!attribute [rw] vcf_hostnames
@@ -401,7 +424,12 @@ module Aws::Evs
401
424
  include Aws::Structure
402
425
  end
403
426
 
404
- # An object that represents an Amazon EVS environment.
427
+ # <note markdown="1"> Amazon EVS is in public preview release and is
428
+ # subject to change.
429
+ #
430
+ # </note>
431
+ #
432
+ # An object that represents an Amazon EVS environment.
405
433
  #
406
434
  # @!attribute [rw] environment_id
407
435
  # The unique ID for the environment.
@@ -447,16 +475,21 @@ module Aws::Evs
447
475
  # @return [String]
448
476
  #
449
477
  # @!attribute [rw] terms_accepted
450
- # Customer confirmation that the customer has purchased and maintains
451
- # sufficient VCF software licenses to cover all physical processor
452
- # cores in the environment, in compliance with VMware's licensing
453
- # requirements and terms of use.
478
+ # Customer confirmation that the customer has purchased and will
479
+ # continue to maintain the required number of VCF software licenses to
480
+ # cover all physical processor cores in the Amazon EVS environment.
481
+ # Information about your VCF software in Amazon EVS will be shared
482
+ # with Broadcom to verify license compliance. Amazon EVS does not
483
+ # validate license keys. To validate license keys, visit the Broadcom
484
+ # support portal.
454
485
  # @return [Boolean]
455
486
  #
456
487
  # @!attribute [rw] license_info
457
488
  # The license information that Amazon EVS requires to create an
458
489
  # environment. Amazon EVS requires two license keys: a VCF solution
459
- # key and a vSAN license key.
490
+ # key and a vSAN license key. The VCF solution key must cover a
491
+ # minimum of 256 cores. The vSAN license key must provide at least 110
492
+ # TiB of vSAN capacity.
460
493
  # @return [Array<Types::LicenseInfo>]
461
494
  #
462
495
  # @!attribute [rw] site_id
@@ -546,7 +579,12 @@ module Aws::Evs
546
579
  include Aws::Structure
547
580
  end
548
581
 
549
- # A list of environments with summarized environment details.
582
+ # <note markdown="1"> Amazon EVS is in public preview release and is
583
+ # subject to change.
584
+ #
585
+ # </note>
586
+ #
587
+ # A list of environments with summarized environment details.
550
588
  #
551
589
  # @!attribute [rw] environment_id
552
590
  # A unique ID for the environment.
@@ -621,7 +659,12 @@ module Aws::Evs
621
659
  include Aws::Structure
622
660
  end
623
661
 
624
- # An ESXi host that runs on an Amazon EC2 bare metal instance. Four
662
+ # <note markdown="1"> Amazon EVS is in public preview release and is
663
+ # subject to change.
664
+ #
665
+ # </note>
666
+ #
667
+ # An ESXi host that runs on an Amazon EC2 bare metal instance. Four
625
668
  # hosts are created in an Amazon EVS environment during environment
626
669
  # creation. You can add hosts to an environment using the
627
670
  # `CreateEnvironmentHost` operation. Amazon EVS supports 4-16 hosts per
@@ -700,9 +743,15 @@ module Aws::Evs
700
743
  include Aws::Structure
701
744
  end
702
745
 
703
- # An object that represents a host.
746
+ # <note markdown="1"> Amazon EVS is in public preview release and is
747
+ # subject to change.
748
+ #
749
+ # </note>
704
750
  #
705
- # <note markdown="1"> You cannot use `dedicatedHostId` and `placementGroupId` together in
751
+ # An object that represents a host.
752
+ #
753
+ # <note markdown="1"> You cannot use `dedicatedHostId` and
754
+ # `placementGroupId` together in
706
755
  # the same `HostInfoForCreate`object. This results in a
707
756
  # `ValidationException` response.
708
757
  #
@@ -741,17 +790,30 @@ module Aws::Evs
741
790
  include Aws::Structure
742
791
  end
743
792
 
744
- # An object that represents an initial VLAN subnet for the environment.
745
- # Amazon EVS creates initial VLAN subnets when you first create the
746
- # environment. You must specify a non-overlapping CIDR block for each
747
- # VLAN subnet. Amazon EVS creates the following 10 VLAN subnets: host
748
- # management VLAN, vMotion VLAN, vSAN VLAN, VTEP VLAN, Edge VTEP VLAN,
749
- # Management VM VLAN, HCX uplink VLAN, NSX uplink VLAN, expansion VLAN
750
- # 1, expansion VLAN 2.
793
+ # <note markdown="1"> Amazon EVS is in public preview release and is
794
+ # subject to change.
795
+ #
796
+ # </note>
797
+ #
798
+ # An object that represents an initial VLAN subnet for the Amazon EVS
799
+ # environment. Amazon EVS creates initial VLAN subnets when you first
800
+ # create the environment. Amazon EVS creates the following 10 VLAN
801
+ # subnets: host management VLAN, vMotion VLAN, vSAN VLAN, VTEP VLAN,
802
+ # Edge VTEP VLAN, Management VM VLAN, HCX uplink VLAN, NSX uplink VLAN,
803
+ # expansion VLAN 1, expansion VLAN 2.
804
+ #
805
+ # <note markdown="1"> For each Amazon EVS VLAN subnet, you must specify
806
+ # a non-overlapping
807
+ # CIDR block. Amazon EVS VLAN subnets have a minimum CIDR block size of
808
+ # /28 and a maximum size of /24.
809
+ #
810
+ # </note>
751
811
  #
752
812
  # @!attribute [rw] cidr
753
- # The CIDR block that you provide to create a VLAN subnet. VLAN CIDR
754
- # blocks must not overlap with other subnets in the VPC.
813
+ # The CIDR block that you provide to create an Amazon EVS VLAN subnet.
814
+ # Amazon EVS VLAN subnets have a minimum CIDR block size of /28 and a
815
+ # maximum size of /24. Amazon EVS VLAN subnet CIDR blocks must not
816
+ # overlap with other subnets in the VPC.
755
817
  # @return [String]
756
818
  #
757
819
  # @see http://docs.aws.amazon.com/goto/WebAPI/evs-2023-07-27/InitialVlanInfo AWS API Documentation
@@ -762,11 +824,18 @@ module Aws::Evs
762
824
  include Aws::Structure
763
825
  end
764
826
 
765
- # The initial VLAN subnets for the environment. You must specify a
766
- # non-overlapping CIDR block for each VLAN subnet.
827
+ # <note markdown="1"> Amazon EVS is in public preview release and is
828
+ # subject to change.
829
+ #
830
+ # </note>
831
+ #
832
+ # The initial VLAN subnets for the environment. Amazon EVS VLAN subnets
833
+ # have a minimum CIDR block size of /28 and a maximum size of /24.
834
+ # Amazon EVS VLAN subnet CIDR blocks must not overlap with other subnets
835
+ # in the VPC.
767
836
  #
768
837
  # @!attribute [rw] vmk_management
769
- # The VMkernel management VLAN subnet. This VLAN subnet carries
838
+ # The host VMkernel management VLAN subnet. This VLAN subnet carries
770
839
  # traffic for managing ESXi hosts and communicating with VMware
771
840
  # vCenter Server.
772
841
  # @return [Types::InitialVlanInfo]
@@ -841,17 +910,24 @@ module Aws::Evs
841
910
  include Aws::Structure
842
911
  end
843
912
 
844
- # The license information that Amazon EVS requires to create an
913
+ # <note markdown="1"> Amazon EVS is in public preview release and is
914
+ # subject to change.
915
+ #
916
+ # </note>
917
+ #
918
+ # The license information that Amazon EVS requires to create an
845
919
  # environment. Amazon EVS requires two license keys: a VCF solution key
846
920
  # and a vSAN license key.
847
921
  #
848
922
  # @!attribute [rw] solution_key
849
923
  # The VCF solution key. This license unlocks VMware VCF product
850
924
  # features, including vSphere, NSX, SDDC Manager, and vCenter Server.
925
+ # The VCF solution key must cover a minimum of 256 cores.
851
926
  # @return [String]
852
927
  #
853
928
  # @!attribute [rw] vsan_key
854
- # The VSAN license key. This license unlocks vSAN features.
929
+ # The VSAN license key. This license unlocks vSAN features. The vSAN
930
+ # license key must provide at least 110 TiB of vSAN capacity.
855
931
  # @return [String]
856
932
  #
857
933
  # @see http://docs.aws.amazon.com/goto/WebAPI/evs-2023-07-27/LicenseInfo AWS API Documentation
@@ -1030,7 +1106,12 @@ module Aws::Evs
1030
1106
  include Aws::Structure
1031
1107
  end
1032
1108
 
1033
- # An elastic network interface (ENI) that connects hosts to the VLAN
1109
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1110
+ # subject to change.
1111
+ #
1112
+ # </note>
1113
+ #
1114
+ # An elastic network interface (ENI) that connects hosts to the VLAN
1034
1115
  # subnets. Amazon EVS provisions two identically configured ENIs in the
1035
1116
  # VMkernel management subnet during host creation. One ENI is active,
1036
1117
  # and the other is in standby mode for automatic switchover during a
@@ -1074,7 +1155,12 @@ module Aws::Evs
1074
1155
  include Aws::Structure
1075
1156
  end
1076
1157
 
1077
- # A managed secret that contains the credentials for installing vCenter
1158
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1159
+ # subject to change.
1160
+ #
1161
+ # </note>
1162
+ #
1163
+ # A managed secret that contains the credentials for installing vCenter
1078
1164
  # Server, NSX, and SDDC Manager. During environment creation, the Amazon
1079
1165
  # EVS control plane uses Amazon Web Services Secrets Manager to create,
1080
1166
  # encrypt, validate, and store secrets. If you choose to delete your
@@ -1095,7 +1181,12 @@ module Aws::Evs
1095
1181
  include Aws::Structure
1096
1182
  end
1097
1183
 
1098
- # The security groups that allow traffic between the Amazon EVS control
1184
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1185
+ # subject to change.
1186
+ #
1187
+ # </note>
1188
+ #
1189
+ # The security groups that allow traffic between the Amazon EVS control
1099
1190
  # plane and your VPC for Amazon EVS service access. If a security group
1100
1191
  # is not specified, Amazon EVS uses the default security group in your
1101
1192
  # account for service access.
@@ -1112,9 +1203,43 @@ module Aws::Evs
1112
1203
  include Aws::Structure
1113
1204
  end
1114
1205
 
1115
- # The request doesn't comply with IAM tag policy. Correct your request
1206
+ # The number of one or more Amazon EVS resources exceeds the maximum
1207
+ # allowed. For a list of Amazon EVS quotas, see [Amazon EVS endpoints
1208
+ # and quotas][1] in the *Amazon EVS User Guide*. Delete some resources
1209
+ # or request an increase in your service quota. To request an increase,
1210
+ # see [Amazon Web Services Service Quotas][2] in the *Amazon Web
1211
+ # Services General Reference Guide*.
1212
+ #
1213
+ #
1214
+ #
1215
+ # [1]: https://docs.aws.amazon.com/evs/latest/userguide/service-quotas-evs.html
1216
+ # [2]: https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html
1217
+ #
1218
+ # @!attribute [rw] message
1219
+ # Describes the error encountered.
1220
+ # @return [String]
1221
+ #
1222
+ # @see http://docs.aws.amazon.com/goto/WebAPI/evs-2023-07-27/ServiceQuotaExceededException AWS API Documentation
1223
+ #
1224
+ class ServiceQuotaExceededException < Struct.new(
1225
+ :message)
1226
+ SENSITIVE = []
1227
+ include Aws::Structure
1228
+ end
1229
+
1230
+ # <note markdown="1"> `TagPolicyException` is deprecated. See [
1231
+ # `ValidationException` ][1]
1232
+ # instead.
1233
+ #
1234
+ # </note>
1235
+ #
1236
+ # The request doesn't comply with IAM tag policy. Correct your request
1116
1237
  # and then retry it.
1117
1238
  #
1239
+ #
1240
+ #
1241
+ # [1]: https://docs.aws.amazon.com/evs/latest/APIReference/API_ValidationException.html
1242
+ #
1118
1243
  # @!attribute [rw] message
1119
1244
  # Describes the error encountered
1120
1245
  # @return [String]
@@ -1173,7 +1298,17 @@ module Aws::Evs
1173
1298
  include Aws::Structure
1174
1299
  end
1175
1300
 
1176
- # A service resource associated with the request has more than 200 tags.
1301
+ # <note markdown="1"> `TooManyTagsException` is deprecated. See [
1302
+ # `ServiceQuotaExceededException` ][1] instead.
1303
+ #
1304
+ # </note>
1305
+ #
1306
+ # A service resource associated with the request has more than 200
1307
+ # tags.
1308
+ #
1309
+ #
1310
+ #
1311
+ # [1]: https://docs.aws.amazon.com/evs/latest/APIReference/API_ServiceQuotaExceededException.html
1177
1312
  #
1178
1313
  # @!attribute [rw] message
1179
1314
  # Describes the error encountered.
@@ -1235,7 +1370,13 @@ module Aws::Evs
1235
1370
  include Aws::Structure
1236
1371
  end
1237
1372
 
1238
- # Stores information about a field passed inside a request that resulted
1373
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1374
+ # subject to change.
1375
+ #
1376
+ # </note>
1377
+ #
1378
+ # Stores information about a field passed inside a request that
1379
+ # resulted
1239
1380
  # in an exception.
1240
1381
  #
1241
1382
  # @!attribute [rw] name
@@ -1255,12 +1396,17 @@ module Aws::Evs
1255
1396
  include Aws::Structure
1256
1397
  end
1257
1398
 
1258
- # The DNS hostnames that Amazon EVS uses to install VMware vCenter
1399
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1400
+ # subject to change.
1401
+ #
1402
+ # </note>
1403
+ #
1404
+ # The DNS hostnames that Amazon EVS uses to install VMware vCenter
1259
1405
  # Server, NSX, SDDC Manager, and Cloud Builder. Each hostname must be
1260
1406
  # unique, and resolve to a domain name that you've registered in your
1261
1407
  # DNS service of choice. Hostnames cannot be changed.
1262
1408
  #
1263
- # VMware VCF requires the deployment of two NSX Edge nodes, and three
1409
+ # VMware VCF requires the deployment of two NSX Edge nodes, and three
1264
1410
  # NSX Manager virtual machines.
1265
1411
  #
1266
1412
  # @!attribute [rw] v_center
@@ -1315,14 +1461,20 @@ module Aws::Evs
1315
1461
  include Aws::Structure
1316
1462
  end
1317
1463
 
1318
- # The VLANs that Amazon EVS creates during environment creation.
1464
+ # <note markdown="1"> Amazon EVS is in public preview release and is
1465
+ # subject to change.
1466
+ #
1467
+ # </note>
1468
+ #
1469
+ # The VLANs that Amazon EVS creates during environment creation.
1319
1470
  #
1320
1471
  # @!attribute [rw] vlan_id
1321
1472
  # The unique ID of the VLAN.
1322
1473
  # @return [Integer]
1323
1474
  #
1324
1475
  # @!attribute [rw] cidr
1325
- # The CIDR block of the VLAN.
1476
+ # The CIDR block of the VLAN. Amazon EVS VLAN subnets have a minimum
1477
+ # CIDR block size of /28 and a maximum size of /24.
1326
1478
  # @return [String]
1327
1479
  #
1328
1480
  # @!attribute [rw] availability_zone
data/lib/aws-sdk-evs.rb CHANGED
@@ -55,7 +55,7 @@ module Aws::Evs
55
55
  autoload :EndpointProvider, 'aws-sdk-evs/endpoint_provider'
56
56
  autoload :Endpoints, 'aws-sdk-evs/endpoints'
57
57
 
58
- GEM_VERSION = '1.2.0'
58
+ GEM_VERSION = '1.3.0'
59
59
 
60
60
  end
61
61
 
data/sig/errors.rbs CHANGED
@@ -16,6 +16,9 @@ module Aws
16
16
  def resource_id: () -> ::String
17
17
  def resource_type: () -> ::String
18
18
  end
19
+ class ServiceQuotaExceededException < ::Aws::Errors::ServiceError
20
+ def message: () -> ::String
21
+ end
19
22
  class TagPolicyException < ::Aws::Errors::ServiceError
20
23
  def message: () -> ::String
21
24
  end
data/sig/types.rbs CHANGED
@@ -248,6 +248,11 @@ module Aws::Evs
248
248
  SENSITIVE: []
249
249
  end
250
250
 
251
+ class ServiceQuotaExceededException
252
+ attr_accessor message: ::String
253
+ SENSITIVE: []
254
+ end
255
+
251
256
  class TagPolicyException
252
257
  attr_accessor message: ::String
253
258
  SENSITIVE: []
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-evs
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.2.0
4
+ version: 1.3.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services