Skip to content

Commit 60c47be

Browse files
author
awstools
committed
feat(client-ec2): This release changes the CreateLaunchTemplate, CreateLaunchTemplateVersion, ModifyLaunchTemplate CLI and SDKs such that if you do not specify a client token, a randomly generated token is used for the request to ensure idempotency.
1 parent a27f1b4 commit 60c47be

12 files changed

+131
-96
lines changed

‎clients/client-ec2/src/commands/AssociateInstanceEventWindowCommand.ts

+2-2
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,8 @@ export interface AssociateInstanceEventWindowCommandOutput
3030
__MetadataBearer {}
3131

3232
/**
33-
* <p>Associates one or more targets with an event window. Only one type of target (instance
34-
* IDs, Dedicated Host IDs, or tags) can be specified with an event window.</p>
33+
* <p>Associates one or more targets with an event window. Only one type of target (instance IDs,
34+
* Dedicated Host IDs, or tags) can be specified with an event window.</p>
3535
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html">Define event windows for scheduled
3636
* events</a> in the <i>Amazon EC2 User Guide</i>.</p>
3737
* @example

‎clients/client-ec2/src/commands/DeregisterInstanceEventNotificationAttributesCommand.ts

+2-2
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ export interface DeregisterInstanceEventNotificationAttributesCommandOutput
3737
__MetadataBearer {}
3838

3939
/**
40-
* <p>Deregisters tag keys to prevent tags that have the specified tag keys from being
41-
* included in scheduled event notifications for resources in the Region.</p>
40+
* <p>Deregisters tag keys to prevent tags that have the specified tag keys from being included
41+
* in scheduled event notifications for resources in the Region.</p>
4242
* @example
4343
* Use a bare-bones client and the command you need to make an API call.
4444
* ```javascript

‎clients/client-ec2/src/commands/DescribeAvailabilityZonesCommand.ts

+1-2
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,7 @@ export interface DescribeAvailabilityZonesCommandOutput extends DescribeAvailabi
2929

3030
/**
3131
* <p>Describes the Availability Zones, Local Zones, and Wavelength Zones that are available to
32-
* you. If there is an event impacting a zone, you can use this request to view the state and any
33-
* provided messages for that zone.</p>
32+
* you.</p>
3433
* <p>For more information about Availability Zones, Local Zones, and Wavelength Zones, see
3534
* <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html">Regions and zones</a>
3635
* in the <i>Amazon EC2 User Guide</i>.</p>

‎clients/client-ec2/src/commands/DescribeInstanceEventNotificationAttributesCommand.ts

+2-2
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ export interface DescribeInstanceEventNotificationAttributesCommandOutput
3737
__MetadataBearer {}
3838

3939
/**
40-
* <p>Describes the tag keys that are registered to appear in scheduled event notifications
41-
* for resources in the current Region.</p>
40+
* <p>Describes the tag keys that are registered to appear in scheduled event notifications for
41+
* resources in the current Region.</p>
4242
* @example
4343
* Use a bare-bones client and the command you need to make an API call.
4444
* ```javascript

‎clients/client-ec2/src/commands/RegisterInstanceEventNotificationAttributesCommand.ts

+2-3
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,8 @@ export interface RegisterInstanceEventNotificationAttributesCommandOutput
3737
__MetadataBearer {}
3838

3939
/**
40-
* <p>Registers a set of tag keys to include in scheduled event notifications for your
41-
* resources.
42-
* </p>
40+
* <p>Registers a set of tag keys to include in scheduled event notifications for your resources.
41+
* </p>
4342
* <p>To remove tags, use <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeregisterInstanceEventNotificationAttributes.html">DeregisterInstanceEventNotificationAttributes</a>.</p>
4443
* @example
4544
* Use a bare-bones client and the command you need to make an API call.

‎clients/client-ec2/src/models/models_0.ts

+2-5
Original file line numberDiff line numberDiff line change
@@ -4625,11 +4625,8 @@ export interface InstanceEventWindowAssociationTarget {
46254625
InstanceIds?: string[] | undefined;
46264626

46274627
/**
4628-
* <p>The instance tags associated with the event window. Any instances associated with the
4629-
* tags will be associated with the event window.</p>
4630-
* <p>Note that while you can't create tag keys beginning with <code>aws:</code>, you can
4631-
* specify existing Amazon Web Services managed tag keys (with the <code>aws:</code> prefix) when specifying
4632-
* them as targets to associate with the event window.</p>
4628+
* <p>The instance tags associated with the event window. Any instances associated with the tags
4629+
* will be associated with the event window.</p>
46334630
* @public
46344631
*/
46354632
Tags?: Tag[] | undefined;

