| 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.CreateLaunchTemplate
Description
Creates a launch template.
A launch template contains the parameters to launch an instance. When you launch an instance using RunInstances, you can specify a launch template instead of providing the launch parameters in the request. For more information, see Launch an instance from a launch template in the Amazon Elastic Compute Cloud User Guide.
If you want to clone an existing launch template as the basis for creating a new launch template, you can use the Amazon EC2 console. The API, SDKs, and CLI do not support cloning a template. For more information, see Create a launch template from an existing launch template in the Amazon Elastic Compute Cloud User Guide.
Synopsis
- data CreateLaunchTemplate = CreateLaunchTemplate' {}
- newCreateLaunchTemplate :: Text -> RequestLaunchTemplateData -> CreateLaunchTemplate
- createLaunchTemplate_clientToken :: Lens' CreateLaunchTemplate (Maybe Text)
- createLaunchTemplate_dryRun :: Lens' CreateLaunchTemplate (Maybe Bool)
- createLaunchTemplate_tagSpecifications :: Lens' CreateLaunchTemplate (Maybe [TagSpecification])
- createLaunchTemplate_versionDescription :: Lens' CreateLaunchTemplate (Maybe Text)
- createLaunchTemplate_launchTemplateName :: Lens' CreateLaunchTemplate Text
- createLaunchTemplate_launchTemplateData :: Lens' CreateLaunchTemplate RequestLaunchTemplateData
- data CreateLaunchTemplateResponse = CreateLaunchTemplateResponse' {}
- newCreateLaunchTemplateResponse :: Int -> CreateLaunchTemplateResponse
- createLaunchTemplateResponse_launchTemplate :: Lens' CreateLaunchTemplateResponse (Maybe LaunchTemplate)
- createLaunchTemplateResponse_warning :: Lens' CreateLaunchTemplateResponse (Maybe ValidationWarning)
- createLaunchTemplateResponse_httpStatus :: Lens' CreateLaunchTemplateResponse Int
Creating a Request
data CreateLaunchTemplate Source #
See: newCreateLaunchTemplate smart constructor.
Constructors
| CreateLaunchTemplate' | |
Fields
| |
Instances
newCreateLaunchTemplate Source #
Arguments
| :: Text | |
| -> RequestLaunchTemplateData | |
| -> CreateLaunchTemplate |
Create a value of CreateLaunchTemplate 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:
CreateLaunchTemplate, createLaunchTemplate_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:CreateLaunchTemplate', createLaunchTemplate_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.
CreateLaunchTemplate, createLaunchTemplate_tagSpecifications - The tags to apply to the launch template on creation. To tag the launch
template, the resource type must be launch-template.
To specify the tags for the resources that are created when an instance
is launched, you must use the TagSpecifications parameter in the
launch template data
structure.
CreateLaunchTemplate, createLaunchTemplate_versionDescription - A description for the first version of the launch template.
CreateLaunchTemplate, createLaunchTemplate_launchTemplateName - A name for the launch template.
CreateLaunchTemplate, createLaunchTemplate_launchTemplateData - The information for the launch template.
Request Lenses
createLaunchTemplate_clientToken :: Lens' CreateLaunchTemplate (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.
createLaunchTemplate_dryRun :: Lens' CreateLaunchTemplate (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.
createLaunchTemplate_tagSpecifications :: Lens' CreateLaunchTemplate (Maybe [TagSpecification]) Source #
The tags to apply to the launch template on creation. To tag the launch
template, the resource type must be launch-template.
To specify the tags for the resources that are created when an instance
is launched, you must use the TagSpecifications parameter in the
launch template data
structure.
createLaunchTemplate_versionDescription :: Lens' CreateLaunchTemplate (Maybe Text) Source #
A description for the first version of the launch template.
createLaunchTemplate_launchTemplateName :: Lens' CreateLaunchTemplate Text Source #
A name for the launch template.
createLaunchTemplate_launchTemplateData :: Lens' CreateLaunchTemplate RequestLaunchTemplateData Source #
The information for the launch template.
Destructuring the Response
data CreateLaunchTemplateResponse Source #
See: newCreateLaunchTemplateResponse smart constructor.
Constructors
| CreateLaunchTemplateResponse' | |
Fields
| |
Instances
newCreateLaunchTemplateResponse Source #
Create a value of CreateLaunchTemplateResponse 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:
CreateLaunchTemplateResponse, createLaunchTemplateResponse_launchTemplate - Information about the launch template.
$sel:warning:CreateLaunchTemplateResponse', createLaunchTemplateResponse_warning - If 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:CreateLaunchTemplateResponse', createLaunchTemplateResponse_httpStatus - The response's http status code.
Response Lenses
createLaunchTemplateResponse_launchTemplate :: Lens' CreateLaunchTemplateResponse (Maybe LaunchTemplate) Source #
Information about the launch template.
createLaunchTemplateResponse_warning :: Lens' CreateLaunchTemplateResponse (Maybe ValidationWarning) Source #
If 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.
createLaunchTemplateResponse_httpStatus :: Lens' CreateLaunchTemplateResponse Int Source #
The response's http status code.