| Copyright | (c) 2013-2023 Brendan Hay |
|---|---|
| License | Mozilla Public License, v. 2.0. |
| Maintainer | Brendan Hay |
| Stability | auto-generated |
| Portability | non-portable (GHC extensions) |
| Safe Haskell | Safe-Inferred |
| Language | Haskell2010 |
Amazonka.EC2.CreateLaunchTemplateVersion
Description
Creates a new version of a launch template. You can specify an existing version of launch template from which to base the new version.
Launch template versions are numbered in the order in which they are created. You cannot specify, change, or replace the numbering of launch template versions.
Launch templates are immutable; after you create a launch template, you can't modify it. Instead, you can create a new version of the launch template that includes any changes you require.
For more information, see Modify a launch template (manage launch template versions) in the Amazon Elastic Compute Cloud User Guide.
Synopsis
- data CreateLaunchTemplateVersion = CreateLaunchTemplateVersion' {}
- newCreateLaunchTemplateVersion :: RequestLaunchTemplateData -> CreateLaunchTemplateVersion
- createLaunchTemplateVersion_clientToken :: Lens' CreateLaunchTemplateVersion (Maybe Text)
- createLaunchTemplateVersion_dryRun :: Lens' CreateLaunchTemplateVersion (Maybe Bool)
- createLaunchTemplateVersion_launchTemplateId :: Lens' CreateLaunchTemplateVersion (Maybe Text)
- createLaunchTemplateVersion_launchTemplateName :: Lens' CreateLaunchTemplateVersion (Maybe Text)
- createLaunchTemplateVersion_sourceVersion :: Lens' CreateLaunchTemplateVersion (Maybe Text)
- createLaunchTemplateVersion_versionDescription :: Lens' CreateLaunchTemplateVersion (Maybe Text)
- createLaunchTemplateVersion_launchTemplateData :: Lens' CreateLaunchTemplateVersion RequestLaunchTemplateData
- data CreateLaunchTemplateVersionResponse = CreateLaunchTemplateVersionResponse' {}
- newCreateLaunchTemplateVersionResponse :: Int -> CreateLaunchTemplateVersionResponse
- createLaunchTemplateVersionResponse_launchTemplateVersion :: Lens' CreateLaunchTemplateVersionResponse (Maybe LaunchTemplateVersion)
- createLaunchTemplateVersionResponse_warning :: Lens' CreateLaunchTemplateVersionResponse (Maybe ValidationWarning)
- createLaunchTemplateVersionResponse_httpStatus :: Lens' CreateLaunchTemplateVersionResponse Int
Creating a Request
data CreateLaunchTemplateVersion Source #
See: newCreateLaunchTemplateVersion smart constructor.
Constructors
| CreateLaunchTemplateVersion' | |
Fields
| |
Instances
newCreateLaunchTemplateVersion Source #
Create a value of CreateLaunchTemplateVersion with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
CreateLaunchTemplateVersion, createLaunchTemplateVersion_clientToken - Unique, case-sensitive identifier you provide to ensure the idempotency
of the request. For more information, see
Ensuring idempotency.
Constraint: Maximum 128 ASCII characters.
$sel:dryRun:CreateLaunchTemplateVersion', createLaunchTemplateVersion_dryRun - Checks whether you have the required permissions for the action, without
actually making the request, and provides an error response. If you have
the required permissions, the error response is DryRunOperation.
Otherwise, it is UnauthorizedOperation.
CreateLaunchTemplateVersion, createLaunchTemplateVersion_launchTemplateId - The ID of the launch template.
You must specify either the LaunchTemplateId or the
LaunchTemplateName, but not both.
CreateLaunchTemplateVersion, createLaunchTemplateVersion_launchTemplateName - The name of the launch template.
You must specify the LaunchTemplateName or the LaunchTemplateId, but
not both.
$sel:sourceVersion:CreateLaunchTemplateVersion', createLaunchTemplateVersion_sourceVersion - The version number of the launch template version on which to base the
new version. The new version inherits the same launch parameters as the
source version, except for parameters that you specify in
LaunchTemplateData. Snapshots applied to the block device mapping are
ignored when creating a new version unless they are explicitly included.
CreateLaunchTemplateVersion, createLaunchTemplateVersion_versionDescription - A description for the version of the launch template.
CreateLaunchTemplateVersion, createLaunchTemplateVersion_launchTemplateData - The information for the launch template.
Request Lenses
createLaunchTemplateVersion_clientToken :: Lens' CreateLaunchTemplateVersion (Maybe Text) Source #
Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring idempotency.
Constraint: Maximum 128 ASCII characters.
createLaunchTemplateVersion_dryRun :: Lens' CreateLaunchTemplateVersion (Maybe Bool) Source #
Checks whether you have the required permissions for the action, without
actually making the request, and provides an error response. If you have
the required permissions, the error response is DryRunOperation.
Otherwise, it is UnauthorizedOperation.
createLaunchTemplateVersion_launchTemplateId :: Lens' CreateLaunchTemplateVersion (Maybe Text) Source #
The ID of the launch template.
You must specify either the LaunchTemplateId or the
LaunchTemplateName, but not both.
createLaunchTemplateVersion_launchTemplateName :: Lens' CreateLaunchTemplateVersion (Maybe Text) Source #
The name of the launch template.
You must specify the LaunchTemplateName or the LaunchTemplateId, but
not both.
createLaunchTemplateVersion_sourceVersion :: Lens' CreateLaunchTemplateVersion (Maybe Text) Source #
The version number of the launch template version on which to base the
new version. The new version inherits the same launch parameters as the
source version, except for parameters that you specify in
LaunchTemplateData. Snapshots applied to the block device mapping are
ignored when creating a new version unless they are explicitly included.
createLaunchTemplateVersion_versionDescription :: Lens' CreateLaunchTemplateVersion (Maybe Text) Source #
A description for the version of the launch template.
createLaunchTemplateVersion_launchTemplateData :: Lens' CreateLaunchTemplateVersion RequestLaunchTemplateData Source #
The information for the launch template.
Destructuring the Response
data CreateLaunchTemplateVersionResponse Source #
See: newCreateLaunchTemplateVersionResponse smart constructor.
Constructors
| CreateLaunchTemplateVersionResponse' | |
Fields
| |
Instances
newCreateLaunchTemplateVersionResponse Source #
Arguments
| :: Int | |
| -> CreateLaunchTemplateVersionResponse |
Create a value of CreateLaunchTemplateVersionResponse with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:launchTemplateVersion:CreateLaunchTemplateVersionResponse', createLaunchTemplateVersionResponse_launchTemplateVersion - Information about the launch template version.
$sel:warning:CreateLaunchTemplateVersionResponse', createLaunchTemplateVersionResponse_warning - If the new version of the launch template contains parameters or
parameter combinations that are not valid, an error code and an error
message are returned for each issue that's found.
$sel:httpStatus:CreateLaunchTemplateVersionResponse', createLaunchTemplateVersionResponse_httpStatus - The response's http status code.
Response Lenses
createLaunchTemplateVersionResponse_launchTemplateVersion :: Lens' CreateLaunchTemplateVersionResponse (Maybe LaunchTemplateVersion) Source #
Information about the launch template version.
createLaunchTemplateVersionResponse_warning :: Lens' CreateLaunchTemplateVersionResponse (Maybe ValidationWarning) Source #
If the new version of the launch template contains parameters or parameter combinations that are not valid, an error code and an error message are returned for each issue that's found.
createLaunchTemplateVersionResponse_httpStatus :: Lens' CreateLaunchTemplateVersionResponse Int Source #
The response's http status code.