aws-sdk-imagebuilder 1.22.0 → 1.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efce08172d9f3fc257e9ce4eed1dbcc7fe446a45cc36c46e562de2d7fa550e86
-  data.tar.gz: 533271bb23f6e9a762001540ccd3fffb9ad9ce21446f53eb0bd3af2bfcefd1f5
+  metadata.gz: 0f3246e9cbf383e5e4967da7e3787f89770702edf1e2b8ec83504b69c4e2eb79
+  data.tar.gz: 01ebaf48caebf957cac81609478c5f5b0fc1e95ebdccac76f629544ffc341e18
 SHA512:
-  metadata.gz: cd1ca976f638258402781aad39554a3c76914a21ab791c0e024d57da3ed19234c65579d6c71d24666193ed1f19ff24ecc474671a8029e1d7ac7551b585a46752
-  data.tar.gz: ee4215723ee7922651bb0ab730b1e1059f127d9f937bb9b8791297add7e4fb70972a33c94b7f880ee3e15f79984930bf9062430c94496d66c8bd23af728796bd
+  metadata.gz: 60f9b127424172a39f6a0dac5a4f632942f99a4d7f112acb32b5508f6b88a522bb59cca775887c7aa2c943eede0c8db6b14bf79fd5443d2d95d41653fc971776
+  data.tar.gz: 860cb23e374e80078f89425fbe3a8491964db5255d1401f7368f2316894eaea4607d2d088a4fffa1418ed69612301c19d00edea174636c36ff5642502df96dfa

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.23.0 (2021-07-06)
+------------------
+
+* Feature - Adds support for specifying parameters to customize components for recipes. Expands configuration of the Amazon EC2 instances that are used for building and testing images, including the ability to specify commands to run on launch, and more control over installation and removal of the SSM agent.
+
 1.22.0 (2021-05-14)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.22.0
+1.23.0

data/lib/aws-sdk-imagebuilder.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-imagebuilder/customizations'
 # @!group service
 module Aws::Imagebuilder
 
-  GEM_VERSION = '1.22.0'
+  GEM_VERSION = '1.23.0'
 
 end

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

@@ -401,10 +401,10 @@ module Aws::Imagebuilder
     #   `data` or `uri` can be used to specify the data within the component.
     #
     # @option params [String] :uri
-    #   The uri of the component. Must be an S3 URL and the requester must
-    #   have permission to access the S3 bucket. If you use S3, you can
-    #   specify component content up to your service quota. Either `data` or
-    #   `uri` can be used to specify the data within the component.
+    #   The uri of the component. Must be an Amazon S3 URL and the requester
+    #   must have permission to access the Amazon S3 bucket. If you use Amazon
+    #   S3, you can specify component content up to your service quota. Either
+    #   `data` or `uri` can be used to specify the data within the component.
     #
     # @option params [String] :kms_key_id
     #   The ID of the KMS key that should be used to encrypt this component.
@@ -486,7 +486,7 @@ module Aws::Imagebuilder
     #   blob.
     #
     # @option params [String] :dockerfile_template_uri
-    #   The S3 URI for the Dockerfile that will be used to build your
+    #   The Amazon S3 URI for the Dockerfile that will be used to build your
     #   container image.
     #
     # @option params [String] :platform_override
@@ -533,6 +533,12 @@ module Aws::Imagebuilder
     #     components: [ # required
     #       {
     #         component_arn: "ComponentVersionArnOrBuildVersionArn", # required
+    #         parameters: [
+    #           {
+    #             name: "ComponentParameterName", # required
+    #             value: ["ComponentParameterValue"], # required
+    #           },
+    #         ],
     #       },
     #     ],
     #     instance_configuration: {
@@ -881,7 +887,11 @@ module Aws::Imagebuilder
     #   The tags of the image recipe.
     #
     # @option params [String] :working_directory
-    #   The working directory to be used during build and test workflows.
+    #   The working directory used during build and test workflows.
+    #
+    # @option params [Types::AdditionalInstanceConfiguration] :additional_instance_configuration
+    #   Specify additional settings and launch scripts for your build
+    #   instances.
     #
     # @option params [required, String] :client_token
     #   The idempotency token used to make this request idempotent.
@@ -904,6 +914,12 @@ module Aws::Imagebuilder
     #     components: [ # required
     #       {
     #         component_arn: "ComponentVersionArnOrBuildVersionArn", # required
+    #         parameters: [
+    #           {
+    #             name: "ComponentParameterName", # required
+    #             value: ["ComponentParameterValue"], # required
+    #           },
+    #         ],
     #       },
     #     ],
     #     parent_image: "NonEmptyString", # required
