com.amazonaws.services.ec2.model

Class CreateImageRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.ec2.model.CreateImageRequest

All Implemented Interfaces:

DryRunSupportedRequest<CreateImageRequest>, Serializable

public class CreateImageRequest
extends AmazonWebServiceRequest
implements Serializable, DryRunSupportedRequest<CreateImageRequest>

Container for the parameters to the CreateImage operation.

Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or stopped.

If you customized your instance with instance store volumes or EBS volumes in addition to the root device volume, the new AMI contains block device mapping information for those volumes. When you launch an instance from this new AMI, the instance automatically launches with those additional volumes.

For more information, see Creating Amazon EBS-Backed Linux AMIs in the Amazon Elastic Compute Cloud User Guide .

See Also:

AmazonEC2.createImage(CreateImageRequest), Serialized Form

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
CreateImageRequest() Default constructor for a new CreateImageRequest object.
CreateImageRequest(String instanceId, String name) Constructs a new CreateImageRequest object.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object obj)
List<BlockDeviceMapping>	getBlockDeviceMappings() Information about one or more block device mappings.
String	getDescription() A description for the new image.
Request<CreateImageRequest>	getDryRunRequest() This method is intended for internal use only.
String	getInstanceId() The ID of the instance.
String	getName() A name for the new image.
Boolean	getNoReboot() By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance.
int	hashCode()
Boolean	isNoReboot() By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance.
void	setBlockDeviceMappings(Collection<BlockDeviceMapping> blockDeviceMappings) Information about one or more block device mappings.
void	setDescription(String description) A description for the new image.
void	setInstanceId(String instanceId) The ID of the instance.
void	setName(String name) A name for the new image.
void	setNoReboot(Boolean noReboot) By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance.
String	toString() Returns a string representation of this object; useful for testing and debugging.
CreateImageRequest	withBlockDeviceMappings(BlockDeviceMapping... blockDeviceMappings) Information about one or more block device mappings.
CreateImageRequest	withBlockDeviceMappings(Collection<BlockDeviceMapping> blockDeviceMappings) Information about one or more block device mappings.
CreateImageRequest	withDescription(String description) A description for the new image.
CreateImageRequest	withInstanceId(String instanceId) The ID of the instance.
CreateImageRequest	withName(String name) A name for the new image.
CreateImageRequest	withNoReboot(Boolean noReboot) By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

copyPrivateRequestParameters, getGeneralProgressListener, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector

Methods inherited from class java.lang.Object

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

Constructor Detail

CreateImageRequest

public CreateImageRequest()

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

CreateImageRequest

public CreateImageRequest(String instanceId,
                  String name)

Constructs a new CreateImageRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.

Parameters:

instanceId - The ID of the instance.

name - A name for the new image.

Constraints: 3-128 alphanumeric characters, parenthesis (()), periods (.), slashes (/), dashes (-), or underscores(_)

Method Detail

getInstanceId

public String getInstanceId()

The ID of the instance.

Returns:

The ID of the instance.

setInstanceId

public void setInstanceId(String instanceId)

The ID of the instance.

Parameters:

instanceId - The ID of the instance.

withInstanceId

public CreateImageRequest withInstanceId(String instanceId)

The ID of the instance.

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

Parameters:

instanceId - The ID of the instance.

Returns:

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

getName

public String getName()

A name for the new image.

Constraints: 3-128 alphanumeric characters, parenthesis (()), periods (.), slashes (/), dashes (-), or underscores(_)

Returns:

A name for the new image.

Constraints: 3-128 alphanumeric characters, parenthesis (()), periods (.), slashes (/), dashes (-), or underscores(_)

setName

public void setName(String name)

A name for the new image.

Constraints: 3-128 alphanumeric characters, parenthesis (()), periods (.), slashes (/), dashes (-), or underscores(_)

Parameters:

name - A name for the new image.

Constraints: 3-128 alphanumeric characters, parenthesis (()), periods (.), slashes (/), dashes (-), or underscores(_)

withName

public CreateImageRequest withName(String name)

A name for the new image.

Constraints: 3-128 alphanumeric characters, parenthesis (()), periods (.), slashes (/), dashes (-), or underscores(_)

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

Parameters:

name - A name for the new image.

Constraints: 3-128 alphanumeric characters, parenthesis (()), periods (.), slashes (/), dashes (-), or underscores(_)

Returns:

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

getDescription

public String getDescription()

A description for the new image.

Returns:

A description for the new image.

setDescription

public void setDescription(String description)

A description for the new image.

Parameters:

description - A description for the new image.

withDescription

public CreateImageRequest withDescription(String description)

A description for the new image.

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

Parameters:

description - A description for the new image.

Returns:

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

isNoReboot

public Boolean isNoReboot()

By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. When the parameter is set to true, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

Returns:

By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. When the parameter is set to true, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

setNoReboot

public void setNoReboot(Boolean noReboot)

By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. When the parameter is set to true, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

Parameters:

noReboot - By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. When the parameter is set to true, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

withNoReboot

public CreateImageRequest withNoReboot(Boolean noReboot)

By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. When the parameter is set to true, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

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

Parameters:

noReboot - By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. When the parameter is set to true, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

Returns:

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

getNoReboot

public Boolean getNoReboot()

By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. When the parameter is set to true, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

Returns:

By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. When the parameter is set to true, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

getBlockDeviceMappings

public List<BlockDeviceMapping> getBlockDeviceMappings()

Information about one or more block device mappings.

Returns:

Information about one or more block device mappings.

setBlockDeviceMappings

public void setBlockDeviceMappings(Collection<BlockDeviceMapping> blockDeviceMappings)

Information about one or more block device mappings.

Parameters:

blockDeviceMappings - Information about one or more block device mappings.

withBlockDeviceMappings

public CreateImageRequest withBlockDeviceMappings(BlockDeviceMapping... blockDeviceMappings)

Information about one or more block device mappings.

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

Parameters:

blockDeviceMappings - Information about one or more block device mappings.

Returns:

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

withBlockDeviceMappings

public CreateImageRequest withBlockDeviceMappings(Collection<BlockDeviceMapping> blockDeviceMappings)

Information about one or more block device mappings.

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

Parameters:

blockDeviceMappings - Information about one or more block device mappings.

Returns:

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

getDryRunRequest

public Request<CreateImageRequest> getDryRunRequest()

This method is intended for internal use only. Returns the marshaled request configured with additional parameters to enable operation dry-run.

Specified by:

getDryRunRequest in interface DryRunSupportedRequest<CreateImageRequest>

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