aws-sdk-ec2 1.358.0 → 1.359.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fcd250980646af7ee556c47f9fe8ce1b861bd81f61d21f0dcf1b0ea0ab5134ff
-  data.tar.gz: 82c50019b406c593907d3ec4590825f1e8e8e46975f27890b6bc4888a8620d2f
+  metadata.gz: 1408b06bb5d201b36a8a0eb99234ac6c6a9b39cd54aa4dd2f21150fc61c15781
+  data.tar.gz: de1c1d4a6db3d58f9c67dde60780065731233685ea4d5df7172c497a428427ff
 SHA512:
-  metadata.gz: ff777192ab420d8938378d1be4111924dc6f781e128746de7e71af007a38ee0c8535f29b0df7be27d45c44e74cb6127459b18c4b02bd4bacdda90bda90dbec10
-  data.tar.gz: 51e12c9257b0c0760901149a97c6e27d9487ea26b293410815365e18bc3064028b097b75aaaebf25b0189d1ca2ff249a49a14725cae1cc80859ac59442195dd0
+  metadata.gz: e691748cb9c2c0cbcbf1efb0082beeb7da27155fdc4233068cf247516ef2b1894e668edaef055fec42cddefb2cf2f808df65ace8a5f0df779c2524e035972074
+  data.tar.gz: 1bfb946dc479d1608af6610ef1668af6424ccc79a42d27039795f81307972f381015fafb9b04ba4f87ca9d2a02c87a09fcdb48fa6c9b55b69b4ba04d69ebbbaf

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.359.0 (2023-01-19)
+------------------
+
+* Feature - Adds SSM Parameter Resource Aliasing support to EC2 Launch Templates. Launch Templates can now store parameter aliases in place of AMI Resource IDs. CreateLaunchTemplateVersion and DescribeLaunchTemplateVersions now support a convenience flag, ResolveAlias, to return the resolved parameter value.
+
 1.358.0 (2023-01-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.358.0
+1.359.0

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

@@ -7987,6 +7987,18 @@ module Aws::EC2
     # @option params [required, Types::RequestLaunchTemplateData] :launch_template_data
     #   The information for the launch template.
     #
+    # @option params [Boolean] :resolve_alias
+    #   If `true`, and if a Systems Manager parameter is specified for
+    #   `ImageId`, the AMI ID is displayed in the response for `imageID`. For
+    #   more information, see [Use a Systems Manager parameter instead of an
+    #   AMI ID][1] in the *Amazon Elastic Compute Cloud User Guide*.
+    #
+    #   Default: `false`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#use-an-ssm-parameter-instead-of-an-ami-id
+    #
     # @return [Types::CreateLaunchTemplateVersionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateLaunchTemplateVersionResult#launch_template_version #launch_template_version} => Types::LaunchTemplateVersion
@@ -8258,6 +8270,7 @@ module Aws::EC2
     #       },
     #       disable_api_stop: false,
     #     },
+    #     resolve_alias: false,
     #   })
     #
     # @example Response structure
@@ -24978,6 +24991,22 @@ module Aws::EC2
     #
     #   * `ram-disk-id` - The RAM disk ID.
     #
+    # @option params [Boolean] :resolve_alias
+    #   If `true`, and if a Systems Manager parameter is specified for
+    #   `ImageId`, the AMI ID is displayed in the response for `imageId`.
+    #
+    #   If `false`, and if a Systems Manager parameter is specified for
+    #   `ImageId`, the parameter is displayed in the response for `imageId`.
+    #
+    #   For more information, see [Use a Systems Manager parameter instead of
+    #   an AMI ID][1] in the *Amazon Elastic Compute Cloud User Guide*.
+    #
+    #   Default: `false`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#use-an-ssm-parameter-instead-of-an-ami-id
+    #
     # @return [Types::DescribeLaunchTemplateVersionsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DescribeLaunchTemplateVersionsResult#launch_template_versions #launch_template_versions} => Array<Types::LaunchTemplateVersion>
@@ -25064,6 +25093,7 @@ module Aws::EC2
     #         values: ["String"],
     #       },
     #     ],
+    #     resolve_alias: false,
     #   })
     #
     # @example Response structure
@@ -54776,7 +54806,7 @@ module Aws::EC2
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ec2'
-      context[:gem_version] = '1.358.0'
+      context[:gem_version] = '1.359.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -4447,6 +4447,7 @@ module Aws::EC2
     CreateLaunchTemplateVersionRequest.add_member(:source_version, Shapes::ShapeRef.new(shape: String, location_name: "SourceVersion"))
     CreateLaunchTemplateVersionRequest.add_member(:version_description, Shapes::ShapeRef.new(shape: VersionDescription, location_name: "VersionDescription"))
     CreateLaunchTemplateVersionRequest.add_member(:launch_template_data, Shapes::ShapeRef.new(shape: RequestLaunchTemplateData, required: true, location_name: "LaunchTemplateData"))
+    CreateLaunchTemplateVersionRequest.add_member(:resolve_alias, Shapes::ShapeRef.new(shape: Boolean, location_name: "ResolveAlias"))
     CreateLaunchTemplateVersionRequest.struct_class = Types::CreateLaunchTemplateVersionRequest
 
     CreateLaunchTemplateVersionResult.add_member(:launch_template_version, Shapes::ShapeRef.new(shape: LaunchTemplateVersion, location_name: "launchTemplateVersion"))
@@ -6384,6 +6385,7 @@ module Aws::EC2
     DescribeLaunchTemplateVersionsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
     DescribeLaunchTemplateVersionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: Integer, location_name: "MaxResults"))
     DescribeLaunchTemplateVersionsRequest.add_member(:filters, Shapes::ShapeRef.new(shape: FilterList, location_name: "Filter"))