@@ -927,6 +943,12 @@ module Aws::Imagebuilder
     #       "TagKey" => "TagValue",
     #     },
     #     working_directory: "NonEmptyString",
+    #     additional_instance_configuration: {
+    #       systems_manager_agent: {
+    #         uninstall_after_build: false,
+    #       },
+    #       user_data_override: "UserDataOverride",
+    #     },
     #     client_token: "ClientToken", # required
     #   })
     #
@@ -962,15 +984,15 @@ module Aws::Imagebuilder
     #
     # @option params [required, String] :instance_profile_name
     #   The instance profile to associate with the instance used to customize
-    #   your EC2 AMI.
+    #   your Amazon EC2 AMI.
     #
     # @option params [Array<String>] :security_group_ids
     #   The security group IDs to associate with the instance used to
-    #   customize your EC2 AMI.
+    #   customize your Amazon EC2 AMI.
     #
     # @option params [String] :subnet_id
     #   The subnet ID in which to place the instance used to customize your
-    #   EC2 AMI.
+    #   Amazon EC2 AMI.
     #
     # @option params [Types::Logging] :logging
     #   The logging configuration of the infrastructure configuration.
@@ -1290,6 +1312,12 @@ module Aws::Imagebuilder
     #   resp.component.platform #=> String, one of "Windows", "Linux"
     #   resp.component.supported_os_versions #=> Array
     #   resp.component.supported_os_versions[0] #=> String
+    #   resp.component.parameters #=> Array
+    #   resp.component.parameters[0].name #=> String
+    #   resp.component.parameters[0].type #=> String
+    #   resp.component.parameters[0].default_value #=> Array
+    #   resp.component.parameters[0].default_value[0] #=> String
+    #   resp.component.parameters[0].description #=> String
     #   resp.component.owner #=> String
     #   resp.component.data #=> String
     #   resp.component.kms_key_id #=> String
@@ -1366,6 +1394,10 @@ module Aws::Imagebuilder
     #   resp.container_recipe.version #=> String
     #   resp.container_recipe.components #=> Array
     #   resp.container_recipe.components[0].component_arn #=> String
+    #   resp.container_recipe.components[0].parameters #=> Array
+    #   resp.container_recipe.components[0].parameters[0].name #=> String
+    #   resp.container_recipe.components[0].parameters[0].value #=> Array
+    #   resp.container_recipe.components[0].parameters[0].value[0] #=> String
     #   resp.container_recipe.instance_configuration.image #=> String
     #   resp.container_recipe.instance_configuration.block_device_mappings #=> Array
     #   resp.container_recipe.instance_configuration.block_device_mappings[0].device_name #=> String
@@ -1528,6 +1560,10 @@ module Aws::Imagebuilder
     #   resp.image.image_recipe.version #=> String
     #   resp.image.image_recipe.components #=> Array
     #   resp.image.image_recipe.components[0].component_arn #=> String
+    #   resp.image.image_recipe.components[0].parameters #=> Array
+    #   resp.image.image_recipe.components[0].parameters[0].name #=> String
+    #   resp.image.image_recipe.components[0].parameters[0].value #=> Array
+    #   resp.image.image_recipe.components[0].parameters[0].value[0] #=> String
     #   resp.image.image_recipe.parent_image #=> String
     #   resp.image.image_recipe.block_device_mappings #=> Array
     #   resp.image.image_recipe.block_device_mappings[0].device_name #=> String
@@ -1544,6 +1580,8 @@ module Aws::Imagebuilder
     #   resp.image.image_recipe.tags #=> Hash
     #   resp.image.image_recipe.tags["TagKey"] #=> String
     #   resp.image.image_recipe.working_directory #=> String
+    #   resp.image.image_recipe.additional_instance_configuration.systems_manager_agent.uninstall_after_build #=> Boolean
+    #   resp.image.image_recipe.additional_instance_configuration.user_data_override #=> String
     #   resp.image.container_recipe.arn #=> String
     #   resp.image.container_recipe.container_type #=> String, one of "DOCKER"
     #   resp.image.container_recipe.name #=> String
@@ -1553,6 +1591,10 @@ module Aws::Imagebuilder
     #   resp.image.container_recipe.version #=> String
     #   resp.image.container_recipe.components #=> Array
     #   resp.image.container_recipe.components[0].component_arn #=> String
+    #   resp.image.container_recipe.components[0].parameters #=> Array
+    #   resp.image.container_recipe.components[0].parameters[0].name #=> String
+    #   resp.image.container_recipe.components[0].parameters[0].value #=> Array
+    #   resp.image.container_recipe.components[0].parameters[0].value[0] #=> String
     #   resp.image.container_recipe.instance_configuration.image #=> String
     #   resp.image.container_recipe.instance_configuration.block_device_mappings #=> Array
     #   resp.image.container_recipe.instance_configuration.block_device_mappings[0].device_name #=> String
