public class CreateImageRequest extends AmazonWebServiceRequest implements java.io.Serializable, DryRunSupportedRequest<CreateImageRequest>
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 .
Constructor and Description |
---|
CreateImageRequest()
Default constructor for a new CreateImageRequest object.
|
CreateImageRequest(java.lang.String instanceId,
java.lang.String name)
Constructs a new CreateImageRequest object.
|
Modifier and Type | Method and Description |
---|---|
boolean |
equals(java.lang.Object obj) |
java.util.List<BlockDeviceMapping> |
getBlockDeviceMappings()
Information about one or more block device mappings.
|
java.lang.String |
getDescription()
A description for the new image.
|
Request<CreateImageRequest> |
getDryRunRequest()
This method is intended for internal use only.
|
java.lang.String |
getInstanceId()
The ID of the instance.
|
java.lang.String |
getName()
A name for the new image.
|
java.lang.Boolean |
getNoReboot()
By default, Amazon EC2 attempts to shut down and reboot the instance
before creating the image.
|
int |
hashCode() |
java.lang.Boolean |
isNoReboot()
By default, Amazon EC2 attempts to shut down and reboot the instance
before creating the image.
|
void |
setBlockDeviceMappings(java.util.Collection<BlockDeviceMapping> blockDeviceMappings)
Information about one or more block device mappings.
|
void |
setDescription(java.lang.String description)
A description for the new image.
|
void |
setInstanceId(java.lang.String instanceId)
The ID of the instance.
|
void |
setName(java.lang.String name)
A name for the new image.
|
void |
setNoReboot(java.lang.Boolean noReboot)
By default, Amazon EC2 attempts to shut down and reboot the instance
before creating the image.
|
java.lang.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(java.util.Collection<BlockDeviceMapping> blockDeviceMappings)
Information about one or more block device mappings.
|
CreateImageRequest |
withDescription(java.lang.String description)
A description for the new image.
|
CreateImageRequest |
withInstanceId(java.lang.String instanceId)
The ID of the instance.
|
CreateImageRequest |
withName(java.lang.String name)
A name for the new image.
|
CreateImageRequest |
withNoReboot(java.lang.Boolean noReboot)
By default, Amazon EC2 attempts to shut down and reboot the instance
before creating the image.
|
clone, getCloneRoot, getCloneSource, getGeneralProgressListener, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector
public CreateImageRequest()
public CreateImageRequest(java.lang.String instanceId, java.lang.String name)
instanceId
- The ID of the instance.name
- A name for the new image. Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)
public java.lang.String getInstanceId()
public void setInstanceId(java.lang.String instanceId)
instanceId
- The ID of the instance.public CreateImageRequest withInstanceId(java.lang.String instanceId)
Returns a reference to this object so that method calls can be chained together.
instanceId
- The ID of the instance.public java.lang.String getName()
Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)
Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)
public void setName(java.lang.String name)
Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)
name
- A name for the new image. Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)
public CreateImageRequest withName(java.lang.String name)
Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)
Returns a reference to this object so that method calls can be chained together.
name
- A name for the new image. Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)
public java.lang.String getDescription()
public void setDescription(java.lang.String description)
description
- A description for the new image.public CreateImageRequest withDescription(java.lang.String description)
Returns a reference to this object so that method calls can be chained together.
description
- A description for the new image.public java.lang.Boolean isNoReboot()
public void setNoReboot(java.lang.Boolean noReboot)
noReboot
- By default, Amazon EC2 attempts to shut down and reboot the instance
before creating the image. If the 'No Reboot' option is set, 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.public CreateImageRequest withNoReboot(java.lang.Boolean noReboot)
Returns a reference to this object so that method calls can be chained together.
noReboot
- By default, Amazon EC2 attempts to shut down and reboot the instance
before creating the image. If the 'No Reboot' option is set, 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.public java.lang.Boolean getNoReboot()
public java.util.List<BlockDeviceMapping> getBlockDeviceMappings()
public void setBlockDeviceMappings(java.util.Collection<BlockDeviceMapping> blockDeviceMappings)
blockDeviceMappings
- Information about one or more block device mappings.public CreateImageRequest withBlockDeviceMappings(BlockDeviceMapping... blockDeviceMappings)
Returns a reference to this object so that method calls can be chained together.
blockDeviceMappings
- Information about one or more block device mappings.public CreateImageRequest withBlockDeviceMappings(java.util.Collection<BlockDeviceMapping> blockDeviceMappings)
Returns a reference to this object so that method calls can be chained together.
blockDeviceMappings
- Information about one or more block device mappings.public Request<CreateImageRequest> getDryRunRequest()
getDryRunRequest
in interface DryRunSupportedRequest<CreateImageRequest>
public java.lang.String toString()
toString
in class java.lang.Object
Object.toString()
public int hashCode()
hashCode
in class java.lang.Object
public boolean equals(java.lang.Object obj)
equals
in class java.lang.Object
Copyright © 2018 Amazon Web Services, Inc. All Rights Reserved.