+    DescribeLaunchTemplateVersionsRequest.add_member(:resolve_alias, Shapes::ShapeRef.new(shape: Boolean, location_name: "ResolveAlias"))
     DescribeLaunchTemplateVersionsRequest.struct_class = Types::DescribeLaunchTemplateVersionsRequest
 
     DescribeLaunchTemplateVersionsResult.add_member(:launch_template_versions, Shapes::ShapeRef.new(shape: LaunchTemplateVersionSet, location_name: "launchTemplateVersionSet"))

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

@@ -8177,6 +8177,19 @@ module Aws::EC2
     #   The information for the launch template.
     #   @return [Types::RequestLaunchTemplateData]
     #
+    # @!attribute [rw] resolve_alias
+    #   If `true`, and if a Systems Manager parameter is specified for
+    #   `ImageId`, the AMI ID is displayed in the response for `imageID`.
+    #   For more information, see [Use a Systems Manager parameter instead
+    #   of an AMI ID][1] in the *Amazon Elastic Compute Cloud User Guide*.
+    #
+    #   Default: `false`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#use-an-ssm-parameter-instead-of-an-ami-id
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CreateLaunchTemplateVersionRequest AWS API Documentation
     #
     class CreateLaunchTemplateVersionRequest < Struct.new(
@@ -8186,7 +8199,8 @@ module Aws::EC2
       :launch_template_name,
       :source_version,
       :version_description,
-      :launch_template_data)
+      :launch_template_data,
+      :resolve_alias)
       SENSITIVE = [:launch_template_data]
       include Aws::Structure
     end
@@ -19605,6 +19619,23 @@ module Aws::EC2
     #   * `ram-disk-id` - The RAM disk ID.
     #   @return [Array<Types::Filter>]
     #
+    # @!attribute [rw] resolve_alias
+    #   If `true`, and if a Systems Manager parameter is specified for
+    #   `ImageId`, the AMI ID is displayed in the response for `imageId`.
+    #
+    #   If `false`, and if a Systems Manager parameter is specified for
+    #   `ImageId`, the parameter is displayed in the response for `imageId`.
+    #
+    #   For more information, see [Use a Systems Manager parameter instead
+    #   of an AMI ID][1] in the *Amazon Elastic Compute Cloud User Guide*.
+    #
+    #   Default: `false`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#use-an-ssm-parameter-instead-of-an-ami-id
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeLaunchTemplateVersionsRequest AWS API Documentation
     #
     class DescribeLaunchTemplateVersionsRequest < Struct.new(
@@ -19616,7 +19647,8 @@ module Aws::EC2
       :max_version,
       :next_token,
       :max_results,
-      :filters)
+      :filters,
+      :resolve_alias)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -50414,7 +50446,25 @@ module Aws::EC2
     #   @return [Array<Types::LaunchTemplateInstanceNetworkInterfaceSpecificationRequest>]
     #
     # @!attribute [rw] image_id
-    #   The ID of the AMI.
+    #   The ID of the AMI. Alternatively, you can specify a Systems Manager
+    #   parameter, which will resolve to an AMI ID on launch.
+    #
+    #   Valid formats:
+    #
+    #   * `ami-17characters00000`
+    #
+    #   * `resolve:ssm:parameter-name`
+    #
+    #   * `resolve:ssm:parameter-name:version-number`
+    #
+    #   * `resolve:ssm:parameter-name:label`
+    #
+    #   For more information, see [Use a Systems Manager parameter instead
+    #   of an AMI ID][1] in the *Amazon Elastic Compute Cloud User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#use-an-ssm-parameter-instead-of-an-ami-id
     #   @return [String]
     #
     # @!attribute [rw] instance_type
@@ -51865,7 +51915,30 @@ module Aws::EC2
     #   @return [Array<Types::LaunchTemplateInstanceNetworkInterfaceSpecification>]
     #
     # @!attribute [rw] image_id
-    #   The ID of the AMI that was used to launch the instance.
+    #   The ID of the AMI or a Systems Manager parameter. The Systems
+    #   Manager parameter will resolve to the ID of the AMI at instance
+    #   launch.
+    #
+    #   The value depends on what you specified in the request. The possible
+    #   values are:
+    #
+    #   * If an AMI ID was specified in the request, then this is the AMI
+    #     ID.
+    #
+    #   * If a Systems Manager parameter was specified in the request, and
+    #     `ResolveAlias` was configured as `true`, then this is the AMI ID
+    #     that the parameter is mapped to in the Parameter Store.
+    #
+    #   * If a Systems Manager parameter was specified in the request, and
+    #     `ResolveAlias` was configured as `false`, then this is the
+    #     parameter value.
+    #
+    #   For more information, see [Use a Systems Manager parameter instead
+    #   of an AMI ID][1] in the *Amazon Elastic Compute Cloud User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#use-an-ssm-parameter-instead-of-an-ami-id
     #   @return [String]
     #
     # @!attribute [rw] instance_type

data/lib/aws-sdk-ec2.rb

@@ -76,6 +76,6 @@ require_relative 'aws-sdk-ec2/customizations'
 # @!group service
 module Aws::EC2
 
-  GEM_VERSION = '1.358.0'
+  GEM_VERSION = '1.359.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ec2
 version: !ruby/object:Gem::Version
-  version: 1.358.0
+  version: 1.359.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-18 00:00:00.000000000 Z
+date: 2023-01-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sigv4