Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.ElasticBeanstalk.CreateApplicationVersion

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Creates an application version for the specified application. You can create an application version from a source bundle in Amazon S3, a commit in AWS CodeCommit, or the output of an AWS CodeBuild build as follows:

Specify a commit in an AWS CodeCommit repository with SourceBuildInformation.

Specify a build in an AWS CodeBuild with SourceBuildInformation and BuildConfiguration.

Specify a source bundle in S3 with SourceBundle

Omit both SourceBuildInformation and SourceBundle to use the default sample application.

After you create an application version with a specified Amazon S3 bucket and key location, you can't change that Amazon S3 location. If you change the Amazon S3 location, you receive an exception when you attempt to launch an environment from the application version.

Synopsis

Creating a Request

data CreateApplicationVersion Source #

See: newCreateApplicationVersion smart constructor.

Constructors

CreateApplicationVersion'

Fields

process :: Maybe Bool
Pre-processes and validates the environment manifest (env.yaml) and configuration files (*.config files in the .ebextensions folder) in the source bundle. Validating configuration files can identify issues prior to deploying the application version to an environment.
You must turn processing on for application versions that you create using AWS CodeBuild or AWS CodeCommit. For application versions built from a source bundle in Amazon S3, processing is optional.
The Process option validates Elastic Beanstalk configuration files. It doesn't validate your application's configuration files, like proxy server or Docker configuration.
sourceBundle :: Maybe S3Location
The Amazon S3 bucket and key that identify the location of the source bundle for this version.
The Amazon S3 bucket must be in the same region as the environment.
Specify a source bundle in S3 or a commit in an AWS CodeCommit repository (with SourceBuildInformation), but not both. If neither SourceBundle nor SourceBuildInformation are provided, Elastic Beanstalk uses a sample application.
autoCreateApplication :: Maybe Bool
Set to true to create an application with the specified name if it doesn't already exist.
sourceBuildInformation :: Maybe SourceBuildInformation
Specify a commit in an AWS CodeCommit Git repository to use as the source code for the application version.
description :: Maybe Text
A description of this application version.
buildConfiguration :: Maybe BuildConfiguration
Settings for an AWS CodeBuild build.
tags :: Maybe [Tag]
Specifies the tags applied to the application version.
Elastic Beanstalk applies these tags only to the application version. Environments that use the application version don't inherit the tags.
applicationName :: Text
The name of the application. If no application is found with this name, and AutoCreateApplication is false, returns an InvalidParameterValue error.
versionLabel :: Text
A label identifying this version.
Constraint: Must be unique per application. If an application version already exists with this label for the specified application, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Instances

Instances details

