opsworks_update_app: Updates a specified app

Description

Updates a specified app.

Usage

opsworks_update_app(AppId, Name, Description, DataSources, Type,
  AppSource, Domains, EnableSsl, SslConfiguration, Attributes,
  Environment)

Arguments

AppId

[required] The app ID.

Name

The app name.

Description

A description of the app.

DataSources

The app's data sources.

Type

The app type.

AppSource

A Source object that specifies the app repository.

Domains

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

EnableSsl

Whether SSL is enabled for the app.

SslConfiguration

An SslConfiguration object with the SSL configuration.

Attributes

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

Environment

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 instances.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.

Request syntax

svc$update_app(
  AppId = "string",
  Name = "string",
  Description = "string",
  DataSources = list(
    list(
      Type = "string",
      Arn = "string",
      DatabaseName = "string"
    )
  ),
  Type = "aws-flow-ruby"|"java"|"rails"|"php"|"nodejs"|"static"|"other",
  AppSource = list(
    Type = "git"|"svn"|"archive"|"s3",
    Url = "string",
    Username = "string",
    Password = "string",
    SshKey = "string",
    Revision = "string"
  ),
  Domains = list(
    "string"
  ),
  EnableSsl = TRUE|FALSE,
  SslConfiguration = list(
    Certificate = "string",
    PrivateKey = "string",
    Chain = "string"
  ),
  Attributes = list(
    "string"
  ),
  Environment = list(
    list(
      Key = "string",
      Value = "string",
      Secure = TRUE|FALSE
    )
  )
)

Details

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