@@ -1767,6 +1809,10 @@ module Aws::Imagebuilder
     #   resp.image_recipe.version #=> String
     #   resp.image_recipe.components #=> Array
     #   resp.image_recipe.components[0].component_arn #=> String
+    #   resp.image_recipe.components[0].parameters #=> Array
+    #   resp.image_recipe.components[0].parameters[0].name #=> String
+    #   resp.image_recipe.components[0].parameters[0].value #=> Array
+    #   resp.image_recipe.components[0].parameters[0].value[0] #=> String
     #   resp.image_recipe.parent_image #=> String
     #   resp.image_recipe.block_device_mappings #=> Array
     #   resp.image_recipe.block_device_mappings[0].device_name #=> String
@@ -1783,6 +1829,8 @@ module Aws::Imagebuilder
     #   resp.image_recipe.tags #=> Hash
     #   resp.image_recipe.tags["TagKey"] #=> String
     #   resp.image_recipe.working_directory #=> String
+    #   resp.image_recipe.additional_instance_configuration.systems_manager_agent.uninstall_after_build #=> Boolean
+    #   resp.image_recipe.additional_instance_configuration.user_data_override #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/GetImageRecipe AWS API Documentation
     #
@@ -1908,10 +1956,10 @@ module Aws::Imagebuilder
     #   `data` or `uri` can be used to specify the data within the component.
     #
     # @option params [String] :uri
-    #   The uri of the component. Must be an S3 URL and the requester must
-    #   have permission to access the S3 bucket. If you use S3, you can
-    #   specify component content up to your service quota. Either `data` or
-    #   `uri` can be used to specify the data within the component.
+    #   The uri of the component. Must be an Amazon S3 URL and the requester
+    #   must have permission to access the Amazon S3 bucket. If you use Amazon
+    #   S3, you can specify component content up to your service quota. Either
+    #   `data` or `uri` can be used to specify the data within the component.
     #
     # @option params [String] :kms_key_id
     #   The ID of the KMS key that should be used to encrypt this component.
@@ -2299,7 +2347,7 @@ module Aws::Imagebuilder
     end
 
     # List the Packages that are associated with an Image Build Version, as
-    # determined by AWS Systems Manager Inventory at build time.
+    # determined by Amazon EC2 Systems Manager Inventory at build time.
     #
     # @option params [required, String] :image_build_version_arn
     #   Filter results for the ListImagePackages request by the Image Build
@@ -3185,14 +3233,15 @@ module Aws::Imagebuilder
     #
     # @option params [required, String] :instance_profile_name
     #   The instance profile to associate with the instance used to customize
-    #   your EC2 AMI.
+    #   your Amazon EC2 AMI.
     #
     # @option params [Array<String>] :security_group_ids
     #   The security group IDs to associate with the instance used to
-    #   customize your EC2 AMI.
+    #   customize your Amazon EC2 AMI.
     #
     # @option params [String] :subnet_id
-    #   The subnet ID to place the instance used to customize your EC2 AMI in.
+    #   The subnet ID to place the instance used to customize your Amazon EC2
+    #   AMI in.
     #
     # @option params [Types::Logging] :logging
     #   The logging configuration of the infrastructure configuration.
@@ -3277,7 +3326,7 @@ module Aws::Imagebuilder
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-imagebuilder'
-      context[:gem_version] = '1.22.0'
+      context[:gem_version] = '1.23.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -15,6 +15,7 @@ module Aws::Imagebuilder
 
     AccountId = Shapes::StringShape.new(name: 'AccountId')
     AccountList = Shapes::ListShape.new(name: 'AccountList')
+    AdditionalInstanceConfiguration = Shapes::StructureShape.new(name: 'AdditionalInstanceConfiguration')
     Ami = Shapes::StructureShape.new(name: 'Ami')
     AmiDistributionConfiguration = Shapes::StructureShape.new(name: 'AmiDistributionConfiguration')
     AmiList = Shapes::ListShape.new(name: 'AmiList')
@@ -32,6 +33,15 @@ module Aws::Imagebuilder
     ComponentConfigurationList = Shapes::ListShape.new(name: 'ComponentConfigurationList')
     ComponentData = Shapes::StringShape.new(name: 'ComponentData')
     ComponentFormat = Shapes::StringShape.new(name: 'ComponentFormat')
