com.amazonaws.services.elasticbeanstalk.model

Class UpdateEnvironmentRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.elasticbeanstalk.model.UpdateEnvironmentRequest

All Implemented Interfaces:

ReadLimitInfo, Serializable, Cloneable

public class UpdateEnvironmentRequest
extends AmazonWebServiceRequest
implements Serializable, Cloneable

Container for the parameters to the UpdateEnvironment operation.

Updates the environment description, deploys a new application version, updates the configuration settings to an entirely new configuration template, or updates select configuration option values in the running environment.

Attempting to update both the release and configuration is not allowed and AWS Elastic Beanstalk returns an InvalidParameterCombination error.

When updating the configuration settings to a new template or individual settings, a draft configuration is created and DescribeConfigurationSettings for this environment returns two setting descriptions with different DeploymentStatus values.

See Also:

AWSElasticBeanstalk.updateEnvironment(UpdateEnvironmentRequest), Serialized Form

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
UpdateEnvironmentRequest() Default constructor for a new UpdateEnvironmentRequest object.

Method Summary

Methods

Modifier and Type	Method and Description
UpdateEnvironmentRequest	clone() Creates a shallow clone of this request.
boolean	equals(Object obj)
String	getDescription() If this parameter is specified, AWS Elastic Beanstalk updates the description of this environment.
String	getEnvironmentId() The ID of the environment to update.
String	getEnvironmentName() The name of the environment to update.
List<ConfigurationOptionSetting>	getOptionSettings() If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.
List<OptionSpecification>	getOptionsToRemove() A list of custom user-defined configuration options to remove from the configuration set for this environment.
String	getSolutionStackName() This specifies the platform version that the environment will run after the environment is updated.
String	getTemplateName() If this parameter is specified, AWS Elastic Beanstalk deploys this configuration template to the environment.
EnvironmentTier	getTier() This specifies the tier to use to update the environment.
String	getVersionLabel() If this parameter is specified, AWS Elastic Beanstalk deploys the named application version to the environment.
int	hashCode()
void	setDescription(String description) If this parameter is specified, AWS Elastic Beanstalk updates the description of this environment.
void	setEnvironmentId(String environmentId) The ID of the environment to update.
void	setEnvironmentName(String environmentName) The name of the environment to update.
void	setOptionSettings(Collection<ConfigurationOptionSetting> optionSettings) If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.
void	setOptionsToRemove(Collection<OptionSpecification> optionsToRemove) A list of custom user-defined configuration options to remove from the configuration set for this environment.
void	setSolutionStackName(String solutionStackName) This specifies the platform version that the environment will run after the environment is updated.
void	setTemplateName(String templateName) If this parameter is specified, AWS Elastic Beanstalk deploys this configuration template to the environment.
void	setTier(EnvironmentTier tier) This specifies the tier to use to update the environment.
void	setVersionLabel(String versionLabel) If this parameter is specified, AWS Elastic Beanstalk deploys the named application version to the environment.
String	toString() Returns a string representation of this object; useful for testing and debugging.
UpdateEnvironmentRequest	withDescription(String description) If this parameter is specified, AWS Elastic Beanstalk updates the description of this environment.
UpdateEnvironmentRequest	withEnvironmentId(String environmentId) The ID of the environment to update.
UpdateEnvironmentRequest	withEnvironmentName(String environmentName) The name of the environment to update.
UpdateEnvironmentRequest	withOptionSettings(Collection<ConfigurationOptionSetting> optionSettings) If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.
UpdateEnvironmentRequest	withOptionSettings(ConfigurationOptionSetting... optionSettings) If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.
UpdateEnvironmentRequest	withOptionsToRemove(Collection<OptionSpecification> optionsToRemove) A list of custom user-defined configuration options to remove from the configuration set for this environment.
UpdateEnvironmentRequest	withOptionsToRemove(OptionSpecification... optionsToRemove) A list of custom user-defined configuration options to remove from the configuration set for this environment.
UpdateEnvironmentRequest	withSolutionStackName(String solutionStackName) This specifies the platform version that the environment will run after the environment is updated.
UpdateEnvironmentRequest	withTemplateName(String templateName) If this parameter is specified, AWS Elastic Beanstalk deploys this configuration template to the environment.
UpdateEnvironmentRequest	withTier(EnvironmentTier tier) This specifies the tier to use to update the environment.
UpdateEnvironmentRequest	withVersionLabel(String versionLabel) If this parameter is specified, AWS Elastic Beanstalk deploys the named application version to the environment.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

copyBaseTo, getCustomRequestHeaders, getGeneralProgressListener, getReadLimit, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, putCustomRequestHeader, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

UpdateEnvironmentRequest

public UpdateEnvironmentRequest()

Default constructor for a new UpdateEnvironmentRequest object. Callers should use the setter or fluent setter (with...) methods to initialize this object after creating it.

Method Detail

getEnvironmentId

public String getEnvironmentId()

The ID of the environment to update.

If no environment with this ID exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

Returns:

The ID of the environment to update.

If no environment with this ID exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

setEnvironmentId

