amazonka-opsworks-1.3.0: Amazon OpsWorks SDK.

Copyright(c) 2013-2015 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <>
Portabilitynon-portable (GHC extensions)
Safe HaskellNone




Creates an app for a specified stack. For more information, see Creating Apps.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

See: AWS API Reference for CreateApp.


Creating a Request

createApp Source

Creates a value of CreateApp with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Request Lenses

caSSLConfiguration :: Lens' CreateApp (Maybe SSLConfiguration) Source

An SslConfiguration object with the SSL configuration.

caEnvironment :: Lens' CreateApp [EnvironmentVariable] Source

An array of EnvironmentVariable objects that specify environment variables to be associated with the app. After you deploy the app, these variables are defined on the associated app server instance. For more information, see Environment Variables.

There is no specific limit on the number of environment variables. However, the size of the associated data structure - which includes the variables' names, values, and protected flag values - cannot exceed 10 KB (10240 Bytes). This limit should accommodate most if not all use cases. Exceeding it will cause an exception with the message, "Environment: is too large (maximum is 10KB)."

This parameter is supported only by Chef 11.10 stacks. If you have specified one or more environment variables, you cannot modify the stack's Chef version.

caEnableSSL :: Lens' CreateApp (Maybe Bool) Source

Whether to enable SSL for the app.

caShortname :: Lens' CreateApp (Maybe Text) Source

The app's short name.

caDataSources :: Lens' CreateApp [DataSource] Source

The app's data source.

caAppSource :: Lens' CreateApp (Maybe Source) Source

A Source object that specifies the app repository.

caAttributes :: Lens' CreateApp (HashMap AppAttributesKeys Text) Source

One or more user-defined key/value pairs to be added to the stack attributes.

caDomains :: Lens' CreateApp [Text] Source

The app virtual host settings, with multiple domains separated by commas. For example: '\',''

caDescription :: Lens' CreateApp (Maybe Text) Source

A description of the app.

caName :: Lens' CreateApp Text Source

The app name.

caType :: Lens' CreateApp AppType Source

The app type. Each supported type is associated with a particular layer. For example, PHP applications are associated with a PHP layer. AWS OpsWorks deploys an application to those instances that are members of the corresponding layer. If your app isn't one of the standard types, or you prefer to implement your own Deploy recipes, specify other.

Destructuring the Response

createAppResponse Source

Creates a value of CreateAppResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Response Lenses