+    ComponentParameter = Shapes::StructureShape.new(name: 'ComponentParameter')
+    ComponentParameterDescription = Shapes::StringShape.new(name: 'ComponentParameterDescription')
+    ComponentParameterDetail = Shapes::StructureShape.new(name: 'ComponentParameterDetail')
+    ComponentParameterDetailList = Shapes::ListShape.new(name: 'ComponentParameterDetailList')
+    ComponentParameterList = Shapes::ListShape.new(name: 'ComponentParameterList')
+    ComponentParameterName = Shapes::StringShape.new(name: 'ComponentParameterName')
+    ComponentParameterType = Shapes::StringShape.new(name: 'ComponentParameterType')
+    ComponentParameterValue = Shapes::StringShape.new(name: 'ComponentParameterValue')
+    ComponentParameterValueList = Shapes::ListShape.new(name: 'ComponentParameterValueList')
     ComponentSummary = Shapes::StructureShape.new(name: 'ComponentSummary')
     ComponentSummaryList = Shapes::ListShape.new(name: 'ComponentSummaryList')
     ComponentType = Shapes::StringShape.new(name: 'ComponentType')
@@ -231,6 +241,7 @@ module Aws::Imagebuilder
     StartImagePipelineExecutionRequest = Shapes::StructureShape.new(name: 'StartImagePipelineExecutionRequest')
     StartImagePipelineExecutionResponse = Shapes::StructureShape.new(name: 'StartImagePipelineExecutionResponse')
     StringList = Shapes::ListShape.new(name: 'StringList')
+    SystemsManagerAgent = Shapes::StructureShape.new(name: 'SystemsManagerAgent')
     TagKey = Shapes::StringShape.new(name: 'TagKey')
     TagKeyList = Shapes::ListShape.new(name: 'TagKeyList')
     TagMap = Shapes::MapShape.new(name: 'TagMap')
@@ -248,10 +259,15 @@ module Aws::Imagebuilder
     UpdateInfrastructureConfigurationRequest = Shapes::StructureShape.new(name: 'UpdateInfrastructureConfigurationRequest')
     UpdateInfrastructureConfigurationResponse = Shapes::StructureShape.new(name: 'UpdateInfrastructureConfigurationResponse')
     Uri = Shapes::StringShape.new(name: 'Uri')
+    UserDataOverride = Shapes::StringShape.new(name: 'UserDataOverride')
     VersionNumber = Shapes::StringShape.new(name: 'VersionNumber')
 
     AccountList.member = Shapes::ShapeRef.new(shape: AccountId)
 
+    AdditionalInstanceConfiguration.add_member(:systems_manager_agent, Shapes::ShapeRef.new(shape: SystemsManagerAgent, location_name: "systemsManagerAgent"))
+    AdditionalInstanceConfiguration.add_member(:user_data_override, Shapes::ShapeRef.new(shape: UserDataOverride, location_name: "userDataOverride"))
+    AdditionalInstanceConfiguration.struct_class = Types::AdditionalInstanceConfiguration
+
     Ami.add_member(:region, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "region"))
     Ami.add_member(:image, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "image"))
     Ami.add_member(:name, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "name"))
@@ -293,6 +309,7 @@ module Aws::Imagebuilder
     Component.add_member(:type, Shapes::ShapeRef.new(shape: ComponentType, location_name: "type"))
     Component.add_member(:platform, Shapes::ShapeRef.new(shape: Platform, location_name: "platform"))
     Component.add_member(:supported_os_versions, Shapes::ShapeRef.new(shape: OsVersionList, location_name: "supportedOsVersions"))
+    Component.add_member(:parameters, Shapes::ShapeRef.new(shape: ComponentParameterDetailList, location_name: "parameters"))
     Component.add_member(:owner, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "owner"))
     Component.add_member(:data, Shapes::ShapeRef.new(shape: ComponentData, location_name: "data"))
     Component.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "kmsKeyId"))
@@ -302,10 +319,27 @@ module Aws::Imagebuilder
     Component.struct_class = Types::Component
 
     ComponentConfiguration.add_member(:component_arn, Shapes::ShapeRef.new(shape: ComponentVersionArnOrBuildVersionArn, required: true, location_name: "componentArn"))
+    ComponentConfiguration.add_member(:parameters, Shapes::ShapeRef.new(shape: ComponentParameterList, location_name: "parameters"))
     ComponentConfiguration.struct_class = Types::ComponentConfiguration
 
     ComponentConfigurationList.member = Shapes::ShapeRef.new(shape: ComponentConfiguration)
 