‎clients/client-ec2/src/models/models_1.ts

+41-11
Original file line numberDiff line numberDiff line change
@@ -3831,7 +3831,8 @@ export interface FleetEbsBlockDeviceRequest {
38313831
* <p>Identifier (key ID, key alias, key ARN, or alias ARN) of the customer managed KMS key
38323832
* to use for EBS encryption.</p>
38333833
* <p>This parameter is only supported on <code>BlockDeviceMapping</code> objects called by
3834-
* <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet.html">CreateFleet</a>, <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotInstances.html">RequestSpotInstances</a>, and <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html">RunInstances</a>.</p>
3834+
* <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html">RunInstances</a>, <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotFleet.html">RequestSpotFleet</a>,
3835+
* and <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotInstances.html">RequestSpotInstances</a>.</p>
38353836
* @public
38363837
*/
38373838
KmsKeyId?: string | undefined;
@@ -4909,6 +4910,30 @@ export interface FleetLaunchTemplateOverridesRequest {
49094910
* attach to the instance at launch. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html">Block device mappings
49104911
* for volumes on Amazon EC2 instances</a> in the <i>Amazon EC2 User
49114912
* Guide</i>.</p>
4913+
* <p>To override a block device mapping specified in the launch template:</p>
4914+
* <ul>
4915+
* <li>
4916+
* <p>Specify the exact same <code>DeviceName</code> here as specified in the launch
4917+
* template.</p>
4918+
* </li>
4919+
* <li>
4920+
* <p>Only specify the parameters you want to change.</p>
4921+
* </li>
4922+
* <li>
4923+
* <p>Any parameters you don't specify here will keep their original launch template
4924+
* values.</p>
4925+
* </li>
4926+
* </ul>
4927+
* <p>To add a new block device mapping:</p>
4928+
* <ul>
4929+
* <li>
4930+
* <p>Specify a <code>DeviceName</code> that doesn't exist in the launch
4931+
* template.</p>
4932+
* </li>
4933+
* <li>
4934+
* <p>Specify all desired parameters here.</p>
4935+
* </li>
4936+
* </ul>
49124937
* @public
49134938
*/
49144939
BlockDeviceMappings?: FleetBlockDeviceMappingRequest[] | undefined;
@@ -6276,6 +6301,9 @@ export interface InstanceRequirements {
62766301
* <li>
62776302
* <p>For instance types with Inference accelerators, specify <code>inference</code>.</p>
62786303
* </li>
6304+
* <li>
6305+
* <p>For instance types with Inference accelerators, specify <code>inference</code>.</p>
6306+
* </li>
62796307
* </ul>
62806308
* <p>Default: Any accelerator type</p>
62816309
* @public
@@ -7650,15 +7678,15 @@ export interface CreateInstanceEventWindowRequest {
76507678
Name?: string | undefined;
76517679

76527680
/**
7653-
* <p>The time range for the event window. If you specify a time range, you can't specify a
7654-
* cron expression.</p>
7681+
* <p>The time range for the event window. If you specify a time range, you can't specify a cron
7682+
* expression.</p>
76557683
* @public
76567684
*/
76577685
TimeRanges?: InstanceEventWindowTimeRangeRequest[] | undefined;
76587686

76597687
/**
7660-
* <p>The cron expression for the event window, for example, <code>* 0-4,20-23 * * 1,5</code>.
7661-
* If you specify a cron expression, you can't specify a time range.</p>
7688+
* <p>The cron expression for the event window, for example, <code>* 0-4,20-23 * * 1,5</code>. If
7689+
* you specify a cron expression, you can't specify a time range.</p>
76627690
* <p>Constraints:</p>
76637691
* <ul>
76647692
* <li>
@@ -7674,11 +7702,11 @@ export interface CreateInstanceEventWindowRequest {
76747702
* </li>
76757703
* <li>
76767704
* <p>The hour value must be one or a multiple range, for example, <code>0-4</code> or
7677-
* <code>0-4,20-23</code>.</p>
7705+
* <code>0-4,20-23</code>.</p>
76787706
* </li>
76797707
* <li>
76807708
* <p>Each hour range must be >= 2 hours, for example, <code>0-2</code> or
7681-
* <code>20-23</code>.</p>
7709+
* <code>20-23</code>.</p>
76827710
* </li>
76837711
* <li>
76847712
* <p>The event window must be >= 4 hours. The combined total time ranges in the event
@@ -10880,7 +10908,8 @@ export interface CreateLaunchTemplateRequest {
1088010908

1088110909
/**
1088210910
* <p>Unique, case-sensitive identifier you provide to ensure the idempotency of the
10883-
* request. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring
10911+
* request. If a client token isn't specified, a randomly generated token is used in the request to ensure idempotency.</p>
10912+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring
1088410913
* idempotency</a>.</p>
1088510914
* <p>Constraint: Maximum 128 ASCII characters.</p>
1088610915
* @public
@@ -10922,13 +10951,13 @@ export interface CreateLaunchTemplateRequest {
1092210951
}
1092310952

1092410953
/**
10925-
* <p>Describes whether the resource is managed by a service provider and, if so, describes
10954+
* <p>Describes whether the resource is managed by an service provider and, if so, describes
1092610955
* the service provider that manages it.</p>
1092710956
* @public
1092810957
*/
1092910958
export interface OperatorResponse {
1093010959
/**
10931-
* <p>If <code>true</code>, the resource is managed by a service provider.</p>
10960+
* <p>If <code>true</code>, the resource is managed by an service provider.</p>
1093210961
* @public
1093310962
*/
1093410963
Managed?: boolean | undefined;
@@ -11065,7 +11094,8 @@ export interface CreateLaunchTemplateVersionRequest {
1106511094

1106611095
/**
1106711096
* <p>Unique, case-sensitive identifier you provide to ensure the idempotency of the
11068-
* request. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring
11097+
* request. If a client token isn't specified, a randomly generated token is used in the request to ensure idempotency.</p>
11098+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring
1106911099
* idempotency</a>.</p>
1107011100
* <p>Constraint: Maximum 128 ASCII characters.</p>
1107111101
* @public

‎clients/client-ec2/src/models/models_3.ts

+16-16
Original file line numberDiff line numberDiff line change
@@ -848,8 +848,8 @@ export interface DeleteInstanceEventWindowRequest {
848848
DryRun?: boolean | undefined;
849849

850850
/**
851-
* <p>Specify <code>true</code> to force delete the event window. Use the force delete
852-
* parameter if the event window is currently associated with targets.</p>
851+
* <p>Specify <code>true</code> to force delete the event window. Use the force delete parameter
852+
* if the event window is currently associated with targets.</p>
853853
* @public
854854
*/
855855
ForceDelete?: boolean | undefined;
@@ -3293,16 +3293,15 @@ export interface DeregisterImageRequest {
32933293
export interface DeregisterImageResult {}
32943294

32953295
/**
3296-
* <p>Information about the tag keys to deregister for the current Region. You can either
3297-
* specify individual tag keys or deregister all tag keys in the current Region. You must
3298-
* specify either <code>IncludeAllTagsOfInstance</code> or <code>InstanceTagKeys</code> in the
3299-
* request</p>
3296+
* <p>Information about the tag keys to deregister for the current Region. You can either specify
3297+
* individual tag keys or deregister all tag keys in the current Region. You must specify either
3298+
* <code>IncludeAllTagsOfInstance</code> or <code>InstanceTagKeys</code> in the request</p>
33003299
* @public
33013300
*/
33023301
export interface DeregisterInstanceTagAttributeRequest {
33033302
/**
3304-
* <p>Indicates whether to deregister all tag keys in the current Region. Specify
3305-
* <code>false</code> to deregister all tag keys.</p>
3303+
* <p>Indicates whether to deregister all tag keys in the current Region. Specify <code>false</code>
3304+
* to deregister all tag keys.</p>
33063305
* @public
33073306
*/
33083307
IncludeAllTagsOfInstance?: boolean | undefined;
@@ -3345,9 +3344,8 @@ export interface InstanceTagNotificationAttribute {
33453344
InstanceTagKeys?: string[] | undefined;
33463345

33473346
/**
3348-
* <p>Indicates wheter all tag keys in the current Region are registered to appear in
3349-
* scheduled event notifications. <code>true</code> indicates that all tag keys in the current
3350-
* Region are registered.</p>
3347+
* <p>Indicates wheter all tag keys in the current Region are registered to appear in scheduled event notifications.
3348+
* <code>true</code> indicates that all tag keys in the current Region are registered.</p>
33513349
* @public
33523350
*/
33533351
IncludeAllTagsOfInstance?: boolean | undefined;
@@ -3948,7 +3946,7 @@ export interface AvailabilityZone {
39483946
* <p>For Availability Zones, this parameter always has the value of
39493947
* <code>opt-in-not-required</code>.</p>
39503948
* <p>For Local Zones and Wavelength Zones, this parameter is the opt-in status. The possible
3951-
* values are <code>opted-in</code>, and <code>not-opted-in</code>.</p>
3949+
* values are <code>opted-in</code> and <code>not-opted-in</code>.</p>
39523950
* @public
39533951
*/
39543952
OptInStatus?: AvailabilityZoneOptInStatus | undefined;
@@ -4004,8 +4002,10 @@ export interface AvailabilityZone {
40044002
NetworkBorderGroup?: string | undefined;
40054003

40064004
/**
4007-
* <p>The type of zone. The valid values are <code>availability-zone</code>,
4008-
* <code>local-zone</code>, and <code>wavelength-zone</code>.</p>
4005+
* <p>The type of zone.</p>
4006+
* <p>Valid values: <code>availability-zone</code> | <code>local-zone</code> |
4007+
* <code>wavelength-zone</code>
4008+
* </p>
40094009
* @public
40104010
*/
40114011
ZoneType?: string | undefined;
@@ -4032,8 +4032,8 @@ export interface AvailabilityZone {
40324032
GroupLongName?: string | undefined;
40334033

40344034
/**
4035-
* <p>The state of the Availability Zone, Local Zone, or Wavelength Zone. This value is always
4036-
* <code>available</code>.</p>
4035+
* <p>The state of the Availability Zone, Local Zone, or Wavelength Zone. The possible values are
4036+
* <code>available</code>, <code>unavailable</code>, and <code>constrained</code>.</p>
40374037
* @public
40384038
*/
40394039
State?: AvailabilityZoneState | undefined;

‎clients/client-ec2/src/models/models_4.ts

+14-15
Original file line numberDiff line numberDiff line change
@@ -4691,32 +4691,32 @@ export interface DescribeInstanceEventWindowsRequest {
46914691
* <li>
46924692
* <p>
46934693
* <code>dedicated-host-id</code> - The event windows associated with the specified
4694-
* Dedicated Host ID.</p>
4694+
* Dedicated Host ID.</p>
46954695
* </li>
46964696
* <li>
46974697
* <p>
46984698
* <code>event-window-name</code> - The event windows associated with the specified
4699-
* names. </p>
4699+
* names. </p>
47004700
* </li>
47014701
* <li>
47024702
* <p>
4703-
* <code>instance-id</code> - The event windows associated with the specified
4704-
* instance ID.</p>
4703+
* <code>instance-id</code> - The event windows associated with the specified instance
4704+
* ID.</p>
47054705
* </li>
47064706
* <li>
47074707
* <p>
4708-
* <code>instance-tag</code> - The event windows associated with the specified tag
4709-
* and value.</p>
4708+
* <code>instance-tag</code> - The event windows associated with the specified tag and
4709+
* value.</p>
47104710
* </li>
47114711
* <li>
47124712
* <p>
4713-
* <code>instance-tag-key</code> - The event windows associated with the specified
4714-
* tag key, regardless of the value.</p>
4713+
* <code>instance-tag-key</code> - The event windows associated with the specified tag
4714+
* key, regardless of the value.</p>
47154715
* </li>
47164716
* <li>
47174717
* <p>
4718-
* <code>instance-tag-value</code> - The event windows associated with the specified
4719-
* tag value, regardless of the key.</p>
4718+
* <code>instance-tag-value</code> - The event windows associated with the specified tag
4719+
* value, regardless of the key.</p>
47204720
* </li>
47214721
* <li>
47224722
* <p>
@@ -4728,9 +4728,9 @@ export interface DescribeInstanceEventWindowsRequest {
47284728
* </li>
47294729
* <li>
47304730
* <p>
4731-
* <code>tag-key</code> - The key of a tag assigned to the event window. Use this
4732-
* filter to find all event windows that have a tag with a specific key, regardless of
4733-
* the tag value. </p>
4731+
* <code>tag-key</code> - The key of a tag assigned to the event window. Use this filter
4732+
* to find all event windows that have a tag with a specific key, regardless of the tag
4733+
* value. </p>
47344734
* </li>
47354735
* <li>
47364736
* <p>
@@ -4770,8 +4770,7 @@ export interface DescribeInstanceEventWindowsResult {
47704770
InstanceEventWindows?: InstanceEventWindow[] | undefined;
47714771

47724772
/**
4773-
* <p>The token to use to retrieve the next page of results. This value is <code>null</code>
4774-
* when there are no more results to return. </p>
4773+
* <p>The token to use to retrieve the next page of results. This value is <code>null</code> when there are no more results to return. </p>
47754774
* @public
47764775
*/
47774776
NextToken?: string | undefined;

‎clients/client-ec2/src/models/models_7.ts

+9-10
Original file line numberDiff line numberDiff line change
@@ -436,8 +436,7 @@ export interface ModifyInstanceEventWindowRequest {
436436
TimeRanges?: InstanceEventWindowTimeRangeRequest[] | undefined;
437437

438438
/**
439-
* <p>The cron expression of the event window, for example, <code>* 0-4,20-23 * *
440-
* 1,5</code>.</p>
439+
* <p>The cron expression of the event window, for example, <code>* 0-4,20-23 * * 1,5</code>.</p>
441440
* <p>Constraints:</p>
442441
* <ul>
443442
* <li>
@@ -1291,8 +1290,9 @@ export interface ModifyLaunchTemplateRequest {
12911290

12921291
/**
12931292
* <p>Unique, case-sensitive identifier you provide to ensure the idempotency of the
1294-
* request. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency
1295-
* in Amazon EC2 API requests</a>.</p>
1293+
* request. If a client token isn't specified, a randomly generated token is used in the request to ensure idempotency.</p>
1294+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring
1295+
* idempotency</a>.</p>
12961296
* <p>Constraint: Maximum 128 ASCII characters.</p>
12971297
* @public
12981298
*/
@@ -5527,16 +5527,15 @@ export interface RegisterImageResult {
55275527
}
55285528

55295529
/**
5530-
* <p>Information about the tag keys to register for the current Region. You can either
5531-
* specify individual tag keys or register all tag keys in the current Region. You must
5532-
* specify either <code>IncludeAllTagsOfInstance</code> or <code>InstanceTagKeys</code> in the
5533-
* request</p>
5530+
* <p>Information about the tag keys to register for the current Region. You can either specify
5531+
* individual tag keys or register all tag keys in the current Region. You must specify either
5532+
* <code>IncludeAllTagsOfInstance</code> or <code>InstanceTagKeys</code> in the request</p>
55345533
* @public
55355534
*/
55365535
export interface RegisterInstanceTagAttributeRequest {
55375536
/**
5538-
* <p>Indicates whether to register all tag keys in the current Region. Specify
5539-
* <code>true</code> to register all tag keys.</p>
5537+
* <p>Indicates whether to register all tag keys in the current Region. Specify <code>true</code>
5538+
* to register all tag keys.</p>
55405539
* @public
55415540
*/
55425541
IncludeAllTagsOfInstance?: boolean | undefined;

0 commit comments

Comments
 (0)