public void setEnvironmentId(String environmentId)

The ID of the environment to update.

If no environment with this ID exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

Parameters:

environmentId - The ID of the environment to update.

If no environment with this ID exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

withEnvironmentId

public UpdateEnvironmentRequest withEnvironmentId(String environmentId)

The ID of the environment to update.

If no environment with this ID exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

Returns a reference to this object so that method calls can be chained together.

Parameters:

environmentId - The ID of the environment to update.

If no environment with this ID exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

Returns:

A reference to this updated object so that method calls can be chained together.

getEnvironmentName

public String getEnvironmentName()

The name of the environment to update. If no environment with this name exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

Constraints:
Length: 4 - 23

Returns:

The name of the environment to update. If no environment with this name exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

setEnvironmentName

public void setEnvironmentName(String environmentName)

The name of the environment to update. If no environment with this name exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

Constraints:
Length: 4 - 23

Parameters:

environmentName - The name of the environment to update. If no environment with this name exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

withEnvironmentName

public UpdateEnvironmentRequest withEnvironmentName(String environmentName)

The name of the environment to update. If no environment with this name exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

Returns a reference to this object so that method calls can be chained together.

Constraints:
Length: 4 - 23

Parameters:

environmentName - The name of the environment to update. If no environment with this name exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

Returns:

A reference to this updated object so that method calls can be chained together.

getDescription

public String getDescription()

If this parameter is specified, AWS Elastic Beanstalk updates the description of this environment.

Constraints:
Length: 0 - 200

Returns:

If this parameter is specified, AWS Elastic Beanstalk updates the description of this environment.

setDescription

public void setDescription(String description)

If this parameter is specified, AWS Elastic Beanstalk updates the description of this environment.

Constraints:
Length: 0 - 200

Parameters:

description - If this parameter is specified, AWS Elastic Beanstalk updates the description of this environment.

withDescription

public UpdateEnvironmentRequest withDescription(String description)

If this parameter is specified, AWS Elastic Beanstalk updates the description of this environment.

Returns a reference to this object so that method calls can be chained together.

Constraints:
Length: 0 - 200

Parameters:

description - If this parameter is specified, AWS Elastic Beanstalk updates the description of this environment.

Returns:

A reference to this updated object so that method calls can be chained together.

getTier

public EnvironmentTier getTier()

This specifies the tier to use to update the environment.

Condition: At this time, if you change the tier version, name, or type, AWS Elastic Beanstalk returns InvalidParameterValue error.

Returns:

This specifies the tier to use to update the environment.

Condition: At this time, if you change the tier version, name, or type, AWS Elastic Beanstalk returns InvalidParameterValue error.

setTier

public void setTier(EnvironmentTier tier)

This specifies the tier to use to update the environment.

Condition: At this time, if you change the tier version, name, or type, AWS Elastic Beanstalk returns InvalidParameterValue error.

Parameters:

tier - This specifies the tier to use to update the environment.

Condition: At this time, if you change the tier version, name, or type, AWS Elastic Beanstalk returns InvalidParameterValue error.

withTier

public UpdateEnvironmentRequest withTier(EnvironmentTier tier)

This specifies the tier to use to update the environment.

Condition: At this time, if you change the tier version, name, or type, AWS Elastic Beanstalk returns InvalidParameterValue error.

Returns a reference to this object so that method calls can be chained together.

Parameters:

tier - This specifies the tier to use to update the environment.

Condition: At this time, if you change the tier version, name, or type, AWS Elastic Beanstalk returns InvalidParameterValue error.

Returns:

A reference to this updated object so that method calls can be chained together.

getVersionLabel

public String getVersionLabel()

If this parameter is specified, AWS Elastic Beanstalk deploys the named application version to the environment. If no such application version is found, returns an InvalidParameterValue error.

Constraints:
Length: 1 - 100

Returns:

If this parameter is specified, AWS Elastic Beanstalk deploys the named application version to the environment. If no such application version is found, returns an InvalidParameterValue error.

setVersionLabel

public void setVersionLabel(String versionLabel)

If this parameter is specified, AWS Elastic Beanstalk deploys the named application version to the environment. If no such application version is found, returns an InvalidParameterValue error.

Constraints:
Length: 1 - 100

Parameters:

versionLabel - If this parameter is specified, AWS Elastic Beanstalk deploys the named application version to the environment. If no such application version is found, returns an InvalidParameterValue error.

withVersionLabel

public UpdateEnvironmentRequest withVersionLabel(String versionLabel)

If this parameter is specified, AWS Elastic Beanstalk deploys the named application version to the environment. If no such application version is found, returns an InvalidParameterValue error.

Returns a reference to this object so that method calls can be chained together.

Constraints:
Length: 1 - 100

Parameters:

versionLabel - If this parameter is specified, AWS Elastic Beanstalk deploys the named application version to the environment. If no such application version is found, returns an InvalidParameterValue error.

Returns:

A reference to this updated object so that method calls can be chained together.

getTemplateName

public String getTemplateName()