+    ComponentParameter.add_member(:name, Shapes::ShapeRef.new(shape: ComponentParameterName, required: true, location_name: "name"))
+    ComponentParameter.add_member(:value, Shapes::ShapeRef.new(shape: ComponentParameterValueList, required: true, location_name: "value"))
+    ComponentParameter.struct_class = Types::ComponentParameter
+
+    ComponentParameterDetail.add_member(:name, Shapes::ShapeRef.new(shape: ComponentParameterName, required: true, location_name: "name"))
+    ComponentParameterDetail.add_member(:type, Shapes::ShapeRef.new(shape: ComponentParameterType, required: true, location_name: "type"))
+    ComponentParameterDetail.add_member(:default_value, Shapes::ShapeRef.new(shape: ComponentParameterValueList, location_name: "defaultValue"))
+    ComponentParameterDetail.add_member(:description, Shapes::ShapeRef.new(shape: ComponentParameterDescription, location_name: "description"))
+    ComponentParameterDetail.struct_class = Types::ComponentParameterDetail
+
+    ComponentParameterDetailList.member = Shapes::ShapeRef.new(shape: ComponentParameterDetail)
+
+    ComponentParameterList.member = Shapes::ShapeRef.new(shape: ComponentParameter)
+
+    ComponentParameterValueList.member = Shapes::ShapeRef.new(shape: ComponentParameterValue)
+
     ComponentSummary.add_member(:arn, Shapes::ShapeRef.new(shape: ImageBuilderArn, location_name: "arn"))
     ComponentSummary.add_member(:name, Shapes::ShapeRef.new(shape: ResourceName, location_name: "name"))
     ComponentSummary.add_member(:version, Shapes::ShapeRef.new(shape: VersionNumber, location_name: "version"))
@@ -456,6 +490,7 @@ module Aws::Imagebuilder
     CreateImageRecipeRequest.add_member(:block_device_mappings, Shapes::ShapeRef.new(shape: InstanceBlockDeviceMappings, location_name: "blockDeviceMappings"))
     CreateImageRecipeRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
     CreateImageRecipeRequest.add_member(:working_directory, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "workingDirectory"))
+    CreateImageRecipeRequest.add_member(:additional_instance_configuration, Shapes::ShapeRef.new(shape: AdditionalInstanceConfiguration, location_name: "additionalInstanceConfiguration"))
     CreateImageRecipeRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, required: true, location_name: "clientToken", metadata: {"idempotencyToken"=>true}))
     CreateImageRecipeRequest.struct_class = Types::CreateImageRecipeRequest
 
@@ -738,6 +773,7 @@ module Aws::Imagebuilder
     ImageRecipe.add_member(:date_created, Shapes::ShapeRef.new(shape: DateTime, location_name: "dateCreated"))
     ImageRecipe.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
     ImageRecipe.add_member(:working_directory, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "workingDirectory"))
+    ImageRecipe.add_member(:additional_instance_configuration, Shapes::ShapeRef.new(shape: AdditionalInstanceConfiguration, location_name: "additionalInstanceConfiguration"))
     ImageRecipe.struct_class = Types::ImageRecipe
 
     ImageRecipeSummary.add_member(:arn, Shapes::ShapeRef.new(shape: ImageBuilderArn, location_name: "arn"))
@@ -1094,6 +1130,9 @@ module Aws::Imagebuilder
 
     StringList.member = Shapes::ShapeRef.new(shape: NonEmptyString)
 
+    SystemsManagerAgent.add_member(:uninstall_after_build, Shapes::ShapeRef.new(shape: NullableBoolean, location_name: "uninstallAfterBuild"))
+    SystemsManagerAgent.struct_class = Types::SystemsManagerAgent
+
     TagKeyList.member = Shapes::ShapeRef.new(shape: TagKey)
 
     TagMap.key = Shapes::ShapeRef.new(shape: TagKey)

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

@@ -10,23 +10,65 @@
 module Aws::Imagebuilder
   module Types
 
-    # Details of an EC2 AMI.
+    # In addition to your infrastruction configuration, these settings
+    # provide an extra layer of control over your build instances. For
+    # instances where Image Builder installs the SSM agent, you can choose
+    # whether to keep it for the AMI that you create. You can also specify
+    # commands to run on launch for all of your build instances.
+    #
+    # @note When making an API call, you may pass AdditionalInstanceConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         systems_manager_agent: {
+    #           uninstall_after_build: false,
+    #         },
+    #         user_data_override: "UserDataOverride",
+    #       }
+    #
+    # @!attribute [rw] systems_manager_agent
+    #   Contains settings for the SSM agent on your build instance.
+    #   @return [Types::SystemsManagerAgent]
+    #
+    # @!attribute [rw] user_data_override
+    #   Use this property to provide commands or a command script to run
+    #   when you launch your build instance.
+    #
+    #   <note markdown="1"> The userDataOverride property replaces any commands that Image
+    #   Builder might have added to ensure that SSM is installed on your
+    #   Linux build instance. If you override the user data, make sure that
+    #   you add commands to install SSM, if it is not pre-installed on your
+    #   source image.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/AdditionalInstanceConfiguration AWS API Documentation
+    #
+    class AdditionalInstanceConfiguration < Struct.new(
+      :systems_manager_agent,
+      :user_data_override)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Details of an Amazon EC2 AMI.
     #
     # @!attribute [rw] region