Eq CreateApplicationVersion Source #
Instance details Defined in Amazonka.ElasticBeanstalk.CreateApplicationVersion Methods (==) :: CreateApplicationVersion -> CreateApplicationVersion -> Bool # (/=) :: CreateApplicationVersion -> CreateApplicationVersion -> Bool #
Read CreateApplicationVersion Source #
Instance details Defined in Amazonka.ElasticBeanstalk.CreateApplicationVersion Methods readsPrec :: Int -> ReadS CreateApplicationVersion # readList :: ReadS [CreateApplicationVersion] # readPrec :: ReadPrec CreateApplicationVersion # readListPrec :: ReadPrec [CreateApplicationVersion] #
Show CreateApplicationVersion Source #
Instance details Defined in Amazonka.ElasticBeanstalk.CreateApplicationVersion Methods showsPrec :: Int -> CreateApplicationVersion -> ShowS # show :: CreateApplicationVersion -> String # showList :: [CreateApplicationVersion] -> ShowS #
Generic CreateApplicationVersion Source #
Instance details Defined in Amazonka.ElasticBeanstalk.CreateApplicationVersion Associated Types type Rep CreateApplicationVersion :: Type -> Type # Methods from :: CreateApplicationVersion -> Rep CreateApplicationVersion x # to :: Rep CreateApplicationVersion x -> CreateApplicationVersion #
NFData CreateApplicationVersion Source #
Instance details Defined in Amazonka.ElasticBeanstalk.CreateApplicationVersion Methods rnf :: CreateApplicationVersion -> () #
Hashable CreateApplicationVersion Source #
Instance details Defined in Amazonka.ElasticBeanstalk.CreateApplicationVersion Methods hashWithSalt :: Int -> CreateApplicationVersion -> Int # hash :: CreateApplicationVersion -> Int #
AWSRequest CreateApplicationVersion Source #
Instance details Defined in Amazonka.ElasticBeanstalk.CreateApplicationVersion Associated Types type AWSResponse CreateApplicationVersion # Methods request :: CreateApplicationVersion -> Request CreateApplicationVersion # response :: MonadResource m => Logger -> Service -> Proxy CreateApplicationVersion -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse CreateApplicationVersion))) #
ToHeaders CreateApplicationVersion Source #
Instance details Defined in Amazonka.ElasticBeanstalk.CreateApplicationVersion Methods toHeaders :: CreateApplicationVersion -> [Header] #
ToPath CreateApplicationVersion Source #
Instance details Defined in Amazonka.ElasticBeanstalk.CreateApplicationVersion Methods toPath :: CreateApplicationVersion -> ByteString #
ToQuery CreateApplicationVersion Source #
Instance details Defined in Amazonka.ElasticBeanstalk.CreateApplicationVersion Methods toQuery :: CreateApplicationVersion -> QueryString #
type Rep CreateApplicationVersion Source #
Instance details Defined in Amazonka.ElasticBeanstalk.CreateApplicationVersion type Rep CreateApplicationVersion = D1 ('MetaData "CreateApplicationVersion" "Amazonka.ElasticBeanstalk.CreateApplicationVersion" "libZSservicesZSamazonka-elasticbeanstalkZSamazonka-elasticbeanstalk" 'False) (C1 ('MetaCons "CreateApplicationVersion'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "process") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :: S1 ('MetaSel ('Just "sourceBundle") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe S3Location))) :: (S1 ('MetaSel ('Just "autoCreateApplication") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :: S1 ('MetaSel ('Just "sourceBuildInformation") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SourceBuildInformation)))) :: ((S1 ('MetaSel ('Just "description") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "buildConfiguration") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe BuildConfiguration))) :: (S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Tag])) :: (S1 ('MetaSel ('Just "applicationName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :: S1 ('MetaSel ('Just "versionLabel") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))))
type AWSResponse CreateApplicationVersion Source #
Instance details Defined in Amazonka.ElasticBeanstalk.CreateApplicationVersion type AWSResponse CreateApplicationVersion = ApplicationVersionDescriptionMessage

newCreateApplicationVersion Source #

Arguments

:: Text	`$sel:applicationName:CreateApplicationVersion'`
-> Text	`$sel:versionLabel:CreateApplicationVersion'`
-> CreateApplicationVersion

Create a value of CreateApplicationVersion 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:process:CreateApplicationVersion', createApplicationVersion_process - Pre-processes and validates the environment manifest (env.yaml) and configuration files (*.config files in the .ebextensions folder) in the source bundle. Validating configuration files can identify issues prior to deploying the application version to an environment.

You must turn processing on for application versions that you create using AWS CodeBuild or AWS CodeCommit. For application versions built from a source bundle in Amazon S3, processing is optional.

The Process option validates Elastic Beanstalk configuration files. It doesn't validate your application's configuration files, like proxy server or Docker configuration.

$sel:sourceBundle:CreateApplicationVersion', createApplicationVersion_sourceBundle - The Amazon S3 bucket and key that identify the location of the source bundle for this version.

The Amazon S3 bucket must be in the same region as the environment.

Specify a source bundle in S3 or a commit in an AWS CodeCommit repository (with SourceBuildInformation), but not both. If neither SourceBundle nor SourceBuildInformation are provided, Elastic Beanstalk uses a sample application.

$sel:autoCreateApplication:CreateApplicationVersion', createApplicationVersion_autoCreateApplication - Set to true to create an application with the specified name if it doesn't already exist.

$sel:sourceBuildInformation:CreateApplicationVersion', createApplicationVersion_sourceBuildInformation - Specify a commit in an AWS CodeCommit Git repository to use as the source code for the application version.

$sel:description:CreateApplicationVersion', createApplicationVersion_description - A description of this application version.

$sel:buildConfiguration:CreateApplicationVersion', createApplicationVersion_buildConfiguration - Settings for an AWS CodeBuild build.

$sel:tags:CreateApplicationVersion', createApplicationVersion_tags - Specifies the tags applied to the application version.

Elastic Beanstalk applies these tags only to the application version. Environments that use the application version don't inherit the tags.

$sel:applicationName:CreateApplicationVersion', createApplicationVersion_applicationName - The name of the application. If no application is found with this name, and AutoCreateApplication is false, returns an InvalidParameterValue error.

$sel:versionLabel:CreateApplicationVersion', createApplicationVersion_versionLabel - A label identifying this version.

Constraint: Must be unique per application. If an application version already exists with this label for the specified application, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Request Lenses

createApplicationVersion_process :: Lens' CreateApplicationVersion (Maybe Bool) Source #

Pre-processes and validates the environment manifest (env.yaml) and configuration files (*.config files in the .ebextensions folder) in the source bundle. Validating configuration files can identify issues prior to deploying the application version to an environment.

You must turn processing on for application versions that you create using AWS CodeBuild or AWS CodeCommit. For application versions built from a source bundle in Amazon S3, processing is optional.

The Process option validates Elastic Beanstalk configuration files. It doesn't validate your application's configuration files, like proxy server or Docker configuration.

createApplicationVersion_sourceBundle :: Lens' CreateApplicationVersion (Maybe S3Location) Source #

The Amazon S3 bucket and key that identify the location of the source bundle for this version.

The Amazon S3 bucket must be in the same region as the environment.

Specify a source bundle in S3 or a commit in an AWS CodeCommit repository (with SourceBuildInformation), but not both. If neither SourceBundle nor SourceBuildInformation are provided, Elastic Beanstalk uses a sample application.

createApplicationVersion_autoCreateApplication :: Lens' CreateApplicationVersion (Maybe Bool) Source #

Set to true to create an application with the specified name if it doesn't already exist.

createApplicationVersion_sourceBuildInformation :: Lens' CreateApplicationVersion (Maybe SourceBuildInformation) Source #

Specify a commit in an AWS CodeCommit Git repository to use as the source code for the application version.

createApplicationVersion_description :: Lens' CreateApplicationVersion (Maybe Text) Source #

A description of this application version.

createApplicationVersion_buildConfiguration :: Lens' CreateApplicationVersion (Maybe BuildConfiguration) Source #

Settings for an AWS CodeBuild build.

createApplicationVersion_tags :: Lens' CreateApplicationVersion (Maybe [Tag]) Source #

Specifies the tags applied to the application version.

Elastic Beanstalk applies these tags only to the application version. Environments that use the application version don't inherit the tags.

createApplicationVersion_applicationName :: Lens' CreateApplicationVersion Text Source #

The name of the application. If no application is found with this name, and AutoCreateApplication is false, returns an InvalidParameterValue error.

createApplicationVersion_versionLabel :: Lens' CreateApplicationVersion Text Source #

A label identifying this version.

Constraint: Must be unique per application. If an application version already exists with this label for the specified application, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Destructuring the Response

data ApplicationVersionDescriptionMessage Source #

Result message wrapping a single description of an application version.

See: newApplicationVersionDescriptionMessage smart constructor.

Constructors

ApplicationVersionDescriptionMessage'
Fields applicationVersion :: Maybe ApplicationVersionDescription The ApplicationVersionDescription of the application version.

Instances

Instances details

Eq ApplicationVersionDescriptionMessage Source #
Instance details Defined in Amazonka.ElasticBeanstalk.Types.ApplicationVersionDescriptionMessage Methods (==) :: ApplicationVersionDescriptionMessage -> ApplicationVersionDescriptionMessage -> Bool # (/=) :: ApplicationVersionDescriptionMessage -> ApplicationVersionDescriptionMessage -> Bool #
Read ApplicationVersionDescriptionMessage Source #
Instance details Defined in Amazonka.ElasticBeanstalk.Types.ApplicationVersionDescriptionMessage Methods readsPrec :: Int -> ReadS ApplicationVersionDescriptionMessage # readList :: ReadS [ApplicationVersionDescriptionMessage] # readPrec :: ReadPrec ApplicationVersionDescriptionMessage # readListPrec :: ReadPrec [ApplicationVersionDescriptionMessage] #
Show ApplicationVersionDescriptionMessage Source #
Instance details Defined in Amazonka.ElasticBeanstalk.Types.ApplicationVersionDescriptionMessage Methods showsPrec :: Int -> ApplicationVersionDescriptionMessage -> ShowS # show :: ApplicationVersionDescriptionMessage -> String # showList :: [ApplicationVersionDescriptionMessage] -> ShowS #
Generic ApplicationVersionDescriptionMessage Source #
Instance details Defined in Amazonka.ElasticBeanstalk.Types.ApplicationVersionDescriptionMessage Associated Types type Rep ApplicationVersionDescriptionMessage :: Type -> Type # Methods from :: ApplicationVersionDescriptionMessage -> Rep ApplicationVersionDescriptionMessage x # to :: Rep ApplicationVersionDescriptionMessage x -> ApplicationVersionDescriptionMessage #
NFData ApplicationVersionDescriptionMessage Source #
Instance details Defined in Amazonka.ElasticBeanstalk.Types.ApplicationVersionDescriptionMessage Methods rnf :: ApplicationVersionDescriptionMessage -> () #
Hashable ApplicationVersionDescriptionMessage Source #
Instance details Defined in Amazonka.ElasticBeanstalk.Types.ApplicationVersionDescriptionMessage Methods hashWithSalt :: Int -> ApplicationVersionDescriptionMessage -> Int # hash :: ApplicationVersionDescriptionMessage -> Int #
FromXML ApplicationVersionDescriptionMessage Source #
Instance details Defined in Amazonka.ElasticBeanstalk.Types.ApplicationVersionDescriptionMessage Methods parseXML :: [Node] -> Either String ApplicationVersionDescriptionMessage #
type Rep ApplicationVersionDescriptionMessage Source #
Instance details Defined in Amazonka.ElasticBeanstalk.Types.ApplicationVersionDescriptionMessage type Rep ApplicationVersionDescriptionMessage = D1 ('MetaData "ApplicationVersionDescriptionMessage" "Amazonka.ElasticBeanstalk.Types.ApplicationVersionDescriptionMessage" "libZSservicesZSamazonka-elasticbeanstalkZSamazonka-elasticbeanstalk" 'False) (C1 ('MetaCons "ApplicationVersionDescriptionMessage'" 'PrefixI 'True) (S1 ('MetaSel ('Just "applicationVersion") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ApplicationVersionDescription))))

newApplicationVersionDescriptionMessage :: ApplicationVersionDescriptionMessage Source #

Create a value of ApplicationVersionDescriptionMessage 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:applicationVersion:ApplicationVersionDescriptionMessage', applicationVersionDescriptionMessage_applicationVersion - The ApplicationVersionDescription of the application version.

Response Lenses

applicationVersionDescriptionMessage_applicationVersion :: Lens' ApplicationVersionDescriptionMessage (Maybe ApplicationVersionDescription) Source #

The ApplicationVersionDescription of the application version.