If this parameter is specified, AWS Elastic Beanstalk deploys this configuration template to the environment. If no such configuration template is found, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Constraints:
Length: 1 - 100

Returns:

If this parameter is specified, AWS Elastic Beanstalk deploys this configuration template to the environment. If no such configuration template is found, AWS Elastic Beanstalk returns an InvalidParameterValue error.

setTemplateName

public void setTemplateName(String templateName)

If this parameter is specified, AWS Elastic Beanstalk deploys this configuration template to the environment. If no such configuration template is found, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Constraints:
Length: 1 - 100

Parameters:

templateName - If this parameter is specified, AWS Elastic Beanstalk deploys this configuration template to the environment. If no such configuration template is found, AWS Elastic Beanstalk returns an InvalidParameterValue error.

withTemplateName

public UpdateEnvironmentRequest withTemplateName(String templateName)

If this parameter is specified, AWS Elastic Beanstalk deploys this configuration template to the environment. If no such configuration template is found, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Returns a reference to this object so that method calls can be chained together.

Constraints:
Length: 1 - 100

Parameters:

templateName - If this parameter is specified, AWS Elastic Beanstalk deploys this configuration template to the environment. If no such configuration template is found, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Returns:

A reference to this updated object so that method calls can be chained together.

getSolutionStackName

public String getSolutionStackName()

This specifies the platform version that the environment will run after the environment is updated.

Constraints:
Length: 0 - 100

Returns:

This specifies the platform version that the environment will run after the environment is updated.

setSolutionStackName

public void setSolutionStackName(String solutionStackName)

This specifies the platform version that the environment will run after the environment is updated.

Constraints:
Length: 0 - 100

Parameters:

solutionStackName - This specifies the platform version that the environment will run after the environment is updated.

withSolutionStackName

public UpdateEnvironmentRequest withSolutionStackName(String solutionStackName)

This specifies the platform version that the environment will run after the environment is updated.

Returns a reference to this object so that method calls can be chained together.

Constraints:
Length: 0 - 100

Parameters:

solutionStackName - This specifies the platform version that the environment will run after the environment is updated.

Returns:

A reference to this updated object so that method calls can be chained together.

getOptionSettings

public List<ConfigurationOptionSetting> getOptionSettings()

If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.

Returns:

If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.

setOptionSettings

public void setOptionSettings(Collection<ConfigurationOptionSetting> optionSettings)

If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.

Parameters:

optionSettings - If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.

withOptionSettings

public UpdateEnvironmentRequest withOptionSettings(ConfigurationOptionSetting... optionSettings)

If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.

NOTE: This method appends the values to the existing list (if any). Use setOptionSettings(java.util.Collection) or withOptionSettings(java.util.Collection) if you want to override the existing values.

Returns a reference to this object so that method calls can be chained together.

Parameters:

optionSettings - If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.

Returns:

A reference to this updated object so that method calls can be chained together.

withOptionSettings

public UpdateEnvironmentRequest withOptionSettings(Collection<ConfigurationOptionSetting> optionSettings)

If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.

Returns a reference to this object so that method calls can be chained together.

Parameters:

optionSettings - If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.

Returns:

A reference to this updated object so that method calls can be chained together.

getOptionsToRemove

public List<OptionSpecification> getOptionsToRemove()

A list of custom user-defined configuration options to remove from the configuration set for this environment.

Returns:

A list of custom user-defined configuration options to remove from the configuration set for this environment.

setOptionsToRemove

public void setOptionsToRemove(Collection<OptionSpecification> optionsToRemove)

A list of custom user-defined configuration options to remove from the configuration set for this environment.

Parameters:

optionsToRemove - A list of custom user-defined configuration options to remove from the configuration set for this environment.

withOptionsToRemove

public UpdateEnvironmentRequest withOptionsToRemove(OptionSpecification... optionsToRemove)

A list of custom user-defined configuration options to remove from the configuration set for this environment.

NOTE: This method appends the values to the existing list (if any). Use setOptionsToRemove(java.util.Collection) or withOptionsToRemove(java.util.Collection) if you want to override the existing values.

Returns a reference to this object so that method calls can be chained together.

Parameters:

optionsToRemove - A list of custom user-defined configuration options to remove from the configuration set for this environment.

Returns:

A reference to this updated object so that method calls can be chained together.

withOptionsToRemove

public UpdateEnvironmentRequest withOptionsToRemove(Collection<OptionSpecification> optionsToRemove)

A list of custom user-defined configuration options to remove from the configuration set for this environment.

Returns a reference to this object so that method calls can be chained together.

Parameters:

optionsToRemove - A list of custom user-defined configuration options to remove from the configuration set for this environment.

Returns:

A reference to this updated object so that method calls can be chained together.

toString

public String toString()

Returns a string representation of this object; useful for testing and debugging.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

clone

public UpdateEnvironmentRequest clone()

Description copied from class: AmazonWebServiceRequest

Creates a shallow clone of this request. Explicitly does not clone the deep structure of the request object.

Overrides:

clone in class AmazonWebServiceRequest

See Also:

Object.clone()