-    #   The AWS Region of the EC2 AMI.
+    #   The Region of the Amazon EC2 AMI.
     #   @return [String]
     #
     # @!attribute [rw] image
-    #   The AMI ID of the EC2 AMI.
+    #   The AMI ID of the Amazon EC2 AMI.
     #   @return [String]
     #
     # @!attribute [rw] name
-    #   The name of the EC2 AMI.
+    #   The name of the Amazon EC2 AMI.
     #   @return [String]
     #
     # @!attribute [rw] description
-    #   The description of the EC2 AMI. Minimum and maximum length are in
-    #   characters.
+    #   The description of the Amazon EC2 AMI. Minimum and maximum length
+    #   are in characters.
     #   @return [String]
     #
     # @!attribute [rw] state
@@ -91,8 +133,8 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] launch_permission
-    #   Launch permissions can be used to configure which AWS accounts can
-    #   use the AMI to launch instances.
+    #   Launch permissions can be used to configure which accounts can use
+    #   the AMI to launch instances.
     #   @return [Types::LaunchPermissionConfiguration]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/AmiDistributionConfiguration AWS API Documentation
@@ -227,6 +269,11 @@ module Aws::Imagebuilder
     #   parent image OS version during image recipe creation.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] parameters
+    #   Contains parameter details for each of the parameters that are
+    #   defined for the component.
+    #   @return [Array<Types::ComponentParameterDetail>]
+    #
     # @!attribute [rw] owner
     #   The owner of the component.
     #   @return [String]
@@ -262,6 +309,7 @@ module Aws::Imagebuilder
       :type,
       :platform,
       :supported_os_versions,
+      :parameters,
       :owner,
       :data,
       :kms_key_id,
@@ -279,16 +327,86 @@ module Aws::Imagebuilder
     #
     #       {
     #         component_arn: "ComponentVersionArnOrBuildVersionArn", # required
+    #         parameters: [
+    #           {
+    #             name: "ComponentParameterName", # required
+    #             value: ["ComponentParameterValue"], # required
+    #           },
+    #         ],
     #       }
     #
     # @!attribute [rw] component_arn
     #   The Amazon Resource Name (ARN) of the component.
     #   @return [String]
     #
+    # @!attribute [rw] parameters
+    #   A group of parameter settings that are used to configure the
+    #   component for a specific recipe.
+    #   @return [Array<Types::ComponentParameter>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/ComponentConfiguration AWS API Documentation
     #
     class ComponentConfiguration < Struct.new(
-      :component_arn)
+      :component_arn,
+      :parameters)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains a key/value pair that sets the named component parameter.
+    #
+    # @note When making an API call, you may pass ComponentParameter
+    #   data as a hash:
+    #
+    #       {
+    #         name: "ComponentParameterName", # required
+    #         value: ["ComponentParameterValue"], # required
+    #       }
+    #
+    # @!attribute [rw] name
+    #   The name of the component parameter to set.
+    #   @return [String]
+    #
+    # @!attribute [rw] value
+    #   Sets the value for the named component parameter.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/ComponentParameter AWS API Documentation
+    #
+    class ComponentParameter < Struct.new(
+      :name,
+      :value)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Defines a parameter that is used to provide configuration details for
+    # the component.
+    #
+    # @!attribute [rw] name
+    #   The name of this input parameter.
+    #   @return [String]
+    #
+    # @!attribute [rw] type
+    #   The type of input this parameter provides. The currently supported
+    #   value is "string".
+    #   @return [String]
+    #
+    # @!attribute [rw] default_value
+    #   The default value of this parameter if no input is provided.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] description
+    #   Describes this parameter.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/ComponentParameterDetail AWS API Documentation
+    #
+    class ComponentParameterDetail < Struct.new(
+      :name,
+      :type,
+      :default_value,
+      :description)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -683,10 +801,11 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] uri
-    #   The uri of the component. Must be an S3 URL and the requester must
-    #   have permission to access the S3 bucket. If you use S3, you can
-    #   specify component content up to your service quota. Either `data` or
-    #   `uri` can be used to specify the data within the component.
+    #   The uri of the component. Must be an Amazon S3 URL and the requester
+    #   must have permission to access the Amazon S3 bucket. If you use
+    #   Amazon S3, you can specify component content up to your service
+    #   quota. Either `data` or `uri` can be used to specify the data within
+    #   the component.
     #   @return [String]
     #
     # @!attribute [rw] kms_key_id
