|
|||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||
public interface AmazonEC2Async
Interface for accessing AmazonEC2 asynchronously. Each asynchronous method will return a Java Future object, and users are also allowed to provide a callback handler. Amazon EC2
Amazon Elastic Compute Cloud (Amazon EC2) is a web service that provides resizable compute capacity in the cloud. It is designed to make web-scale computing easier for developers.
Amazon EC2's simple web service interface allows you to obtain and configure capacity with minimal friction. It provides you with complete control of your computing resources and lets you run on Amazon's proven computing environment. Amazon EC2 reduces the time required to obtain and boot new server instances to minutes, allowing you to quickly scale capacity, both up and down, as your computing requirements change. Amazon EC2 changes the economics of computing by allowing you to pay only for capacity that you actually use. Amazon EC2 provides developers the tools to build failure resilient applications and isolate themselves from common failure scenarios.
Visit http://aws.amazon.com/ec2/ for more information.
| Method Detail |
|---|
Future<Void> rebootInstancesAsync(RebootInstancesRequest rebootInstancesRequest)
throws AmazonServiceException,
AmazonClientException
The RebootInstances operation requests a reboot of one or more instances. This operation is asynchronous; it only queues a request to reboot the specified instance(s). The operation will succeed if the instances are valid and belong to the user. Requests to reboot terminated instances are ignored.
rebootInstancesRequest - Container for the necessary parameters
to execute the RebootInstances operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> rebootInstancesAsync(RebootInstancesRequest rebootInstancesRequest,
AsyncHandler<RebootInstancesRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The RebootInstances operation requests a reboot of one or more instances. This operation is asynchronous; it only queues a request to reboot the specified instance(s). The operation will succeed if the instances are valid and belong to the user. Requests to reboot terminated instances are ignored.
rebootInstancesRequest - Container for the necessary parameters
to execute the RebootInstances operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeReservedInstancesResult> describeReservedInstancesAsync(DescribeReservedInstancesRequest describeReservedInstancesRequest)
throws AmazonServiceException,
AmazonClientException
The DescribeReservedInstances operation describes Reserved Instances that were purchased for use with your account.
describeReservedInstancesRequest - Container for the necessary
parameters to execute the DescribeReservedInstances operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeReservedInstancesResult> describeReservedInstancesAsync(DescribeReservedInstancesRequest describeReservedInstancesRequest,
AsyncHandler<DescribeReservedInstancesRequest,DescribeReservedInstancesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DescribeReservedInstances operation describes Reserved Instances that were purchased for use with your account.
describeReservedInstancesRequest - Container for the necessary
parameters to execute the DescribeReservedInstances operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeAvailabilityZonesResult> describeAvailabilityZonesAsync(DescribeAvailabilityZonesRequest describeAvailabilityZonesRequest)
throws AmazonServiceException,
AmazonClientException
The DescribeAvailabilityZones operation describes availability zones that are currently available to the account and their states.
Availability zones are not the same across accounts. The availability
zone us-east-1a for account A is not necessarily the same
as us-east-1a for account B. Zone assignments are mapped
independently for each account.
describeAvailabilityZonesRequest - Container for the necessary
parameters to execute the DescribeAvailabilityZones operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeAvailabilityZonesResult> describeAvailabilityZonesAsync(DescribeAvailabilityZonesRequest describeAvailabilityZonesRequest,
AsyncHandler<DescribeAvailabilityZonesRequest,DescribeAvailabilityZonesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DescribeAvailabilityZones operation describes availability zones that are currently available to the account and their states.
Availability zones are not the same across accounts. The availability
zone us-east-1a for account A is not necessarily the same
as us-east-1a for account B. Zone assignments are mapped
independently for each account.
describeAvailabilityZonesRequest - Container for the necessary
parameters to execute the DescribeAvailabilityZones operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DetachVolumeResult> detachVolumeAsync(DetachVolumeRequest detachVolumeRequest)
throws AmazonServiceException,
AmazonClientException
Detach a previously attached volume from a running instance.
detachVolumeRequest - Container for the necessary parameters to
execute the DetachVolume operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DetachVolumeResult> detachVolumeAsync(DetachVolumeRequest detachVolumeRequest,
AsyncHandler<DetachVolumeRequest,DetachVolumeResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Detach a previously attached volume from a running instance.
detachVolumeRequest - Container for the necessary parameters to
execute the DetachVolume operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deleteKeyPairAsync(DeleteKeyPairRequest deleteKeyPairRequest)
throws AmazonServiceException,
AmazonClientException
The DeleteKeyPair operation deletes a key pair.
deleteKeyPairRequest - Container for the necessary parameters to
execute the DeleteKeyPair operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deleteKeyPairAsync(DeleteKeyPairRequest deleteKeyPairRequest,
AsyncHandler<DeleteKeyPairRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DeleteKeyPair operation deletes a key pair.
deleteKeyPairRequest - Container for the necessary parameters to
execute the DeleteKeyPair operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<UnmonitorInstancesResult> unmonitorInstancesAsync(UnmonitorInstancesRequest unmonitorInstancesRequest)
throws AmazonServiceException,
AmazonClientException
Disables monitoring for a running instance.
unmonitorInstancesRequest - Container for the necessary
parameters to execute the UnmonitorInstances operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<UnmonitorInstancesResult> unmonitorInstancesAsync(UnmonitorInstancesRequest unmonitorInstancesRequest,
AsyncHandler<UnmonitorInstancesRequest,UnmonitorInstancesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Disables monitoring for a running instance.
unmonitorInstancesRequest - Container for the necessary
parameters to execute the UnmonitorInstances operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateImageResult> createImageAsync(CreateImageRequest createImageRequest)
throws AmazonServiceException,
AmazonClientException
Creates an Amazon EBS-backed AMI from a "running" or "stopped" instance. AMIs that use an Amazon EBS root device boot faster than AMIs that use instance stores. They can be up to 1 TiB in size, use storage that persists on instance failure, and can be stopped and started.
createImageRequest - Container for the necessary parameters to
execute the CreateImage operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateImageResult> createImageAsync(CreateImageRequest createImageRequest,
AsyncHandler<CreateImageRequest,CreateImageResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Creates an Amazon EBS-backed AMI from a "running" or "stopped" instance. AMIs that use an Amazon EBS root device boot faster than AMIs that use instance stores. They can be up to 1 TiB in size, use storage that persists on instance failure, and can be stopped and started.
createImageRequest - Container for the necessary parameters to
execute the CreateImage operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deleteSecurityGroupAsync(DeleteSecurityGroupRequest deleteSecurityGroupRequest)
throws AmazonServiceException,
AmazonClientException
The DeleteSecurityGroup operation deletes a security group.
NOTE: If you attempt to delete a security group that contains instances, a fault is returned. If you attempt to delete a security group that is referenced by another security group, a fault is returned. For example, if security group B has a rule that allows access from security group A, security group A cannot be deleted until the allow rule is removed.
deleteSecurityGroupRequest - Container for the necessary
parameters to execute the DeleteSecurityGroup operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deleteSecurityGroupAsync(DeleteSecurityGroupRequest deleteSecurityGroupRequest,
AsyncHandler<DeleteSecurityGroupRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DeleteSecurityGroup operation deletes a security group.
NOTE: If you attempt to delete a security group that contains instances, a fault is returned. If you attempt to delete a security group that is referenced by another security group, a fault is returned. For example, if security group B has a rule that allows access from security group A, security group A cannot be deleted until the allow rule is removed.
deleteSecurityGroupRequest - Container for the necessary
parameters to execute the DeleteSecurityGroup operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateInstanceExportTaskResult> createInstanceExportTaskAsync(CreateInstanceExportTaskRequest createInstanceExportTaskRequest)
throws AmazonServiceException,
AmazonClientException
createInstanceExportTaskRequest - Container for the necessary
parameters to execute the CreateInstanceExportTask operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateInstanceExportTaskResult> createInstanceExportTaskAsync(CreateInstanceExportTaskRequest createInstanceExportTaskRequest,
AsyncHandler<CreateInstanceExportTaskRequest,CreateInstanceExportTaskResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
createInstanceExportTaskRequest - Container for the necessary
parameters to execute the CreateInstanceExportTask operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<GetPasswordDataResult> getPasswordDataAsync(GetPasswordDataRequest getPasswordDataRequest)
throws AmazonServiceException,
AmazonClientException
Retrieves the encrypted administrator password for the instances running Windows.
NOTE: The Windows password is only generated the first time an AMI is launched. It is not generated for rebundled AMIs or after the password is changed on an instance. The password is encrypted using the key pair that you provided.
getPasswordDataRequest - Container for the necessary parameters
to execute the GetPasswordData operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<GetPasswordDataResult> getPasswordDataAsync(GetPasswordDataRequest getPasswordDataRequest,
AsyncHandler<GetPasswordDataRequest,GetPasswordDataResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Retrieves the encrypted administrator password for the instances running Windows.
NOTE: The Windows password is only generated the first time an AMI is launched. It is not generated for rebundled AMIs or after the password is changed on an instance. The password is encrypted using the key pair that you provided.
getPasswordDataRequest - Container for the necessary parameters
to execute the GetPasswordData operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<StopInstancesResult> stopInstancesAsync(StopInstancesRequest stopInstancesRequest)
throws AmazonServiceException,
AmazonClientException
Stops an instance that uses an Amazon EBS volume as its root device. Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time.
NOTE: Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM. Performing this operation on an instance that uses an instance store as its root device returns an error.
stopInstancesRequest - Container for the necessary parameters to
execute the StopInstances operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<StopInstancesResult> stopInstancesAsync(StopInstancesRequest stopInstancesRequest,
AsyncHandler<StopInstancesRequest,StopInstancesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Stops an instance that uses an Amazon EBS volume as its root device. Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time.
NOTE: Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM. Performing this operation on an instance that uses an instance store as its root device returns an error.
stopInstancesRequest - Container for the necessary parameters to
execute the StopInstances operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<ImportKeyPairResult> importKeyPairAsync(ImportKeyPairRequest importKeyPairRequest)
throws AmazonServiceException,
AmazonClientException
Imports the public key from an RSA key pair created with a third-party tool. This operation differs from CreateKeyPair as the private key is never transferred between the caller and AWS servers.
RSA key pairs are easily created on Microsoft Windows and Linux OS
systems using the ssh-keygen command line tool provided
with the standard OpenSSH installation. Standard library support for
RSA key pair creation is also available for Java, Ruby, Python, and
many other programming languages.
The following formats are supported:
importKeyPairRequest - Container for the necessary parameters to
execute the ImportKeyPair operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<ImportKeyPairResult> importKeyPairAsync(ImportKeyPairRequest importKeyPairRequest,
AsyncHandler<ImportKeyPairRequest,ImportKeyPairResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Imports the public key from an RSA key pair created with a third-party tool. This operation differs from CreateKeyPair as the private key is never transferred between the caller and AWS servers.
RSA key pairs are easily created on Microsoft Windows and Linux OS
systems using the ssh-keygen command line tool provided
with the standard OpenSSH installation. Standard library support for
RSA key pair creation is also available for Java, Ruby, Python, and
many other programming languages.
The following formats are supported:
importKeyPairRequest - Container for the necessary parameters to
execute the ImportKeyPair operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateSecurityGroupResult> createSecurityGroupAsync(CreateSecurityGroupRequest createSecurityGroupRequest)
throws AmazonServiceException,
AmazonClientException
The CreateSecurityGroup operation creates a new security group.
Every instance is launched in a security group. If no security group is specified during launch, the instances are launched in the default security group. Instances within the same security group have unrestricted network access to each other. Instances will reject network access attempts from other instances in a different security group. As the owner of instances you can grant or revoke specific permissions using the AuthorizeSecurityGroupIngress and RevokeSecurityGroupIngress operations.
createSecurityGroupRequest - Container for the necessary
parameters to execute the CreateSecurityGroup operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateSecurityGroupResult> createSecurityGroupAsync(CreateSecurityGroupRequest createSecurityGroupRequest,
AsyncHandler<CreateSecurityGroupRequest,CreateSecurityGroupResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The CreateSecurityGroup operation creates a new security group.
Every instance is launched in a security group. If no security group is specified during launch, the instances are launched in the default security group. Instances within the same security group have unrestricted network access to each other. Instances will reject network access attempts from other instances in a different security group. As the owner of instances you can grant or revoke specific permissions using the AuthorizeSecurityGroupIngress and RevokeSecurityGroupIngress operations.
createSecurityGroupRequest - Container for the necessary
parameters to execute the CreateSecurityGroup operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeSpotPriceHistoryResult> describeSpotPriceHistoryAsync(DescribeSpotPriceHistoryRequest describeSpotPriceHistoryRequest)
throws AmazonServiceException,
AmazonClientException
Describes the Spot Price history.
Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests.
For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
describeSpotPriceHistoryRequest - Container for the necessary
parameters to execute the DescribeSpotPriceHistory operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeSpotPriceHistoryResult> describeSpotPriceHistoryAsync(DescribeSpotPriceHistoryRequest describeSpotPriceHistoryRequest,
AsyncHandler<DescribeSpotPriceHistoryRequest,DescribeSpotPriceHistoryResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Describes the Spot Price history.
Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests.
For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
describeSpotPriceHistoryRequest - Container for the necessary
parameters to execute the DescribeSpotPriceHistory operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeRegionsResult> describeRegionsAsync(DescribeRegionsRequest describeRegionsRequest)
throws AmazonServiceException,
AmazonClientException
The DescribeRegions operation describes regions zones that are currently available to the account.
describeRegionsRequest - Container for the necessary parameters
to execute the DescribeRegions operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeRegionsResult> describeRegionsAsync(DescribeRegionsRequest describeRegionsRequest,
AsyncHandler<DescribeRegionsRequest,DescribeRegionsResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DescribeRegions operation describes regions zones that are currently available to the account.
describeRegionsRequest - Container for the necessary parameters
to execute the DescribeRegions operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateReservedInstancesListingResult> createReservedInstancesListingAsync(CreateReservedInstancesListingRequest createReservedInstancesListingRequest)
throws AmazonServiceException,
AmazonClientException
createReservedInstancesListingRequest - Container for the
necessary parameters to execute the CreateReservedInstancesListing
operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateReservedInstancesListingResult> createReservedInstancesListingAsync(CreateReservedInstancesListingRequest createReservedInstancesListingRequest,
AsyncHandler<CreateReservedInstancesListingRequest,CreateReservedInstancesListingResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
createReservedInstancesListingRequest - Container for the
necessary parameters to execute the CreateReservedInstancesListing
operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> resetSnapshotAttributeAsync(ResetSnapshotAttributeRequest resetSnapshotAttributeRequest)
throws AmazonServiceException,
AmazonClientException
Resets permission settings for the specified snapshot.
resetSnapshotAttributeRequest - Container for the necessary
parameters to execute the ResetSnapshotAttribute operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> resetSnapshotAttributeAsync(ResetSnapshotAttributeRequest resetSnapshotAttributeRequest,
AsyncHandler<ResetSnapshotAttributeRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Resets permission settings for the specified snapshot.
resetSnapshotAttributeRequest - Container for the necessary
parameters to execute the ResetSnapshotAttribute operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<ImportVolumeResult> importVolumeAsync(ImportVolumeRequest importVolumeRequest)
throws AmazonServiceException,
AmazonClientException
importVolumeRequest - Container for the necessary parameters to
execute the ImportVolume operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<ImportVolumeResult> importVolumeAsync(ImportVolumeRequest importVolumeRequest,
AsyncHandler<ImportVolumeRequest,ImportVolumeResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
importVolumeRequest - Container for the necessary parameters to
execute the ImportVolume operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeSecurityGroupsResult> describeSecurityGroupsAsync(DescribeSecurityGroupsRequest describeSecurityGroupsRequest)
throws AmazonServiceException,
AmazonClientException
The DescribeSecurityGroups operation returns information about security groups that you own.
If you specify security group names, information about those security group is returned. Otherwise, information for all security group is returned. If you specify a group that does not exist, a fault is returned.
describeSecurityGroupsRequest - Container for the necessary
parameters to execute the DescribeSecurityGroups operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeSecurityGroupsResult> describeSecurityGroupsAsync(DescribeSecurityGroupsRequest describeSecurityGroupsRequest,
AsyncHandler<DescribeSecurityGroupsRequest,DescribeSecurityGroupsResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DescribeSecurityGroups operation returns information about security groups that you own.
If you specify security group names, information about those security group is returned. Otherwise, information for all security group is returned. If you specify a group that does not exist, a fault is returned.
describeSecurityGroupsRequest - Container for the necessary
parameters to execute the DescribeSecurityGroups operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deregisterImageAsync(DeregisterImageRequest deregisterImageRequest)
throws AmazonServiceException,
AmazonClientException
The DeregisterImage operation deregisters an AMI. Once deregistered, instances of the AMI can no longer be launched.
deregisterImageRequest - Container for the necessary parameters
to execute the DeregisterImage operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deregisterImageAsync(DeregisterImageRequest deregisterImageRequest,
AsyncHandler<DeregisterImageRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DeregisterImage operation deregisters an AMI. Once deregistered, instances of the AMI can no longer be launched.
deregisterImageRequest - Container for the necessary parameters
to execute the DeregisterImage operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeSpotDatafeedSubscriptionResult> describeSpotDatafeedSubscriptionAsync(DescribeSpotDatafeedSubscriptionRequest describeSpotDatafeedSubscriptionRequest)
throws AmazonServiceException,
AmazonClientException
Describes the data feed for Spot Instances.
For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
describeSpotDatafeedSubscriptionRequest - Container for the
necessary parameters to execute the DescribeSpotDatafeedSubscription
operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeSpotDatafeedSubscriptionResult> describeSpotDatafeedSubscriptionAsync(DescribeSpotDatafeedSubscriptionRequest describeSpotDatafeedSubscriptionRequest,
AsyncHandler<DescribeSpotDatafeedSubscriptionRequest,DescribeSpotDatafeedSubscriptionResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Describes the data feed for Spot Instances.
For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
describeSpotDatafeedSubscriptionRequest - Container for the
necessary parameters to execute the DescribeSpotDatafeedSubscription
operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deleteTagsAsync(DeleteTagsRequest deleteTagsRequest)
throws AmazonServiceException,
AmazonClientException
Deletes tags from the specified Amazon EC2 resources.
deleteTagsRequest - Container for the necessary parameters to
execute the DeleteTags operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deleteTagsAsync(DeleteTagsRequest deleteTagsRequest,
AsyncHandler<DeleteTagsRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Deletes tags from the specified Amazon EC2 resources.
deleteTagsRequest - Container for the necessary parameters to
execute the DeleteTags operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> enableVolumeIOAsync(EnableVolumeIORequest enableVolumeIORequest)
throws AmazonServiceException,
AmazonClientException
Enable IO on the volume after an event has occured.
enableVolumeIORequest - Container for the necessary parameters to
execute the EnableVolumeIO operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> enableVolumeIOAsync(EnableVolumeIORequest enableVolumeIORequest,
AsyncHandler<EnableVolumeIORequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Enable IO on the volume after an event has occured.
enableVolumeIORequest - Container for the necessary parameters to
execute the EnableVolumeIO operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<AttachVolumeResult> attachVolumeAsync(AttachVolumeRequest attachVolumeRequest)
throws AmazonServiceException,
AmazonClientException
Attach a previously created volume to a running instance.
attachVolumeRequest - Container for the necessary parameters to
execute the AttachVolume operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<AttachVolumeResult> attachVolumeAsync(AttachVolumeRequest attachVolumeRequest,
AsyncHandler<AttachVolumeRequest,AttachVolumeResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Attach a previously created volume to a running instance.
attachVolumeRequest - Container for the necessary parameters to
execute the AttachVolume operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeLicensesResult> describeLicensesAsync(DescribeLicensesRequest describeLicensesRequest)
throws AmazonServiceException,
AmazonClientException
Provides details of a user's registered licenses. Zero or more IDs may be specified on the call. When one or more license IDs are specified, only data for the specified IDs are returned.
describeLicensesRequest - Container for the necessary parameters
to execute the DescribeLicenses operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeLicensesResult> describeLicensesAsync(DescribeLicensesRequest describeLicensesRequest,
AsyncHandler<DescribeLicensesRequest,DescribeLicensesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Provides details of a user's registered licenses. Zero or more IDs may be specified on the call. When one or more license IDs are specified, only data for the specified IDs are returned.
describeLicensesRequest - Container for the necessary parameters
to execute the DescribeLicenses operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeVolumeStatusResult> describeVolumeStatusAsync(DescribeVolumeStatusRequest describeVolumeStatusRequest)
throws AmazonServiceException,
AmazonClientException
Describes the status of a volume.
describeVolumeStatusRequest - Container for the necessary
parameters to execute the DescribeVolumeStatus operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeVolumeStatusResult> describeVolumeStatusAsync(DescribeVolumeStatusRequest describeVolumeStatusRequest,
AsyncHandler<DescribeVolumeStatusRequest,DescribeVolumeStatusResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Describes the status of a volume.
describeVolumeStatusRequest - Container for the necessary
parameters to execute the DescribeVolumeStatus operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> activateLicenseAsync(ActivateLicenseRequest activateLicenseRequest)
throws AmazonServiceException,
AmazonClientException
Activates a specific number of licenses for a 90-day period. Activations can be done against a specific license ID.
activateLicenseRequest - Container for the necessary parameters
to execute the ActivateLicense operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> activateLicenseAsync(ActivateLicenseRequest activateLicenseRequest,
AsyncHandler<ActivateLicenseRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Activates a specific number of licenses for a 90-day period. Activations can be done against a specific license ID.
activateLicenseRequest - Container for the necessary parameters
to execute the ActivateLicense operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> resetImageAttributeAsync(ResetImageAttributeRequest resetImageAttributeRequest)
throws AmazonServiceException,
AmazonClientException
The ResetImageAttribute operation resets an attribute of an AMI to its default value.
NOTE: The productCodes attribute cannot be reset.
resetImageAttributeRequest - Container for the necessary
parameters to execute the ResetImageAttribute operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> resetImageAttributeAsync(ResetImageAttributeRequest resetImageAttributeRequest,
AsyncHandler<ResetImageAttributeRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The ResetImageAttribute operation resets an attribute of an AMI to its default value.
NOTE: The productCodes attribute cannot be reset.
resetImageAttributeRequest - Container for the necessary
parameters to execute the ResetImageAttribute operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateSnapshotResult> createSnapshotAsync(CreateSnapshotRequest createSnapshotRequest)
throws AmazonServiceException,
AmazonClientException
Create a snapshot of the volume identified by volume ID. A volume does not have to be detached at the time the snapshot is taken.
NOTE: Snapshot creation requires that the system is in a consistent state. For instance, this means that if taking a snapshot of a database, the tables must be read-only locked to ensure that the snapshot will not contain a corrupted version of the database. Therefore, be careful when using this API to ensure that the system remains in the consistent state until the create snapshot status has returned.
createSnapshotRequest - Container for the necessary parameters to
execute the CreateSnapshot operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateSnapshotResult> createSnapshotAsync(CreateSnapshotRequest createSnapshotRequest,
AsyncHandler<CreateSnapshotRequest,CreateSnapshotResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Create a snapshot of the volume identified by volume ID. A volume does not have to be detached at the time the snapshot is taken.
NOTE: Snapshot creation requires that the system is in a consistent state. For instance, this means that if taking a snapshot of a database, the tables must be read-only locked to ensure that the snapshot will not contain a corrupted version of the database. Therefore, be careful when using this API to ensure that the system remains in the consistent state until the create snapshot status has returned.
createSnapshotRequest - Container for the necessary parameters to
execute the CreateSnapshot operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deleteVolumeAsync(DeleteVolumeRequest deleteVolumeRequest)
throws AmazonServiceException,
AmazonClientException
Deletes a previously created volume. Once successfully deleted, a new volume can be created with the same name.
deleteVolumeRequest - Container for the necessary parameters to
execute the DeleteVolume operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deleteVolumeAsync(DeleteVolumeRequest deleteVolumeRequest,
AsyncHandler<DeleteVolumeRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Deletes a previously created volume. Once successfully deleted, a new volume can be created with the same name.
deleteVolumeRequest - Container for the necessary parameters to
execute the DeleteVolume operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<AssociateAddressResult> associateAddressAsync(AssociateAddressRequest associateAddressRequest)
throws AmazonServiceException,
AmazonClientException
The AssociateAddress operation associates an elastic IP address with an instance.
If the IP address is currently assigned to another instance, the IP address is assigned to the new instance. This is an idempotent operation. If you enter it more than once, Amazon EC2 does not return an error.
associateAddressRequest - Container for the necessary parameters
to execute the AssociateAddress operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<AssociateAddressResult> associateAddressAsync(AssociateAddressRequest associateAddressRequest,
AsyncHandler<AssociateAddressRequest,AssociateAddressResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The AssociateAddress operation associates an elastic IP address with an instance.
If the IP address is currently assigned to another instance, the IP address is assigned to the new instance. This is an idempotent operation. If you enter it more than once, Amazon EC2 does not return an error.
associateAddressRequest - Container for the necessary parameters
to execute the AssociateAddress operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> cancelConversionTaskAsync(CancelConversionTaskRequest cancelConversionTaskRequest)
throws AmazonServiceException,
AmazonClientException
cancelConversionTaskRequest - Container for the necessary
parameters to execute the CancelConversionTask operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> cancelConversionTaskAsync(CancelConversionTaskRequest cancelConversionTaskRequest,
AsyncHandler<CancelConversionTaskRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
cancelConversionTaskRequest - Container for the necessary
parameters to execute the CancelConversionTask operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deactivateLicenseAsync(DeactivateLicenseRequest deactivateLicenseRequest)
throws AmazonServiceException,
AmazonClientException
Deactivates a specific number of licenses. Deactivations can be done against a specific license ID after they have persisted for at least a 90-day period.
deactivateLicenseRequest - Container for the necessary parameters
to execute the DeactivateLicense operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deactivateLicenseAsync(DeactivateLicenseRequest deactivateLicenseRequest,
AsyncHandler<DeactivateLicenseRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Deactivates a specific number of licenses. Deactivations can be done against a specific license ID after they have persisted for at least a 90-day period.
deactivateLicenseRequest - Container for the necessary parameters
to execute the DeactivateLicense operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeExportTasksResult> describeExportTasksAsync(DescribeExportTasksRequest describeExportTasksRequest)
throws AmazonServiceException,
AmazonClientException
describeExportTasksRequest - Container for the necessary
parameters to execute the DescribeExportTasks operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeExportTasksResult> describeExportTasksAsync(DescribeExportTasksRequest describeExportTasksRequest,
AsyncHandler<DescribeExportTasksRequest,DescribeExportTasksResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
describeExportTasksRequest - Container for the necessary
parameters to execute the DescribeExportTasks operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeVolumesResult> describeVolumesAsync(DescribeVolumesRequest describeVolumesRequest)
throws AmazonServiceException,
AmazonClientException
Describes the status of the indicated volume or, in lieu of any specified, all volumes belonging to the caller. Volumes that have been deleted are not described.
describeVolumesRequest - Container for the necessary parameters
to execute the DescribeVolumes operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeVolumesResult> describeVolumesAsync(DescribeVolumesRequest describeVolumesRequest,
AsyncHandler<DescribeVolumesRequest,DescribeVolumesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Describes the status of the indicated volume or, in lieu of any specified, all volumes belonging to the caller. Volumes that have been deleted are not described.
describeVolumesRequest - Container for the necessary parameters
to execute the DescribeVolumes operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeReservedInstancesListingsResult> describeReservedInstancesListingsAsync(DescribeReservedInstancesListingsRequest describeReservedInstancesListingsRequest)
throws AmazonServiceException,
AmazonClientException
describeReservedInstancesListingsRequest - Container for the
necessary parameters to execute the DescribeReservedInstancesListings
operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeReservedInstancesListingsResult> describeReservedInstancesListingsAsync(DescribeReservedInstancesListingsRequest describeReservedInstancesListingsRequest,
AsyncHandler<DescribeReservedInstancesListingsRequest,DescribeReservedInstancesListingsResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
describeReservedInstancesListingsRequest - Container for the
necessary parameters to execute the DescribeReservedInstancesListings
operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> reportInstanceStatusAsync(ReportInstanceStatusRequest reportInstanceStatusRequest)
throws AmazonServiceException,
AmazonClientException
reportInstanceStatusRequest - Container for the necessary
parameters to execute the ReportInstanceStatus operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> reportInstanceStatusAsync(ReportInstanceStatusRequest reportInstanceStatusRequest,
AsyncHandler<ReportInstanceStatusRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
reportInstanceStatusRequest - Container for the necessary
parameters to execute the ReportInstanceStatus operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<MonitorInstancesResult> monitorInstancesAsync(MonitorInstancesRequest monitorInstancesRequest)
throws AmazonServiceException,
AmazonClientException
Enables monitoring for a running instance.
monitorInstancesRequest - Container for the necessary parameters
to execute the MonitorInstances operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<MonitorInstancesResult> monitorInstancesAsync(MonitorInstancesRequest monitorInstancesRequest,
AsyncHandler<MonitorInstancesRequest,MonitorInstancesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Enables monitoring for a running instance.
monitorInstancesRequest - Container for the necessary parameters
to execute the MonitorInstances operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeBundleTasksResult> describeBundleTasksAsync(DescribeBundleTasksRequest describeBundleTasksRequest)
throws AmazonServiceException,
AmazonClientException
The DescribeBundleTasks operation describes in-progress and recent bundle tasks. Complete and failed tasks are removed from the list a short time after completion. If no bundle ids are given, all bundle tasks are returned.
describeBundleTasksRequest - Container for the necessary
parameters to execute the DescribeBundleTasks operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeBundleTasksResult> describeBundleTasksAsync(DescribeBundleTasksRequest describeBundleTasksRequest,
AsyncHandler<DescribeBundleTasksRequest,DescribeBundleTasksResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DescribeBundleTasks operation describes in-progress and recent bundle tasks. Complete and failed tasks are removed from the list a short time after completion. If no bundle ids are given, all bundle tasks are returned.
describeBundleTasksRequest - Container for the necessary
parameters to execute the DescribeBundleTasks operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<ImportInstanceResult> importInstanceAsync(ImportInstanceRequest importInstanceRequest)
throws AmazonServiceException,
AmazonClientException
importInstanceRequest - Container for the necessary parameters to
execute the ImportInstance operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<ImportInstanceResult> importInstanceAsync(ImportInstanceRequest importInstanceRequest,
AsyncHandler<ImportInstanceRequest,ImportInstanceResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
importInstanceRequest - Container for the necessary parameters to
execute the ImportInstance operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> revokeSecurityGroupIngressAsync(RevokeSecurityGroupIngressRequest revokeSecurityGroupIngressRequest)
throws AmazonServiceException,
AmazonClientException
The RevokeSecurityGroupIngress operation revokes permissions from a security group. The permissions used to revoke must be specified using the same values used to grant the permissions.
Permissions are specified by IP protocol (TCP, UDP, or ICMP), the source of the request (by IP range or an Amazon EC2 user-group pair), the source and destination port ranges (for TCP and UDP), and the ICMP codes and types (for ICMP).
Permission changes are quickly propagated to instances within the security group. However, depending on the number of instances in the group, a small delay might occur.
revokeSecurityGroupIngressRequest - Container for the necessary
parameters to execute the RevokeSecurityGroupIngress operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> revokeSecurityGroupIngressAsync(RevokeSecurityGroupIngressRequest revokeSecurityGroupIngressRequest,
AsyncHandler<RevokeSecurityGroupIngressRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The RevokeSecurityGroupIngress operation revokes permissions from a security group. The permissions used to revoke must be specified using the same values used to grant the permissions.
Permissions are specified by IP protocol (TCP, UDP, or ICMP), the source of the request (by IP range or an Amazon EC2 user-group pair), the source and destination port ranges (for TCP and UDP), and the ICMP codes and types (for ICMP).
Permission changes are quickly propagated to instances within the security group. However, depending on the number of instances in the group, a small delay might occur.
revokeSecurityGroupIngressRequest - Container for the necessary
parameters to execute the RevokeSecurityGroupIngress operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<GetConsoleOutputResult> getConsoleOutputAsync(GetConsoleOutputRequest getConsoleOutputRequest)
throws AmazonServiceException,
AmazonClientException
The GetConsoleOutput operation retrieves console output for the specified instance.
Instance console output is buffered and posted shortly after instance boot, reboot, and termination. Amazon EC2 preserves the most recent 64 KB output which will be available for at least one hour after the most recent post.
getConsoleOutputRequest - Container for the necessary parameters
to execute the GetConsoleOutput operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<GetConsoleOutputResult> getConsoleOutputAsync(GetConsoleOutputRequest getConsoleOutputRequest,
AsyncHandler<GetConsoleOutputRequest,GetConsoleOutputResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The GetConsoleOutput operation retrieves console output for the specified instance.
Instance console output is buffered and posted shortly after instance boot, reboot, and termination. Amazon EC2 preserves the most recent 64 KB output which will be available for at least one hour after the most recent post.
getConsoleOutputRequest - Container for the necessary parameters
to execute the GetConsoleOutput operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> modifyImageAttributeAsync(ModifyImageAttributeRequest modifyImageAttributeRequest)
throws AmazonServiceException,
AmazonClientException
The ModifyImageAttribute operation modifies an attribute of an AMI.
modifyImageAttributeRequest - Container for the necessary
parameters to execute the ModifyImageAttribute operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> modifyImageAttributeAsync(ModifyImageAttributeRequest modifyImageAttributeRequest,
AsyncHandler<ModifyImageAttributeRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The ModifyImageAttribute operation modifies an attribute of an AMI.
modifyImageAttributeRequest - Container for the necessary
parameters to execute the ModifyImageAttribute operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateSpotDatafeedSubscriptionResult> createSpotDatafeedSubscriptionAsync(CreateSpotDatafeedSubscriptionRequest createSpotDatafeedSubscriptionRequest)
throws AmazonServiceException,
AmazonClientException
Creates the data feed for Spot Instances, enabling you to view Spot Instance usage logs. You can create one data feed per account.
For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
createSpotDatafeedSubscriptionRequest - Container for the
necessary parameters to execute the CreateSpotDatafeedSubscription
operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateSpotDatafeedSubscriptionResult> createSpotDatafeedSubscriptionAsync(CreateSpotDatafeedSubscriptionRequest createSpotDatafeedSubscriptionRequest,
AsyncHandler<CreateSpotDatafeedSubscriptionRequest,CreateSpotDatafeedSubscriptionResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Creates the data feed for Spot Instances, enabling you to view Spot Instance usage logs. You can create one data feed per account.
For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
createSpotDatafeedSubscriptionRequest - Container for the
necessary parameters to execute the CreateSpotDatafeedSubscription
operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeConversionTasksResult> describeConversionTasksAsync(DescribeConversionTasksRequest describeConversionTasksRequest)
throws AmazonServiceException,
AmazonClientException
describeConversionTasksRequest - Container for the necessary
parameters to execute the DescribeConversionTasks operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeConversionTasksResult> describeConversionTasksAsync(DescribeConversionTasksRequest describeConversionTasksRequest,
AsyncHandler<DescribeConversionTasksRequest,DescribeConversionTasksResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
describeConversionTasksRequest - Container for the necessary
parameters to execute the DescribeConversionTasks operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeInstanceAttributeResult> describeInstanceAttributeAsync(DescribeInstanceAttributeRequest describeInstanceAttributeRequest)
throws AmazonServiceException,
AmazonClientException
Returns information about an attribute of an instance. Only one attribute can be specified per call.
describeInstanceAttributeRequest - Container for the necessary
parameters to execute the DescribeInstanceAttribute operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeInstanceAttributeResult> describeInstanceAttributeAsync(DescribeInstanceAttributeRequest describeInstanceAttributeRequest,
AsyncHandler<DescribeInstanceAttributeRequest,DescribeInstanceAttributeResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Returns information about an attribute of an instance. Only one attribute can be specified per call.
describeInstanceAttributeRequest - Container for the necessary
parameters to execute the DescribeInstanceAttribute operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<RunInstancesResult> runInstancesAsync(RunInstancesRequest runInstancesRequest)
throws AmazonServiceException,
AmazonClientException
The RunInstances operation launches a specified number of instances.
If Amazon EC2 cannot launch the minimum number AMIs you request, no instances launch. If there is insufficient capacity to launch the maximum number of AMIs you request, Amazon EC2 launches as many as possible to satisfy the requested maximum values.
Every instance is launched in a security group. If you do not specify a security group at launch, the instances start in your default security group. For more information on creating security groups, see CreateSecurityGroup.
An optional instance type can be specified. For information about instance types, see Instance Types.
You can provide an optional key pair ID for each image in the launch request (for more information, see CreateKeyPair). All instances that are created from images that use this key pair will have access to the associated public key at boot. You can use this key to provide secure access to an instance of an image on a per-instance basis. Amazon EC2 public images use this feature to provide secure access without passwords.
IMPORTANT: Launching public images without a key pair ID will leave them inaccessible. The public key material is made available to the instance at boot time by placing it in the openssh_id.pub file on a logical device that is exposed to the instance as /dev/sda2 (the ephemeral store). The format of this file is suitable for use as an entry within ~/.ssh/authorized_keys (the OpenSSH format). This can be done at boot (e.g., as part of rc.local) allowing for secure access without passwords. Optional user data can be provided in the launch request. All instances that collectively comprise the launch request have access to this data For more information, see Instance Metadata.
NOTE: If any of the AMIs have a product code attached for which the user has not subscribed, the RunInstances call will fail.
IMPORTANT: We strongly recommend using the 2.6.18 Xen stock kernel with the c1.medium and c1.xlarge instances. Although the default Amazon EC2 kernels will work, the new kernels provide greater stability and performance for these instance types. For more information about kernels, see Kernels, RAM Disks, and Block Device Mappings.
runInstancesRequest - Container for the necessary parameters to
execute the RunInstances operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<RunInstancesResult> runInstancesAsync(RunInstancesRequest runInstancesRequest,
AsyncHandler<RunInstancesRequest,RunInstancesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The RunInstances operation launches a specified number of instances.
If Amazon EC2 cannot launch the minimum number AMIs you request, no instances launch. If there is insufficient capacity to launch the maximum number of AMIs you request, Amazon EC2 launches as many as possible to satisfy the requested maximum values.
Every instance is launched in a security group. If you do not specify a security group at launch, the instances start in your default security group. For more information on creating security groups, see CreateSecurityGroup.
An optional instance type can be specified. For information about instance types, see Instance Types.
You can provide an optional key pair ID for each image in the launch request (for more information, see CreateKeyPair). All instances that are created from images that use this key pair will have access to the associated public key at boot. You can use this key to provide secure access to an instance of an image on a per-instance basis. Amazon EC2 public images use this feature to provide secure access without passwords.
IMPORTANT: Launching public images without a key pair ID will leave them inaccessible. The public key material is made available to the instance at boot time by placing it in the openssh_id.pub file on a logical device that is exposed to the instance as /dev/sda2 (the ephemeral store). The format of this file is suitable for use as an entry within ~/.ssh/authorized_keys (the OpenSSH format). This can be done at boot (e.g., as part of rc.local) allowing for secure access without passwords. Optional user data can be provided in the launch request. All instances that collectively comprise the launch request have access to this data For more information, see Instance Metadata.
NOTE: If any of the AMIs have a product code attached for which the user has not subscribed, the RunInstances call will fail.
IMPORTANT: We strongly recommend using the 2.6.18 Xen stock kernel with the c1.medium and c1.xlarge instances. Although the default Amazon EC2 kernels will work, the new kernels provide greater stability and performance for these instance types. For more information about kernels, see Kernels, RAM Disks, and Block Device Mappings.
runInstancesRequest - Container for the necessary parameters to
execute the RunInstances operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribePlacementGroupsResult> describePlacementGroupsAsync(DescribePlacementGroupsRequest describePlacementGroupsRequest)
throws AmazonServiceException,
AmazonClientException
Returns information about one or more PlacementGroup instances in a user's account.
describePlacementGroupsRequest - Container for the necessary
parameters to execute the DescribePlacementGroups operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribePlacementGroupsResult> describePlacementGroupsAsync(DescribePlacementGroupsRequest describePlacementGroupsRequest,
AsyncHandler<DescribePlacementGroupsRequest,DescribePlacementGroupsResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Returns information about one or more PlacementGroup instances in a user's account.
describePlacementGroupsRequest - Container for the necessary
parameters to execute the DescribePlacementGroups operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeInstancesResult> describeInstancesAsync(DescribeInstancesRequest describeInstancesRequest)
throws AmazonServiceException,
AmazonClientException
The DescribeInstances operation returns information about instances that you own.
If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If you do not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specify an invalid instance ID, a fault is returned. If you specify an instance that you do not own, it will not be included in the returned results.
Recently terminated instances might appear in the returned results. This interval is usually less than one hour.
describeInstancesRequest - Container for the necessary parameters
to execute the DescribeInstances operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeInstancesResult> describeInstancesAsync(DescribeInstancesRequest describeInstancesRequest,
AsyncHandler<DescribeInstancesRequest,DescribeInstancesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DescribeInstances operation returns information about instances that you own.
If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If you do not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specify an invalid instance ID, a fault is returned. If you specify an instance that you do not own, it will not be included in the returned results.
Recently terminated instances might appear in the returned results. This interval is usually less than one hour.
describeInstancesRequest - Container for the necessary parameters
to execute the DescribeInstances operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> modifyVolumeAttributeAsync(ModifyVolumeAttributeRequest modifyVolumeAttributeRequest)
throws AmazonServiceException,
AmazonClientException
modifyVolumeAttributeRequest - Container for the necessary
parameters to execute the ModifyVolumeAttribute operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> modifyVolumeAttributeAsync(ModifyVolumeAttributeRequest modifyVolumeAttributeRequest,
AsyncHandler<ModifyVolumeAttributeRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
modifyVolumeAttributeRequest - Container for the necessary
parameters to execute the ModifyVolumeAttribute operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeImagesResult> describeImagesAsync(DescribeImagesRequest describeImagesRequest)
throws AmazonServiceException,
AmazonClientException
The DescribeImages operation returns information about AMIs, AKIs, and ARIs available to the user. Information returned includes image type, product codes, architecture, and kernel and RAM disk IDs. Images available to the user include public images available for any user to launch, private images owned by the user making the request, and private images owned by other users for which the user has explicit launch permissions.
Launch permissions fall into three categories:
The list of AMIs returned can be modified by specifying AMI IDs, AMI owners, or users with launch permissions. If no options are specified, Amazon EC2 returns all AMIs for which the user has launch permissions.
If you specify one or more AMI IDs, only AMIs that have the specified IDs are returned. If you specify an invalid AMI ID, a fault is returned. If you specify an AMI ID for which you do not have access, it will not be included in the returned results.
If you specify one or more AMI owners, only AMIs from the specified owners and for which you have access are returned. The results can include the account IDs of the specified owners, amazon for AMIs owned by Amazon or self for AMIs that you own.
If you specify a list of executable users, only users that have launch permissions for the AMIs are returned. You can specify account IDs (if you own the AMI(s)), self for AMIs for which you own or have explicit permissions, or all for public AMIs.
NOTE: Deregistered images are included in the returned results for an unspecified interval after deregistration.
describeImagesRequest - Container for the necessary parameters to
execute the DescribeImages operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeImagesResult> describeImagesAsync(DescribeImagesRequest describeImagesRequest,
AsyncHandler<DescribeImagesRequest,DescribeImagesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DescribeImages operation returns information about AMIs, AKIs, and ARIs available to the user. Information returned includes image type, product codes, architecture, and kernel and RAM disk IDs. Images available to the user include public images available for any user to launch, private images owned by the user making the request, and private images owned by other users for which the user has explicit launch permissions.
Launch permissions fall into three categories:
The list of AMIs returned can be modified by specifying AMI IDs, AMI owners, or users with launch permissions. If no options are specified, Amazon EC2 returns all AMIs for which the user has launch permissions.
If you specify one or more AMI IDs, only AMIs that have the specified IDs are returned. If you specify an invalid AMI ID, a fault is returned. If you specify an AMI ID for which you do not have access, it will not be included in the returned results.
If you specify one or more AMI owners, only AMIs from the specified owners and for which you have access are returned. The results can include the account IDs of the specified owners, amazon for AMIs owned by Amazon or self for AMIs that you own.
If you specify a list of executable users, only users that have launch permissions for the AMIs are returned. You can specify account IDs (if you own the AMI(s)), self for AMIs for which you own or have explicit permissions, or all for public AMIs.
NOTE: Deregistered images are included in the returned results for an unspecified interval after deregistration.
describeImagesRequest - Container for the necessary parameters to
execute the DescribeImages operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<StartInstancesResult> startInstancesAsync(StartInstancesRequest startInstancesRequest)
throws AmazonServiceException,
AmazonClientException
Starts an instance that uses an Amazon EBS volume as its root device. Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time.
NOTE: Performing this operation on an instance that uses an instance store as its root device returns an error.
startInstancesRequest - Container for the necessary parameters to
execute the StartInstances operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<StartInstancesResult> startInstancesAsync(StartInstancesRequest startInstancesRequest,
AsyncHandler<StartInstancesRequest,StartInstancesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Starts an instance that uses an Amazon EBS volume as its root device. Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time.
NOTE: Performing this operation on an instance that uses an instance store as its root device returns an error.
startInstancesRequest - Container for the necessary parameters to
execute the StartInstances operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CancelReservedInstancesListingResult> cancelReservedInstancesListingAsync(CancelReservedInstancesListingRequest cancelReservedInstancesListingRequest)
throws AmazonServiceException,
AmazonClientException
cancelReservedInstancesListingRequest - Container for the
necessary parameters to execute the CancelReservedInstancesListing
operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CancelReservedInstancesListingResult> cancelReservedInstancesListingAsync(CancelReservedInstancesListingRequest cancelReservedInstancesListingRequest,
AsyncHandler<CancelReservedInstancesListingRequest,CancelReservedInstancesListingResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
cancelReservedInstancesListingRequest - Container for the
necessary parameters to execute the CancelReservedInstancesListing
operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> modifyInstanceAttributeAsync(ModifyInstanceAttributeRequest modifyInstanceAttributeRequest)
throws AmazonServiceException,
AmazonClientException
Modifies an attribute of an instance.
modifyInstanceAttributeRequest - Container for the necessary
parameters to execute the ModifyInstanceAttribute operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> modifyInstanceAttributeAsync(ModifyInstanceAttributeRequest modifyInstanceAttributeRequest,
AsyncHandler<ModifyInstanceAttributeRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Modifies an attribute of an instance.
modifyInstanceAttributeRequest - Container for the necessary
parameters to execute the ModifyInstanceAttribute operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> authorizeSecurityGroupIngressAsync(AuthorizeSecurityGroupIngressRequest authorizeSecurityGroupIngressRequest)
throws AmazonServiceException,
AmazonClientException
The AuthorizeSecurityGroupIngress operation adds permissions to a security group.
Permissions are specified by the IP protocol (TCP, UDP or ICMP), the
source of the request (by IP range or an Amazon EC2 user-group pair),
the source and destination port ranges (for TCP and UDP), and the ICMP
codes and types (for ICMP). When authorizing ICMP, -1 can
be used as a wildcard in the type and code fields.
Permission changes are propagated to instances within the security group as quickly as possible. However, depending on the number of instances, a small delay might occur.
authorizeSecurityGroupIngressRequest - Container for the
necessary parameters to execute the AuthorizeSecurityGroupIngress
operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> authorizeSecurityGroupIngressAsync(AuthorizeSecurityGroupIngressRequest authorizeSecurityGroupIngressRequest,
AsyncHandler<AuthorizeSecurityGroupIngressRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The AuthorizeSecurityGroupIngress operation adds permissions to a security group.
Permissions are specified by the IP protocol (TCP, UDP or ICMP), the
source of the request (by IP range or an Amazon EC2 user-group pair),
the source and destination port ranges (for TCP and UDP), and the ICMP
codes and types (for ICMP). When authorizing ICMP, -1 can
be used as a wildcard in the type and code fields.
Permission changes are propagated to instances within the security group as quickly as possible. However, depending on the number of instances, a small delay might occur.
authorizeSecurityGroupIngressRequest - Container for the
necessary parameters to execute the AuthorizeSecurityGroupIngress
operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeSpotInstanceRequestsResult> describeSpotInstanceRequestsAsync(DescribeSpotInstanceRequestsRequest describeSpotInstanceRequestsRequest)
throws AmazonServiceException,
AmazonClientException
Describes Spot Instance requests. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests. For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
You can filter the results to return information only about Spot
Instance requests that match criteria you specify. For example, you
could get information about requests where the Spot Price you
specified is a certain value (you can't use greater than or less than
comparison, but you can use * and ?
wildcards). You can specify multiple values for a filter. A Spot
Instance request must match at least one of the specified values for
it to be included in the results.
You can specify multiple filters (e.g., the Spot Price is equal to a
particular value, and the instance type is m1.small ).
The result includes information for a particular request only if it
matches all your filters. If there's no match, no special message is
returned; the response is simply empty.
You can use wildcards with the filter values: an asterisk matches
zero or more characters, and ? matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\ .
describeSpotInstanceRequestsRequest - Container for the necessary
parameters to execute the DescribeSpotInstanceRequests operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeSpotInstanceRequestsResult> describeSpotInstanceRequestsAsync(DescribeSpotInstanceRequestsRequest describeSpotInstanceRequestsRequest,
AsyncHandler<DescribeSpotInstanceRequestsRequest,DescribeSpotInstanceRequestsResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Describes Spot Instance requests. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests. For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
You can filter the results to return information only about Spot
Instance requests that match criteria you specify. For example, you
could get information about requests where the Spot Price you
specified is a certain value (you can't use greater than or less than
comparison, but you can use * and ?
wildcards). You can specify multiple values for a filter. A Spot
Instance request must match at least one of the specified values for
it to be included in the results.
You can specify multiple filters (e.g., the Spot Price is equal to a
particular value, and the instance type is m1.small ).
The result includes information for a particular request only if it
matches all your filters. If there's no match, no special message is
returned; the response is simply empty.
You can use wildcards with the filter values: an asterisk matches
zero or more characters, and ? matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\ .
describeSpotInstanceRequestsRequest - Container for the necessary
parameters to execute the DescribeSpotInstanceRequests operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> cancelExportTaskAsync(CancelExportTaskRequest cancelExportTaskRequest)
throws AmazonServiceException,
AmazonClientException
cancelExportTaskRequest - Container for the necessary parameters
to execute the CancelExportTask operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> cancelExportTaskAsync(CancelExportTaskRequest cancelExportTaskRequest,
AsyncHandler<CancelExportTaskRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
cancelExportTaskRequest - Container for the necessary parameters
to execute the CancelExportTask operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<RequestSpotInstancesResult> requestSpotInstancesAsync(RequestSpotInstancesRequest requestSpotInstancesRequest)
throws AmazonServiceException,
AmazonClientException
Creates a Spot Instance request.
Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests.
For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide.
requestSpotInstancesRequest - Container for the necessary
parameters to execute the RequestSpotInstances operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<RequestSpotInstancesResult> requestSpotInstancesAsync(RequestSpotInstancesRequest requestSpotInstancesRequest,
AsyncHandler<RequestSpotInstancesRequest,RequestSpotInstancesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Creates a Spot Instance request.
Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests.
For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide.
requestSpotInstancesRequest - Container for the necessary
parameters to execute the RequestSpotInstances operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> createTagsAsync(CreateTagsRequest createTagsRequest)
throws AmazonServiceException,
AmazonClientException
Adds or overwrites tags for the specified resources. Each resource can have a maximum of 10 tags. Each tag consists of a key-value pair. Tag keys must be unique per resource.
createTagsRequest - Container for the necessary parameters to
execute the CreateTags operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> createTagsAsync(CreateTagsRequest createTagsRequest,
AsyncHandler<CreateTagsRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Adds or overwrites tags for the specified resources. Each resource can have a maximum of 10 tags. Each tag consists of a key-value pair. Tag keys must be unique per resource.
createTagsRequest - Container for the necessary parameters to
execute the CreateTags operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeVolumeAttributeResult> describeVolumeAttributeAsync(DescribeVolumeAttributeRequest describeVolumeAttributeRequest)
throws AmazonServiceException,
AmazonClientException
describeVolumeAttributeRequest - Container for the necessary
parameters to execute the DescribeVolumeAttribute operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeVolumeAttributeResult> describeVolumeAttributeAsync(DescribeVolumeAttributeRequest describeVolumeAttributeRequest,
AsyncHandler<DescribeVolumeAttributeRequest,DescribeVolumeAttributeResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
describeVolumeAttributeRequest - Container for the necessary
parameters to execute the DescribeVolumeAttribute operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeTagsResult> describeTagsAsync(DescribeTagsRequest describeTagsRequest)
throws AmazonServiceException,
AmazonClientException
Describes the tags for the specified resources.
describeTagsRequest - Container for the necessary parameters to
execute the DescribeTags operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeTagsResult> describeTagsAsync(DescribeTagsRequest describeTagsRequest,
AsyncHandler<DescribeTagsRequest,DescribeTagsResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Describes the tags for the specified resources.
describeTagsRequest - Container for the necessary parameters to
execute the DescribeTags operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CancelBundleTaskResult> cancelBundleTaskAsync(CancelBundleTaskRequest cancelBundleTaskRequest)
throws AmazonServiceException,
AmazonClientException
CancelBundleTask operation cancels a pending or in-progress bundling task. This is an asynchronous call and it make take a while for the task to be canceled. If a task is canceled while it is storing items, there may be parts of the incomplete AMI stored in S3. It is up to the caller to clean up these parts from S3.
cancelBundleTaskRequest - Container for the necessary parameters
to execute the CancelBundleTask operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CancelBundleTaskResult> cancelBundleTaskAsync(CancelBundleTaskRequest cancelBundleTaskRequest,
AsyncHandler<CancelBundleTaskRequest,CancelBundleTaskResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
CancelBundleTask operation cancels a pending or in-progress bundling task. This is an asynchronous call and it make take a while for the task to be canceled. If a task is canceled while it is storing items, there may be parts of the incomplete AMI stored in S3. It is up to the caller to clean up these parts from S3.
cancelBundleTaskRequest - Container for the necessary parameters
to execute the CancelBundleTask operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CancelSpotInstanceRequestsResult> cancelSpotInstanceRequestsAsync(CancelSpotInstanceRequestsRequest cancelSpotInstanceRequestsRequest)
throws AmazonServiceException,
AmazonClientException
Cancels one or more Spot Instance requests.
Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests.
For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
cancelSpotInstanceRequestsRequest - Container for the necessary
parameters to execute the CancelSpotInstanceRequests operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CancelSpotInstanceRequestsResult> cancelSpotInstanceRequestsAsync(CancelSpotInstanceRequestsRequest cancelSpotInstanceRequestsRequest,
AsyncHandler<CancelSpotInstanceRequestsRequest,CancelSpotInstanceRequestsResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Cancels one or more Spot Instance requests.
Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests.
For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
cancelSpotInstanceRequestsRequest - Container for the necessary
parameters to execute the CancelSpotInstanceRequests operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<PurchaseReservedInstancesOfferingResult> purchaseReservedInstancesOfferingAsync(PurchaseReservedInstancesOfferingRequest purchaseReservedInstancesOfferingRequest)
throws AmazonServiceException,
AmazonClientException
The PurchaseReservedInstancesOffering operation purchases a Reserved Instance for use with your account. With Amazon EC2 Reserved Instances, you purchase the right to launch Amazon EC2 instances for a period of time (without getting insufficient capacity errors) and pay a lower usage rate for the actual time used.
purchaseReservedInstancesOfferingRequest - Container for the
necessary parameters to execute the PurchaseReservedInstancesOffering
operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<PurchaseReservedInstancesOfferingResult> purchaseReservedInstancesOfferingAsync(PurchaseReservedInstancesOfferingRequest purchaseReservedInstancesOfferingRequest,
AsyncHandler<PurchaseReservedInstancesOfferingRequest,PurchaseReservedInstancesOfferingResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The PurchaseReservedInstancesOffering operation purchases a Reserved Instance for use with your account. With Amazon EC2 Reserved Instances, you purchase the right to launch Amazon EC2 instances for a period of time (without getting insufficient capacity errors) and pay a lower usage rate for the actual time used.
purchaseReservedInstancesOfferingRequest - Container for the
necessary parameters to execute the PurchaseReservedInstancesOffering
operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> modifySnapshotAttributeAsync(ModifySnapshotAttributeRequest modifySnapshotAttributeRequest)
throws AmazonServiceException,
AmazonClientException
Adds or remove permission settings for the specified snapshot.
modifySnapshotAttributeRequest - Container for the necessary
parameters to execute the ModifySnapshotAttribute operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> modifySnapshotAttributeAsync(ModifySnapshotAttributeRequest modifySnapshotAttributeRequest,
AsyncHandler<ModifySnapshotAttributeRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Adds or remove permission settings for the specified snapshot.
modifySnapshotAttributeRequest - Container for the necessary
parameters to execute the ModifySnapshotAttribute operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<TerminateInstancesResult> terminateInstancesAsync(TerminateInstancesRequest terminateInstancesRequest)
throws AmazonServiceException,
AmazonClientException
The TerminateInstances operation shuts down one or more instances. This operation is idempotent; if you terminate an instance more than once, each call will succeed.
Terminated instances will remain visible after termination (approximately one hour).
terminateInstancesRequest - Container for the necessary
parameters to execute the TerminateInstances operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<TerminateInstancesResult> terminateInstancesAsync(TerminateInstancesRequest terminateInstancesRequest,
AsyncHandler<TerminateInstancesRequest,TerminateInstancesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The TerminateInstances operation shuts down one or more instances. This operation is idempotent; if you terminate an instance more than once, each call will succeed.
Terminated instances will remain visible after termination (approximately one hour).
terminateInstancesRequest - Container for the necessary
parameters to execute the TerminateInstances operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deleteSpotDatafeedSubscriptionAsync(DeleteSpotDatafeedSubscriptionRequest deleteSpotDatafeedSubscriptionRequest)
throws AmazonServiceException,
AmazonClientException
Deletes the data feed for Spot Instances.
For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
deleteSpotDatafeedSubscriptionRequest - Container for the
necessary parameters to execute the DeleteSpotDatafeedSubscription
operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deleteSpotDatafeedSubscriptionAsync(DeleteSpotDatafeedSubscriptionRequest deleteSpotDatafeedSubscriptionRequest,
AsyncHandler<DeleteSpotDatafeedSubscriptionRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Deletes the data feed for Spot Instances.
For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
deleteSpotDatafeedSubscriptionRequest - Container for the
necessary parameters to execute the DeleteSpotDatafeedSubscription
operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeSnapshotAttributeResult> describeSnapshotAttributeAsync(DescribeSnapshotAttributeRequest describeSnapshotAttributeRequest)
throws AmazonServiceException,
AmazonClientException
Returns information about an attribute of a snapshot. Only one attribute can be specified per call.
describeSnapshotAttributeRequest - Container for the necessary
parameters to execute the DescribeSnapshotAttribute operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeSnapshotAttributeResult> describeSnapshotAttributeAsync(DescribeSnapshotAttributeRequest describeSnapshotAttributeRequest,
AsyncHandler<DescribeSnapshotAttributeRequest,DescribeSnapshotAttributeResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Returns information about an attribute of a snapshot. Only one attribute can be specified per call.
describeSnapshotAttributeRequest - Container for the necessary
parameters to execute the DescribeSnapshotAttribute operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeAddressesResult> describeAddressesAsync(DescribeAddressesRequest describeAddressesRequest)
throws AmazonServiceException,
AmazonClientException
The DescribeAddresses operation lists elastic IP addresses assigned to your account.
describeAddressesRequest - Container for the necessary parameters
to execute the DescribeAddresses operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeAddressesResult> describeAddressesAsync(DescribeAddressesRequest describeAddressesRequest,
AsyncHandler<DescribeAddressesRequest,DescribeAddressesResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DescribeAddresses operation lists elastic IP addresses assigned to your account.
describeAddressesRequest - Container for the necessary parameters
to execute the DescribeAddresses operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeImageAttributeResult> describeImageAttributeAsync(DescribeImageAttributeRequest describeImageAttributeRequest)
throws AmazonServiceException,
AmazonClientException
The DescribeImageAttribute operation returns information about an attribute of an AMI. Only one attribute can be specified per call.
describeImageAttributeRequest - Container for the necessary
parameters to execute the DescribeImageAttribute operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeImageAttributeResult> describeImageAttributeAsync(DescribeImageAttributeRequest describeImageAttributeRequest,
AsyncHandler<DescribeImageAttributeRequest,DescribeImageAttributeResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DescribeImageAttribute operation returns information about an attribute of an AMI. Only one attribute can be specified per call.
describeImageAttributeRequest - Container for the necessary
parameters to execute the DescribeImageAttribute operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeKeyPairsResult> describeKeyPairsAsync(DescribeKeyPairsRequest describeKeyPairsRequest)
throws AmazonServiceException,
AmazonClientException
The DescribeKeyPairs operation returns information about key pairs available to you. If you specify key pairs, information about those key pairs is returned. Otherwise, information for all registered key pairs is returned.
describeKeyPairsRequest - Container for the necessary parameters
to execute the DescribeKeyPairs operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeKeyPairsResult> describeKeyPairsAsync(DescribeKeyPairsRequest describeKeyPairsRequest,
AsyncHandler<DescribeKeyPairsRequest,DescribeKeyPairsResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DescribeKeyPairs operation returns information about key pairs available to you. If you specify key pairs, information about those key pairs is returned. Otherwise, information for all registered key pairs is returned.
describeKeyPairsRequest - Container for the necessary parameters
to execute the DescribeKeyPairs operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<ConfirmProductInstanceResult> confirmProductInstanceAsync(ConfirmProductInstanceRequest confirmProductInstanceRequest)
throws AmazonServiceException,
AmazonClientException
The ConfirmProductInstance operation returns true if the specified product code is attached to the specified instance. The operation returns false if the product code is not attached to the instance.
The ConfirmProductInstance operation can only be executed by the owner of the AMI. This feature is useful when an AMI owner is providing support and wants to verify whether a user's instance is eligible.
confirmProductInstanceRequest - Container for the necessary
parameters to execute the ConfirmProductInstance operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<ConfirmProductInstanceResult> confirmProductInstanceAsync(ConfirmProductInstanceRequest confirmProductInstanceRequest,
AsyncHandler<ConfirmProductInstanceRequest,ConfirmProductInstanceResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The ConfirmProductInstance operation returns true if the specified product code is attached to the specified instance. The operation returns false if the product code is not attached to the instance.
The ConfirmProductInstance operation can only be executed by the owner of the AMI. This feature is useful when an AMI owner is providing support and wants to verify whether a user's instance is eligible.
confirmProductInstanceRequest - Container for the necessary
parameters to execute the ConfirmProductInstance operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateVolumeResult> createVolumeAsync(CreateVolumeRequest createVolumeRequest)
throws AmazonServiceException,
AmazonClientException
Initializes an empty volume of a given size.
createVolumeRequest - Container for the necessary parameters to
execute the CreateVolume operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateVolumeResult> createVolumeAsync(CreateVolumeRequest createVolumeRequest,
AsyncHandler<CreateVolumeRequest,CreateVolumeResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Initializes an empty volume of a given size.
createVolumeRequest - Container for the necessary parameters to
execute the CreateVolume operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeInstanceStatusResult> describeInstanceStatusAsync(DescribeInstanceStatusRequest describeInstanceStatusRequest)
throws AmazonServiceException,
AmazonClientException
Describes the status of an Amazon Elastic Compute Cloud (Amazon EC2) instance. Instance status provides information about two types of scheduled events for an instance that may require your attention:
system-reboot or instance-reboot .
System reboot commonly occurs if certain maintenance or upgrade
operations require a reboot of the underlying host that supports an
instance. Instance reboot commonly occurs if the instance must be
rebooted, rather than the underlying host. Rebooting events include a
scheduled start and end time. instance-retirement . Retirement commonly
occurs when the underlying host is degraded and must be replaced.
Retirement events include a scheduled start and end time. You're also
notified by email if one of your instances is set to retiring. The
email message indicates when your instance will be permanently
retired.
If your instance is permanently retired, it will not be restarted.
You can avoid retirement by manually restarting your instance when its
event code is instance-retirement . This ensures that
your instance is started on a healthy host.
DescribeInstanceStatus returns information only for
instances in the running state.
You can filter the results to return information only about instances that match criteria you specify. For example, you could get information about instances in a specific Availability Zone. You can specify multiple values for a filter (e.g., more than one Availability Zone). An instance must match at least one of the specified values for it to be included in the results.
You can specify multiple filters. An instance must match all the filters for it to be included in the results. If there's no match, no special message is returned; the response is simply empty.
You can use wildcards with the filter values: * matches
zero or more characters, and ? matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\ .
The following filters are available:
availability-zone - Filter on an instance's
availability zone. instance-state-name - Filter on the intended state
of the instance, e.g., running. instance-state-code - Filter on the intended state
code of the instance, e.g., 16.
describeInstanceStatusRequest - Container for the necessary
parameters to execute the DescribeInstanceStatus operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeInstanceStatusResult> describeInstanceStatusAsync(DescribeInstanceStatusRequest describeInstanceStatusRequest,
AsyncHandler<DescribeInstanceStatusRequest,DescribeInstanceStatusResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Describes the status of an Amazon Elastic Compute Cloud (Amazon EC2) instance. Instance status provides information about two types of scheduled events for an instance that may require your attention:
system-reboot or instance-reboot .
System reboot commonly occurs if certain maintenance or upgrade
operations require a reboot of the underlying host that supports an
instance. Instance reboot commonly occurs if the instance must be
rebooted, rather than the underlying host. Rebooting events include a
scheduled start and end time. instance-retirement . Retirement commonly
occurs when the underlying host is degraded and must be replaced.
Retirement events include a scheduled start and end time. You're also
notified by email if one of your instances is set to retiring. The
email message indicates when your instance will be permanently
retired.
If your instance is permanently retired, it will not be restarted.
You can avoid retirement by manually restarting your instance when its
event code is instance-retirement . This ensures that
your instance is started on a healthy host.
DescribeInstanceStatus returns information only for
instances in the running state.
You can filter the results to return information only about instances that match criteria you specify. For example, you could get information about instances in a specific Availability Zone. You can specify multiple values for a filter (e.g., more than one Availability Zone). An instance must match at least one of the specified values for it to be included in the results.
You can specify multiple filters. An instance must match all the filters for it to be included in the results. If there's no match, no special message is returned; the response is simply empty.
You can use wildcards with the filter values: * matches
zero or more characters, and ? matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\ .
The following filters are available:
availability-zone - Filter on an instance's
availability zone. instance-state-name - Filter on the intended state
of the instance, e.g., running. instance-state-code - Filter on the intended state
code of the instance, e.g., 16.
describeInstanceStatusRequest - Container for the necessary
parameters to execute the DescribeInstanceStatus operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeReservedInstancesOfferingsResult> describeReservedInstancesOfferingsAsync(DescribeReservedInstancesOfferingsRequest describeReservedInstancesOfferingsRequest)
throws AmazonServiceException,
AmazonClientException
The DescribeReservedInstancesOfferings operation describes Reserved Instance offerings that are available for purchase. With Amazon EC2 Reserved Instances, you purchase the right to launch Amazon EC2 instances for a period of time (without getting insufficient capacity errors) and pay a lower usage rate for the actual time used.
describeReservedInstancesOfferingsRequest - Container for the
necessary parameters to execute the DescribeReservedInstancesOfferings
operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeReservedInstancesOfferingsResult> describeReservedInstancesOfferingsAsync(DescribeReservedInstancesOfferingsRequest describeReservedInstancesOfferingsRequest,
AsyncHandler<DescribeReservedInstancesOfferingsRequest,DescribeReservedInstancesOfferingsResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DescribeReservedInstancesOfferings operation describes Reserved Instance offerings that are available for purchase. With Amazon EC2 Reserved Instances, you purchase the right to launch Amazon EC2 instances for a period of time (without getting insufficient capacity errors) and pay a lower usage rate for the actual time used.
describeReservedInstancesOfferingsRequest - Container for the
necessary parameters to execute the DescribeReservedInstancesOfferings
operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deleteSnapshotAsync(DeleteSnapshotRequest deleteSnapshotRequest)
throws AmazonServiceException,
AmazonClientException
Deletes the snapshot identified by snapshotId .
deleteSnapshotRequest - Container for the necessary parameters to
execute the DeleteSnapshot operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deleteSnapshotAsync(DeleteSnapshotRequest deleteSnapshotRequest,
AsyncHandler<DeleteSnapshotRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Deletes the snapshot identified by snapshotId .
deleteSnapshotRequest - Container for the necessary parameters to
execute the DeleteSnapshot operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> disassociateAddressAsync(DisassociateAddressRequest disassociateAddressRequest)
throws AmazonServiceException,
AmazonClientException
The DisassociateAddress operation disassociates the specified elastic IP address from the instance to which it is assigned. This is an idempotent operation. If you enter it more than once, Amazon EC2 does not return an error.
disassociateAddressRequest - Container for the necessary
parameters to execute the DisassociateAddress operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> disassociateAddressAsync(DisassociateAddressRequest disassociateAddressRequest,
AsyncHandler<DisassociateAddressRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The DisassociateAddress operation disassociates the specified elastic IP address from the instance to which it is assigned. This is an idempotent operation. If you enter it more than once, Amazon EC2 does not return an error.
disassociateAddressRequest - Container for the necessary
parameters to execute the DisassociateAddress operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> createPlacementGroupAsync(CreatePlacementGroupRequest createPlacementGroupRequest)
throws AmazonServiceException,
AmazonClientException
Creates a PlacementGroup into which multiple Amazon EC2 instances can be launched. Users must give the group a name unique within the scope of the user account.
createPlacementGroupRequest - Container for the necessary
parameters to execute the CreatePlacementGroup operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> createPlacementGroupAsync(CreatePlacementGroupRequest createPlacementGroupRequest,
AsyncHandler<CreatePlacementGroupRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Creates a PlacementGroup into which multiple Amazon EC2 instances can be launched. Users must give the group a name unique within the scope of the user account.
createPlacementGroupRequest - Container for the necessary
parameters to execute the CreatePlacementGroup operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<BundleInstanceResult> bundleInstanceAsync(BundleInstanceRequest bundleInstanceRequest)
throws AmazonServiceException,
AmazonClientException
The BundleInstance operation request that an instance is bundled the next time it boots. The bundling process creates a new image from a running instance and stores the AMI data in S3. Once bundled, the image must be registered in the normal way using the RegisterImage API.
bundleInstanceRequest - Container for the necessary parameters to
execute the BundleInstance operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<BundleInstanceResult> bundleInstanceAsync(BundleInstanceRequest bundleInstanceRequest,
AsyncHandler<BundleInstanceRequest,BundleInstanceResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The BundleInstance operation request that an instance is bundled the next time it boots. The bundling process creates a new image from a running instance and stores the AMI data in S3. Once bundled, the image must be registered in the normal way using the RegisterImage API.
bundleInstanceRequest - Container for the necessary parameters to
execute the BundleInstance operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deletePlacementGroupAsync(DeletePlacementGroupRequest deletePlacementGroupRequest)
throws AmazonServiceException,
AmazonClientException
Deletes a PlacementGroup from a user's account. Terminate all Amazon EC2 instances in the placement group before deletion.
deletePlacementGroupRequest - Container for the necessary
parameters to execute the DeletePlacementGroup operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> deletePlacementGroupAsync(DeletePlacementGroupRequest deletePlacementGroupRequest,
AsyncHandler<DeletePlacementGroupRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Deletes a PlacementGroup from a user's account. Terminate all Amazon EC2 instances in the placement group before deletion.
deletePlacementGroupRequest - Container for the necessary
parameters to execute the DeletePlacementGroup operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<AllocateAddressResult> allocateAddressAsync(AllocateAddressRequest allocateAddressRequest)
throws AmazonServiceException,
AmazonClientException
The AllocateAddress operation acquires an elastic IP address for use with your account.
allocateAddressRequest - Container for the necessary parameters
to execute the AllocateAddress operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<AllocateAddressResult> allocateAddressAsync(AllocateAddressRequest allocateAddressRequest,
AsyncHandler<AllocateAddressRequest,AllocateAddressResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The AllocateAddress operation acquires an elastic IP address for use with your account.
allocateAddressRequest - Container for the necessary parameters
to execute the AllocateAddress operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> releaseAddressAsync(ReleaseAddressRequest releaseAddressRequest)
throws AmazonServiceException,
AmazonClientException
The ReleaseAddress operation releases an elastic IP address associated with your account.
NOTE: Releasing an IP address automatically disassociates it from any instance with which it is associated. For more information, see DisassociateAddress.
IMPORTANT: After releasing an elastic IP address, it is released to the IP address pool and might no longer be available to your account. Make sure to update your DNS records and any servers or devices that communicate with the address. If you run this operation on an elastic IP address that is already released, the address might be assigned to another account which will cause Amazon EC2 to return an error.
releaseAddressRequest - Container for the necessary parameters to
execute the ReleaseAddress operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> releaseAddressAsync(ReleaseAddressRequest releaseAddressRequest,
AsyncHandler<ReleaseAddressRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The ReleaseAddress operation releases an elastic IP address associated with your account.
NOTE: Releasing an IP address automatically disassociates it from any instance with which it is associated. For more information, see DisassociateAddress.
IMPORTANT: After releasing an elastic IP address, it is released to the IP address pool and might no longer be available to your account. Make sure to update your DNS records and any servers or devices that communicate with the address. If you run this operation on an elastic IP address that is already released, the address might be assigned to another account which will cause Amazon EC2 to return an error.
releaseAddressRequest - Container for the necessary parameters to
execute the ReleaseAddress operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> resetInstanceAttributeAsync(ResetInstanceAttributeRequest resetInstanceAttributeRequest)
throws AmazonServiceException,
AmazonClientException
Resets an attribute of an instance to its default value.
resetInstanceAttributeRequest - Container for the necessary
parameters to execute the ResetInstanceAttribute operation on
AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<Void> resetInstanceAttributeAsync(ResetInstanceAttributeRequest resetInstanceAttributeRequest,
AsyncHandler<ResetInstanceAttributeRequest,Void> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Resets an attribute of an instance to its default value.
resetInstanceAttributeRequest - Container for the necessary
parameters to execute the ResetInstanceAttribute operation on
AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateKeyPairResult> createKeyPairAsync(CreateKeyPairRequest createKeyPairRequest)
throws AmazonServiceException,
AmazonClientException
The CreateKeyPair operation creates a new 2048 bit RSA key pair and returns a unique ID that can be used to reference this key pair when launching new instances. For more information, see RunInstances.
createKeyPairRequest - Container for the necessary parameters to
execute the CreateKeyPair operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<CreateKeyPairResult> createKeyPairAsync(CreateKeyPairRequest createKeyPairRequest,
AsyncHandler<CreateKeyPairRequest,CreateKeyPairResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The CreateKeyPair operation creates a new 2048 bit RSA key pair and returns a unique ID that can be used to reference this key pair when launching new instances. For more information, see RunInstances.
createKeyPairRequest - Container for the necessary parameters to
execute the CreateKeyPair operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeSnapshotsResult> describeSnapshotsAsync(DescribeSnapshotsRequest describeSnapshotsRequest)
throws AmazonServiceException,
AmazonClientException
Returns information about the Amazon EBS snapshots available to you. Snapshots available to you include public snapshots available for any AWS account to launch, private snapshots you own, and private snapshots owned by another AWS account but for which you've been given explicit create volume permissions.
describeSnapshotsRequest - Container for the necessary parameters
to execute the DescribeSnapshots operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<DescribeSnapshotsResult> describeSnapshotsAsync(DescribeSnapshotsRequest describeSnapshotsRequest,
AsyncHandler<DescribeSnapshotsRequest,DescribeSnapshotsResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
Returns information about the Amazon EBS snapshots available to you. Snapshots available to you include public snapshots available for any AWS account to launch, private snapshots you own, and private snapshots owned by another AWS account but for which you've been given explicit create volume permissions.
describeSnapshotsRequest - Container for the necessary parameters
to execute the DescribeSnapshots operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<RegisterImageResult> registerImageAsync(RegisterImageRequest registerImageRequest)
throws AmazonServiceException,
AmazonClientException
The RegisterImage operation registers an AMI with Amazon EC2. Images must be registered before they can be launched. For more information, see RunInstances.
Each AMI is associated with an unique ID which is provided by the Amazon EC2 service through the RegisterImage operation. During registration, Amazon EC2 retrieves the specified image manifest from Amazon S3 and verifies that the image is owned by the user registering the image.
The image manifest is retrieved once and stored within the Amazon EC2. Any modifications to an image in Amazon S3 invalidates this registration. If you make changes to an image, deregister the previous image and register the new image. For more information, see DeregisterImage.
registerImageRequest - Container for the necessary parameters to
execute the RegisterImage operation on AmazonEC2.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
Future<RegisterImageResult> registerImageAsync(RegisterImageRequest registerImageRequest,
AsyncHandler<RegisterImageRequest,RegisterImageResult> asyncHandler)
throws AmazonServiceException,
AmazonClientException
The RegisterImage operation registers an AMI with Amazon EC2. Images must be registered before they can be launched. For more information, see RunInstances.
Each AMI is associated with an unique ID which is provided by the Amazon EC2 service through the RegisterImage operation. During registration, Amazon EC2 retrieves the specified image manifest from Amazon S3 and verifies that the image is owned by the user registering the image.
The image manifest is retrieved once and stored within the Amazon EC2. Any modifications to an image in Amazon S3 invalidates this registration. If you make changes to an image, deregister the previous image and register the new image. For more information, see DeregisterImage.
registerImageRequest - Container for the necessary parameters to
execute the RegisterImage operation on AmazonEC2.asyncHandler - Asynchronous callback handler for events in the
life-cycle of the request. Users could provide the implementation of
the four callback methods in this interface to process the operation
result or handle the exception.
AmazonClientException - If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException - If an error response is returned by AmazonEC2 indicating
either a problem with the data in the request, or a server side issue.
|
|||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||