EC2 Image Builder Update: This release adds support to enable faster launching for Windows AMIs created by EC2 Image Builder.

Author: AWS

.changes/next-release/feature-EC2ImageBuilder-238c58e.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "EC2 Image Builder",
+    "contributor": "",
+    "description": "This release adds support to enable faster launching for Windows AMIs created by EC2 Image Builder."
+}

services/imagebuilder/src/main/resources/codegen-resources/service-2.json

@@ -54,7 +54,7 @@
         {"shape":"InvalidParameterCombinationException"},
         {"shape":"ServiceQuotaExceededException"}
       ],
-      "documentation":"<p>Creates a new component that can be used to build, validate, test, and assess your image.</p>"
+      "documentation":"<p>Creates a new component that can be used to build, validate, test, and assess your image. The component is based on a YAML document that you specify using exactly one of the following methods:</p> <ul> <li> <p>Inline, using the <code>data</code> property in the request body.</p> </li> <li> <p>A URL that points to a YAML document file stored in Amazon S3, using the <code>uri</code> property in the request body.</p> </li> </ul>"
     },
     "CreateContainerRecipe":{
       "name":"CreateContainerRecipe",
@@ -997,7 +997,7 @@
         },
         "userDataOverride":{
           "shape":"UserDataOverride",
-          "documentation":"<p>Use this property to provide commands or a command script to run when you launch your build instance.</p> <note> <p>The userDataOverride property replaces any commands that Image Builder might have added to ensure that Systems Manager is installed on your Linux build instance. If you override the user data, make sure that you add commands to install Systems Manager, if it is not pre-installed on your base image.</p> </note>"
+          "documentation":"<p>Use this property to provide commands or a command script to run when you launch your build instance.</p> <p>The userDataOverride property replaces any commands that Image Builder might have added to ensure that Systems Manager is installed on your Linux build instance. If you override the user data, make sure that you add commands to install Systems Manager, if it is not pre-installed on your base image.</p> <note> <p>The user data is always base 64 encoded. For example, the following commands are encoded as <code>IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhci$</code>:</p> <p> <i>#!/bin/bash</i> </p> <p>mkdir -p /var/bb/</p> <p>touch /var</p> </note>"
         }
       },
       "documentation":"<p>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 Systems Manager 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.</p>"
@@ -1186,7 +1186,7 @@
         },
         "data":{
           "shape":"ComponentData",
-          "documentation":"<p>The data of the component.</p>"
+          "documentation":"<p>Component data contains the YAML document content for the component.</p>"
         },
         "kmsKeyId":{
           "shape":"NonEmptyString",
@@ -1653,11 +1653,11 @@
         },
         "data":{
           "shape":"InlineComponentData",
-          "documentation":"<p>The data of the component. Used to specify the data inline. Either <code>data</code> or <code>uri</code> can be used to specify the data within the component.</p>"
+          "documentation":"<p>Component <code>data</code> contains inline YAML document content for the component. Alternatively, you can specify the <code>uri</code> of a YAML document file stored in Amazon S3. However, you cannot specify both properties.</p>"
         },
         "uri":{
           "shape":"Uri",
-          "documentation":"<p>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 <code>data</code> or <code>uri</code> can be used to specify the data within the component.</p>"
+          "documentation":"<p>The <code>uri</code> of a YAML component document file. This must be an S3 URL (<code>s3://bucket/key</code>), and the requester must have permission to access the S3 bucket it points to. If you use Amazon S3, you can specify component content up to your service quota.</p> <p>Alternatively, you can specify the YAML document inline, using the component <code>data</code> property. You cannot specify both properties.</p>"
         },
         "kmsKeyId":{
           "shape":"NonEmptyString",
@@ -2335,6 +2335,10 @@
         "s3ExportConfiguration":{
           "shape":"S3ExportConfiguration",
           "documentation":"<p>Configure export settings to deliver disk images created from your image build, using a file format that is compatible with your VMs in that Region.</p>"
+        },
+        "fastLaunchConfigurations":{
+          "shape":"FastLaunchConfigurationList",
+          "documentation":"<p>The Windows faster-launching configurations to use for AMI distribution.</p>"
         }
       },
       "documentation":"<p> Defines the settings for a specific Region.</p>"
@@ -2501,6 +2505,67 @@
       "min":0
     },
     "ErrorMessage":{"type":"string"},
+    "FastLaunchConfiguration":{
+      "type":"structure",
+      "required":["enabled"],
+      "members":{
+        "enabled":{
+          "shape":"Boolean",
+          "documentation":"<p>A Boolean that represents the current state of faster launching for the Windows AMI. Set to <code>true</code> to start using Windows faster launching, or <code>false</code> to stop using it.</p>"
+        },
+        "snapshotConfiguration":{
+          "shape":"FastLaunchSnapshotConfiguration",
+          "documentation":"<p>Configuration settings for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled.</p>"
+        },
+        "maxParallelLaunches":{
+          "shape":"MaxParallelLaunches",
+          "documentation":"<p>The maximum number of parallel instances that are launched for creating resources.</p>"
+        },
+        "launchTemplate":{
+          "shape":"FastLaunchLaunchTemplateSpecification",
+          "documentation":"<p>The launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots.</p>"
+        },
+        "accountId":{
+          "shape":"AccountId",
+          "documentation":"<p>The owner account ID for the fast-launch enabled Windows AMI.</p>"
+        }
+      },
+      "documentation":"<p>Define and configure faster launching for output Windows AMIs.</p>"
+    },
+    "FastLaunchConfigurationList":{
+      "type":"list",
+      "member":{"shape":"FastLaunchConfiguration"},
+      "max":1000,
+      "min":1
+    },
+    "FastLaunchLaunchTemplateSpecification":{
+      "type":"structure",
+      "members":{
+        "launchTemplateId":{
+          "shape":"LaunchTemplateId",
+          "documentation":"<p>The ID of the launch template to use for faster launching for a Windows AMI.</p>"
+        },
+        "launchTemplateName":{
+          "shape":"NonEmptyString",
+          "documentation":"<p>The name of the launch template to use for faster launching for a Windows AMI.</p>"
+        },
+        "launchTemplateVersion":{
+          "shape":"NonEmptyString",
+          "documentation":"<p>The version of the launch template to use for faster launching for a Windows AMI.</p>"
+        }
+      },
+      "documentation":"<p>Identifies the launch template that the associated Windows AMI uses for launching an instance when faster launching is enabled.</p> <note> <p>You can specify either the <code>launchTemplateName</code> or the <code>launchTemplateId</code>, but not both.</p> </note>"
+    },
+    "FastLaunchSnapshotConfiguration":{
+      "type":"structure",
+      "members":{
+        "targetResourceCount":{
+          "shape":"TargetResourceCount",
+          "documentation":"<p>The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.</p>"
+        }
+      },
+      "documentation":"<p>Configuration settings for creating and managing pre-provisioned snapshots for a fast-launch enabled Windows AMI.</p>"
+    },
     "Filter":{
       "type":"structure",
       "members":{
@@ -4210,6 +4275,11 @@
       },
       "documentation":"<p>Logging configuration defines where Image Builder uploads your logs.</p>"
     },
+    "MaxParallelLaunches":{
+      "type":"integer",
+      "max":10000,
+      "min":1
+    },
     "NonEmptyString":{
       "type":"string",
       "max":1024,
@@ -4683,6 +4753,11 @@
       },
       "documentation":"<p>The container repository where the output container image is stored.</p>"
     },
+    "TargetResourceCount":{
+      "type":"integer",
+      "max":10000,
+      "min":1
+    },
     "Timezone":{
       "type":"string",
       "max":100,