@@ -756,6 +875,12 @@ module Aws::Imagebuilder
     #         components: [ # required
     #           {
     #             component_arn: "ComponentVersionArnOrBuildVersionArn", # required
+    #             parameters: [
+    #               {
+    #                 name: "ComponentParameterName", # required
+    #                 value: ["ComponentParameterValue"], # required
+    #               },
+    #             ],
     #           },
     #         ],
     #         instance_configuration: {
@@ -827,7 +952,7 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] dockerfile_template_uri
-    #   The S3 URI for the Dockerfile that will be used to build your
+    #   The Amazon S3 URI for the Dockerfile that will be used to build your
     #   container image.
     #   @return [String]
     #
@@ -1155,6 +1280,12 @@ module Aws::Imagebuilder
     #         components: [ # required
     #           {
     #             component_arn: "ComponentVersionArnOrBuildVersionArn", # required
+    #             parameters: [
+    #               {
+    #                 name: "ComponentParameterName", # required
+    #                 value: ["ComponentParameterValue"], # required
+    #               },
+    #             ],
     #           },
     #         ],
     #         parent_image: "NonEmptyString", # required
@@ -1178,6 +1309,12 @@ module Aws::Imagebuilder
     #           "TagKey" => "TagValue",
     #         },
     #         working_directory: "NonEmptyString",
+    #         additional_instance_configuration: {
+    #           systems_manager_agent: {
+    #             uninstall_after_build: false,
+    #           },
+    #           user_data_override: "UserDataOverride",
+    #         },
     #         client_token: "ClientToken", # required
     #       }
     #
@@ -1217,9 +1354,14 @@ module Aws::Imagebuilder
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] working_directory
-    #   The working directory to be used during build and test workflows.
+    #   The working directory used during build and test workflows.
     #   @return [String]
     #
+    # @!attribute [rw] additional_instance_configuration
+    #   Specify additional settings and launch scripts for your build
+    #   instances.
+    #   @return [Types::AdditionalInstanceConfiguration]
+    #
     # @!attribute [rw] client_token
     #   The idempotency token used to make this request idempotent.
     #
@@ -1238,6 +1380,7 @@ module Aws::Imagebuilder
       :block_device_mappings,
       :tags,
       :working_directory,
+      :additional_instance_configuration,
       :client_token)
       SENSITIVE = []
       include Aws::Structure
@@ -1410,17 +1553,17 @@ module Aws::Imagebuilder
     #
     # @!attribute [rw] instance_profile_name
     #   The instance profile to associate with the instance used to
-    #   customize your EC2 AMI.
+    #   customize your Amazon EC2 AMI.
     #   @return [String]
     #
     # @!attribute [rw] security_group_ids
     #   The security group IDs to associate with the instance used to
-    #   customize your EC2 AMI.
+    #   customize your Amazon EC2 AMI.
     #   @return [Array<String>]
     #
     # @!attribute [rw] subnet_id
     #   The subnet ID in which to place the instance used to customize your
-    #   EC2 AMI.
+    #   Amazon EC2 AMI.
     #   @return [String]
     #
     # @!attribute [rw] logging
@@ -2736,6 +2879,14 @@ module Aws::Imagebuilder
     #   The working directory to be used during build and test workflows.
     #   @return [String]
     #
+    # @!attribute [rw] additional_instance_configuration
+    #   Before you create a new AMI, Image Builder launches temporary Amazon
+    #   EC2 instances to build and test your image configuration. Instance
+    #   configuration adds a layer of control over those instances. You can
+    #   define settings and add scripts to run when an instance is launched
+    #   from your AMI.
+    #   @return [Types::AdditionalInstanceConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/ImageRecipe AWS API Documentation
     #
     class ImageRecipe < Struct.new(
@@ -2751,7 +2902,8 @@ module Aws::Imagebuilder
       :block_device_mappings,
       :date_created,
       :tags,
-      :working_directory)
+      :working_directory,
+      :additional_instance_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3022,10 +3174,11 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] uri
-    #   The uri of the component. Must be an S3 URL and the requester must
-    #   have permission to access the S3 bucket. If you use S3, you can
-    #   specify component content up to your service quota. Either `data` or
-    #   `uri` can be used to specify the data within the component.
+    #   The uri of the component. Must be an Amazon S3 URL and the requester
+    #   must have permission to access the Amazon S3 bucket. If you use
+    #   Amazon S3, you can specify component content up to your service
+    #   quota. Either `data` or `uri` can be used to specify the data within
+    #   the component.
     #   @return [String]
     #
     # @!attribute [rw] kms_key_id
@@ -3119,7 +3272,7 @@ module Aws::Imagebuilder
     #   @return [Types::Logging]
     #
     # @!attribute [rw] key_pair
-    #   The EC2 key pair of the infrastructure configuration.
+    #   The Amazon EC2 key pair of the infrastructure configuration.
     #   @return [String]
     #
     # @!attribute [rw] terminate_instance_on_failure
@@ -3170,7 +3323,7 @@ module Aws::Imagebuilder
       include Aws::Structure
     end
 
-    # The infrastructure used when building EC2 AMIs.
+    # The infrastructure used when building Amazon EC2 AMIs.
     #
     # @!attribute [rw] arn
     #   The Amazon Resource Name (ARN) of the infrastructure configuration.
@@ -3401,11 +3554,11 @@ module Aws::Imagebuilder
     end
 
     # Describes the configuration for a launch permission. The launch
-    # permission modification request is sent to the [EC2
+    # permission modification request is sent to the [Amazon EC2
     # ModifyImageAttribute][1] API on behalf of the user for each Region
     # they have selected to distribute the AMI. To make an AMI public, set
     # the launch permission authorized accounts to `all`. See the examples
-    # for making an AMI public at [EC2 ModifyImageAttribute][1].
+    # for making an AMI public at [Amazon EC2 ModifyImageAttribute][1].
     #
     #
     #
@@ -3420,7 +3573,7 @@ module Aws::Imagebuilder
     #       }
     #
     # @!attribute [rw] user_ids
-    #   The AWS account ID.
+    #   The account ID.
     #   @return [Array<String>]
     #
     # @!attribute [rw] user_groups
@@ -3436,7 +3589,8 @@ module Aws::Imagebuilder
       include Aws::Structure
     end
 
-    # Identifies an EC2 launch template to use for a specific account.
+    # Identifies an Amazon EC2 launch template to use for a specific
+    # account.
     #
     # @note When making an API call, you may pass LaunchTemplateConfiguration
     #   data as a hash:
@@ -3448,7 +3602,7 @@ module Aws::Imagebuilder
     #       }
     #
     # @!attribute [rw] launch_template_id
-    #   Identifies the EC2 launch template to use.
+    #   Identifies the Amazon EC2 launch template to use.
     #   @return [String]
     #
     # @!attribute [rw] account_id
@@ -3456,8 +3610,8 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] set_default_version
-    #   Set the specified EC2 launch template as the default launch template
-    #   for the specified account.
+    #   Set the specified Amazon EC2 launch template as the default launch
+    #   template for the specified account.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/LaunchTemplateConfiguration AWS API Documentation
@@ -4279,7 +4433,7 @@ module Aws::Imagebuilder
     # The resources produced by this image.
     #
     # @!attribute [rw] amis
-    #   The EC2 AMIs created by this image.
+    #   The Amazon EC2 AMIs created by this image.
     #   @return [Array<Types::Ami>]
     #
     # @!attribute [rw] containers
@@ -4714,6 +4868,30 @@ module Aws::Imagebuilder
       include Aws::Structure
     end
 
+    # Contains settings for the SSM agent on your build instance.
+    #
+    # @note When making an API call, you may pass SystemsManagerAgent
+    #   data as a hash:
+    #
+    #       {
+    #         uninstall_after_build: false,
+    #       }
+    #
+    # @!attribute [rw] uninstall_after_build
+    #   This property defaults to true. If Image Builder installs the SSM
+    #   agent on a build instance, it removes the agent before creating a
+    #   snapshot for the AMI. To ensure that the AMI you create includes the
+    #   SSM agent, set this property to false.
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/SystemsManagerAgent AWS API Documentation
+    #
+    class SystemsManagerAgent < Struct.new(
+      :uninstall_after_build)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass TagResourceRequest
     #   data as a hash:
     #
@@ -5062,17 +5240,17 @@ module Aws::Imagebuilder
     #
     # @!attribute [rw] instance_profile_name
     #   The instance profile to associate with the instance used to
-    #   customize your EC2 AMI.
+    #   customize your Amazon EC2 AMI.
     #   @return [String]
     #
     # @!attribute [rw] security_group_ids
     #   The security group IDs to associate with the instance used to
-    #   customize your EC2 AMI.
+    #   customize your Amazon EC2 AMI.
     #   @return [Array<String>]
     #
     # @!attribute [rw] subnet_id
-    #   The subnet ID to place the instance used to customize your EC2 AMI
-    #   in.
+    #   The subnet ID to place the instance used to customize your Amazon
+    #   EC2 AMI in.
     #   @return [String]
     #
     # @!attribute [rw] logging

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-imagebuilder
 version: !ruby/object:Gem::Version
-  version: 1.22.0
+  version: 1.23.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-14 00:00:00.000000000 Z
+date: 2021-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core