|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.amazonaws.AmazonWebServiceClient
com.amazonaws.services.ec2.AmazonEC2Client
com.amazonaws.services.ec2.AmazonEC2AsyncClient
public class AmazonEC2AsyncClient
Client for accessing AmazonEC2. All calls made using this client are non-blocking and will immediately return a Java Future. Callers must use the Future object to determine when the service call has actually completed.
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.
Constructor Summary | |
---|---|
AmazonEC2AsyncClient(AWSCredentials awsCredentials)
Constructs a new asynchronous client to invoke service methods on AmazonEC2 using the specified AWS account credentials. |
|
AmazonEC2AsyncClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration,
ExecutorService executorService)
Constructs a new asynchronous client to invoke service methods on AmazonEC2 using the specified AWS account credentials, executor service, and client configuration options. |
|
AmazonEC2AsyncClient(AWSCredentials awsCredentials,
ExecutorService executorService)
Constructs a new asynchronous client to invoke service methods on AmazonEC2 using the specified AWS account credentials and executor service. |
Method Summary | |
---|---|
Future<AllocateAddressResult> |
allocateAddressAsync(AllocateAddressRequest allocateAddressRequest)
The AllocateAddress operation acquires an elastic IP address for use with your account. |
Future<Void> |
associateAddressAsync(AssociateAddressRequest associateAddressRequest)
The AssociateAddress operation associates an elastic IP address with an instance. |
Future<Void> |
associateDhcpOptionsAsync(AssociateDhcpOptionsRequest associateDhcpOptionsRequest)
Associates a set of DHCP options (that you've previously created) with the specified VPC. |
Future<AttachVolumeResult> |
attachVolumeAsync(AttachVolumeRequest attachVolumeRequest)
Attach a previously created volume to a running instance. |
Future<AttachVpnGatewayResult> |
attachVpnGatewayAsync(AttachVpnGatewayRequest attachVpnGatewayRequest)
Attaches a VPN gateway to a VPC. |
Future<Void> |
authorizeSecurityGroupIngressAsync(AuthorizeSecurityGroupIngressRequest authorizeSecurityGroupIngressRequest)
The AuthorizeSecurityGroupIngress operation adds permissions to a security group. |
Future<BundleInstanceResult> |
bundleInstanceAsync(BundleInstanceRequest bundleInstanceRequest)
The BundleInstance operation request that an instance is bundled the next time it boots. |
Future<CancelBundleTaskResult> |
cancelBundleTaskAsync(CancelBundleTaskRequest cancelBundleTaskRequest)
CancelBundleTask operation cancels a pending or in-progress bundling task. |
Future<CancelSpotInstanceRequestsResult> |
cancelSpotInstanceRequestsAsync(CancelSpotInstanceRequestsRequest cancelSpotInstanceRequestsRequest)
Cancels one or more Spot Instance requests. |
Future<ConfirmProductInstanceResult> |
confirmProductInstanceAsync(ConfirmProductInstanceRequest confirmProductInstanceRequest)
The ConfirmProductInstance operation returns true if the specified product code is attached to the specified instance. |
Future<CreateCustomerGatewayResult> |
createCustomerGatewayAsync(CreateCustomerGatewayRequest createCustomerGatewayRequest)
Provides information to AWS about your customer gateway device. |
Future<CreateDhcpOptionsResult> |
createDhcpOptionsAsync(CreateDhcpOptionsRequest createDhcpOptionsRequest)
Creates a set of DHCP options that you can then associate with one or more VPCs, causing all existing and new instances that you launch in those VPCs to use the set of DHCP options. |
Future<CreateImageResult> |
createImageAsync(CreateImageRequest createImageRequest)
Creates an AMI that uses an Amazon EBS root device from a "running" or "stopped" instance. |
Future<CreateKeyPairResult> |
createKeyPairAsync(CreateKeyPairRequest createKeyPairRequest)
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. |
Future<Void> |
createSecurityGroupAsync(CreateSecurityGroupRequest createSecurityGroupRequest)
The CreateSecurityGroup operation creates a new security group. |
Future<CreateSnapshotResult> |
createSnapshotAsync(CreateSnapshotRequest createSnapshotRequest)
Create a snapshot of the volume identified by volume ID. |
Future<CreateSpotDatafeedSubscriptionResult> |
createSpotDatafeedSubscriptionAsync(CreateSpotDatafeedSubscriptionRequest createSpotDatafeedSubscriptionRequest)
Creates the data feed for Spot Instances, enabling you to view Spot Instance usage logs. |
Future<CreateSubnetResult> |
createSubnetAsync(CreateSubnetRequest createSubnetRequest)
Creates a subnet in an existing VPC. |
Future<CreateVolumeResult> |
createVolumeAsync(CreateVolumeRequest createVolumeRequest)
Initializes an empty volume of a given size. |
Future<CreateVpcResult> |
createVpcAsync(CreateVpcRequest createVpcRequest)
Creates a VPC with the CIDR block you specify. |
Future<CreateVpnConnectionResult> |
createVpnConnectionAsync(CreateVpnConnectionRequest createVpnConnectionRequest)
Creates a new VPN connection between an existing VPN gateway and customer gateway. |
Future<CreateVpnGatewayResult> |
createVpnGatewayAsync(CreateVpnGatewayRequest createVpnGatewayRequest)
Creates a new VPN gateway. |
Future<Void> |
deleteCustomerGatewayAsync(DeleteCustomerGatewayRequest deleteCustomerGatewayRequest)
Deletes a customer gateway. |
Future<Void> |
deleteDhcpOptionsAsync(DeleteDhcpOptionsRequest deleteDhcpOptionsRequest)
Deletes a set of DHCP options that you specify. |
Future<Void> |
deleteKeyPairAsync(DeleteKeyPairRequest deleteKeyPairRequest)
The DeleteKeyPair operation deletes a key pair. |
Future<Void> |
deleteSecurityGroupAsync(DeleteSecurityGroupRequest deleteSecurityGroupRequest)
The DeleteSecurityGroup operation deletes a security group. |
Future<Void> |
deleteSnapshotAsync(DeleteSnapshotRequest deleteSnapshotRequest)
Deletes the snapshot identified by snapshotId. |
Future<Void> |
deleteSpotDatafeedSubscriptionAsync(DeleteSpotDatafeedSubscriptionRequest deleteSpotDatafeedSubscriptionRequest)
Deletes the data feed for Spot Instances. |
Future<Void> |
deleteSubnetAsync(DeleteSubnetRequest deleteSubnetRequest)
Deletes a subnet from a VPC. |
Future<Void> |
deleteVolumeAsync(DeleteVolumeRequest deleteVolumeRequest)
Deletes a previously created volume. |
Future<Void> |
deleteVpcAsync(DeleteVpcRequest deleteVpcRequest)
Deletes a VPC. |
Future<Void> |
deleteVpnConnectionAsync(DeleteVpnConnectionRequest deleteVpnConnectionRequest)
Deletes a VPN connection. |
Future<Void> |
deleteVpnGatewayAsync(DeleteVpnGatewayRequest deleteVpnGatewayRequest)
Deletes a VPN gateway. |
Future<Void> |
deregisterImageAsync(DeregisterImageRequest deregisterImageRequest)
The DeregisterImage operation deregisters an AMI. |
Future<DescribeAddressesResult> |
describeAddressesAsync(DescribeAddressesRequest describeAddressesRequest)
The DescribeAddresses operation lists elastic IP addresses assigned to your account. |
Future<DescribeAvailabilityZonesResult> |
describeAvailabilityZonesAsync(DescribeAvailabilityZonesRequest describeAvailabilityZonesRequest)
The DescribeAvailabilityZones operation describes availability zones that are currently available to the account and their states. |
Future<DescribeBundleTasksResult> |
describeBundleTasksAsync(DescribeBundleTasksRequest describeBundleTasksRequest)
The DescribeBundleTasks operation describes in-progress and recent bundle tasks. |
Future<DescribeCustomerGatewaysResult> |
describeCustomerGatewaysAsync(DescribeCustomerGatewaysRequest describeCustomerGatewaysRequest)
Gives you information about your customer gateways. |
Future<DescribeDhcpOptionsResult> |
describeDhcpOptionsAsync(DescribeDhcpOptionsRequest describeDhcpOptionsRequest)
Gives you information about one or more sets of DHCP options. |
Future<DescribeImageAttributeResult> |
describeImageAttributeAsync(DescribeImageAttributeRequest describeImageAttributeRequest)
The DescribeImageAttribute operation returns information about an attribute of an AMI. |
Future<DescribeImagesResult> |
describeImagesAsync(DescribeImagesRequest describeImagesRequest)
The DescribeImages operation returns information about AMIs, AKIs, and ARIs available to the user. |
Future<DescribeInstanceAttributeResult> |
describeInstanceAttributeAsync(DescribeInstanceAttributeRequest describeInstanceAttributeRequest)
Returns information about an attribute of an instance. |
Future<DescribeInstancesResult> |
describeInstancesAsync(DescribeInstancesRequest describeInstancesRequest)
The DescribeInstances operation returns information about instances that you own. |
Future<DescribeKeyPairsResult> |
describeKeyPairsAsync(DescribeKeyPairsRequest describeKeyPairsRequest)
The DescribeKeyPairs operation returns information about key pairs available to you. |
Future<DescribeRegionsResult> |
describeRegionsAsync(DescribeRegionsRequest describeRegionsRequest)
The DescribeRegions operation describes regions zones that are currently available to the account. |
Future<DescribeReservedInstancesResult> |
describeReservedInstancesAsync(DescribeReservedInstancesRequest describeReservedInstancesRequest)
The DescribeReservedInstances operation describes Reserved Instances that were purchased for use with your account. |
Future<DescribeReservedInstancesOfferingsResult> |
describeReservedInstancesOfferingsAsync(DescribeReservedInstancesOfferingsRequest describeReservedInstancesOfferingsRequest)
The DescribeReservedInstancesOfferings operation describes Reserved Instance offerings that are available for purchase. |
Future<DescribeSecurityGroupsResult> |
describeSecurityGroupsAsync(DescribeSecurityGroupsRequest describeSecurityGroupsRequest)
The DescribeSecurityGroups operation returns information about security groups that you own. |
Future<DescribeSnapshotAttributeResult> |
describeSnapshotAttributeAsync(DescribeSnapshotAttributeRequest describeSnapshotAttributeRequest)
Returns information about an attribute of a snapshot. |
Future<DescribeSnapshotsResult> |
describeSnapshotsAsync(DescribeSnapshotsRequest describeSnapshotsRequest)
Describes the indicated snapshots, or in lieu of that, all snapshots owned by the caller. |
Future<DescribeSpotDatafeedSubscriptionResult> |
describeSpotDatafeedSubscriptionAsync(DescribeSpotDatafeedSubscriptionRequest describeSpotDatafeedSubscriptionRequest)
Describes the data feed for Spot Instances. |
Future<DescribeSpotInstanceRequestsResult> |
describeSpotInstanceRequestsAsync(DescribeSpotInstanceRequestsRequest describeSpotInstanceRequestsRequest)
|
Future<DescribeSpotPriceHistoryResult> |
describeSpotPriceHistoryAsync(DescribeSpotPriceHistoryRequest describeSpotPriceHistoryRequest)
Describes the Spot Price history. |
Future<DescribeSubnetsResult> |
describeSubnetsAsync(DescribeSubnetsRequest describeSubnetsRequest)
Gives you information about your subnets. |
Future<DescribeVolumesResult> |
describeVolumesAsync(DescribeVolumesRequest describeVolumesRequest)
Describes the status of the indicated or, in lieu of any specified, all volumes belonging to the caller. |
Future<DescribeVpcsResult> |
describeVpcsAsync(DescribeVpcsRequest describeVpcsRequest)
Gives you information about your VPCs. |
Future<DescribeVpnConnectionsResult> |
describeVpnConnectionsAsync(DescribeVpnConnectionsRequest describeVpnConnectionsRequest)
Gives you information about your VPN connections. |
Future<DescribeVpnGatewaysResult> |
describeVpnGatewaysAsync(DescribeVpnGatewaysRequest describeVpnGatewaysRequest)
Gives you information about your VPN gateways. |
Future<DetachVolumeResult> |
detachVolumeAsync(DetachVolumeRequest detachVolumeRequest)
Detach a previously attached volume from a running instance. |
Future<Void> |
detachVpnGatewayAsync(DetachVpnGatewayRequest detachVpnGatewayRequest)
Detaches a VPN gateway from a VPC. |
Future<Void> |
disassociateAddressAsync(DisassociateAddressRequest disassociateAddressRequest)
The DisassociateAddress operation disassociates the specified elastic IP address from the instance to which it is assigned. |
Future<GetConsoleOutputResult> |
getConsoleOutputAsync(GetConsoleOutputRequest getConsoleOutputRequest)
The GetConsoleOutput operation retrieves console output for the specified instance. |
ExecutorService |
getExecutorService()
Returns the executor service used by this async client to execute requests. |
Future<GetPasswordDataResult> |
getPasswordDataAsync(GetPasswordDataRequest getPasswordDataRequest)
Retrieves the encrypted administrator password for the instances running Windows. |
Future<Void> |
modifyImageAttributeAsync(ModifyImageAttributeRequest modifyImageAttributeRequest)
The ModifyImageAttribute operation modifies an attribute of an AMI. |
Future<Void> |
modifyInstanceAttributeAsync(ModifyInstanceAttributeRequest modifyInstanceAttributeRequest)
Modifies an attribute of an instance. |
Future<Void> |
modifySnapshotAttributeAsync(ModifySnapshotAttributeRequest modifySnapshotAttributeRequest)
Adds or remove permission settings for the specified snapshot. |
Future<MonitorInstancesResult> |
monitorInstancesAsync(MonitorInstancesRequest monitorInstancesRequest)
Enables monitoring for a running instance. |
Future<PurchaseReservedInstancesOfferingResult> |
purchaseReservedInstancesOfferingAsync(PurchaseReservedInstancesOfferingRequest purchaseReservedInstancesOfferingRequest)
The PurchaseReservedInstancesOffering operation purchases a Reserved Instance for use with your account. |
Future<Void> |
rebootInstancesAsync(RebootInstancesRequest rebootInstancesRequest)
The RebootInstances operation requests a reboot of one or more instances. |
Future<RegisterImageResult> |
registerImageAsync(RegisterImageRequest registerImageRequest)
The RegisterImage operation registers an AMI with Amazon EC2. |
Future<Void> |
releaseAddressAsync(ReleaseAddressRequest releaseAddressRequest)
The ReleaseAddress operation releases an elastic IP address associated with your account. |
Future<RequestSpotInstancesResult> |
requestSpotInstancesAsync(RequestSpotInstancesRequest requestSpotInstancesRequest)
Creates a Spot Instance request. |
Future<Void> |
resetImageAttributeAsync(ResetImageAttributeRequest resetImageAttributeRequest)
The ResetImageAttribute operation resets an attribute of an AMI to its default value. |
Future<Void> |
resetInstanceAttributeAsync(ResetInstanceAttributeRequest resetInstanceAttributeRequest)
Resets an attribute of an instance to its default value. |
Future<Void> |
resetSnapshotAttributeAsync(ResetSnapshotAttributeRequest resetSnapshotAttributeRequest)
Resets permission settings for the specified snapshot. |
Future<Void> |
revokeSecurityGroupIngressAsync(RevokeSecurityGroupIngressRequest revokeSecurityGroupIngressRequest)
The RevokeSecurityGroupIngress operation revokes permissions from a security group. |
Future<RunInstancesResult> |
runInstancesAsync(RunInstancesRequest runInstancesRequest)
The RunInstances operation launches a specified number of instances. |
Future<StartInstancesResult> |
startInstancesAsync(StartInstancesRequest startInstancesRequest)
Starts an instance that uses an Amazon EBS volume as its root device. |
Future<StopInstancesResult> |
stopInstancesAsync(StopInstancesRequest stopInstancesRequest)
Stops an instance that uses an Amazon EBS volume as its root device. |
Future<TerminateInstancesResult> |
terminateInstancesAsync(TerminateInstancesRequest terminateInstancesRequest)
The TerminateInstances operation shuts down one or more instances. |
Future<UnmonitorInstancesResult> |
unmonitorInstancesAsync(UnmonitorInstancesRequest unmonitorInstancesRequest)
Disables monitoring for a running instance. |
Methods inherited from class com.amazonaws.AmazonWebServiceClient |
---|
setEndpoint |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public AmazonEC2AsyncClient(AWSCredentials awsCredentials)
All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.
awsCredentials
- The AWS credentials (access key ID and secret key) to use
when authenticating with AWS services.public AmazonEC2AsyncClient(AWSCredentials awsCredentials, ExecutorService executorService)
All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.
awsCredentials
- The AWS credentials (access key ID and secret key) to use
when authenticating with AWS services.executorService
- The executor service by which all asynchronous requests will
be executed.public AmazonEC2AsyncClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration, ExecutorService executorService)
All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.
awsCredentials
- The AWS credentials (access key ID and secret key) to use
when authenticating with AWS services.clientConfiguration
- Client configuration options (ex: max retry limit, proxy
settings, etc).executorService
- The executor service by which all asynchronous requests will
be executed.Method Detail |
---|
public ExecutorService getExecutorService()
public 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.
rebootInstancesAsync
in interface AmazonEC2Async
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.public 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.
runInstancesAsync
in interface AmazonEC2Async
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.public Future<DescribeReservedInstancesResult> describeReservedInstancesAsync(DescribeReservedInstancesRequest describeReservedInstancesRequest) throws AmazonServiceException, AmazonClientException
The DescribeReservedInstances operation describes Reserved Instances that were purchased for use with your account.
describeReservedInstancesAsync
in interface AmazonEC2Async
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.public Future<DescribeSubnetsResult> describeSubnetsAsync(DescribeSubnetsRequest describeSubnetsRequest) throws AmazonServiceException, AmazonClientException
Gives you information about your subnets. You can filter the results to return information only about subnets that match criteria you specify. For example, you could ask to get information about a particular subnet (or all) only if the subnet's state is available. You can specify multiple filters (e.g., the subnet is in a particular VPC, and the subnet's state is available). The result includes information for a particular subnet only if the subnet matches all your filters. If there's no match, no special message is returned; the response is simply empty. The following table shows the available filters.
describeSubnetsAsync
in interface AmazonEC2Async
describeSubnetsRequest
- Container for the necessary parameters
to execute the DescribeSubnets 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.public 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.
describeAvailabilityZonesAsync
in interface AmazonEC2Async
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.public Future<DetachVolumeResult> detachVolumeAsync(DetachVolumeRequest detachVolumeRequest) throws AmazonServiceException, AmazonClientException
Detach a previously attached volume from a running instance.
detachVolumeAsync
in interface AmazonEC2Async
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.public Future<Void> deleteKeyPairAsync(DeleteKeyPairRequest deleteKeyPairRequest) throws AmazonServiceException, AmazonClientException
The DeleteKeyPair operation deletes a key pair.
deleteKeyPairAsync
in interface AmazonEC2Async
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.public 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.
describeInstancesAsync
in interface AmazonEC2Async
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.public 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.
describeImagesAsync
in interface AmazonEC2Async
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.public 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: 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.
startInstancesAsync
in interface AmazonEC2Async
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.public Future<UnmonitorInstancesResult> unmonitorInstancesAsync(UnmonitorInstancesRequest unmonitorInstancesRequest) throws AmazonServiceException, AmazonClientException
Disables monitoring for a running instance.
unmonitorInstancesAsync
in interface AmazonEC2Async
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.public Future<AttachVpnGatewayResult> attachVpnGatewayAsync(AttachVpnGatewayRequest attachVpnGatewayRequest) throws AmazonServiceException, AmazonClientException
Attaches a VPN gateway to a VPC. This is the last step required to get your VPC fully connected to your data center before launching instances in it. For more information, go to Process for Using Amazon VPC in the Amazon Virtual Private Cloud Developer Guide.
attachVpnGatewayAsync
in interface AmazonEC2Async
attachVpnGatewayRequest
- Container for the necessary parameters
to execute the AttachVpnGateway 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.public Future<Void> modifyInstanceAttributeAsync(ModifyInstanceAttributeRequest modifyInstanceAttributeRequest) throws AmazonServiceException, AmazonClientException
Modifies an attribute of an instance.
modifyInstanceAttributeAsync
in interface AmazonEC2Async
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.public Future<Void> deleteDhcpOptionsAsync(DeleteDhcpOptionsRequest deleteDhcpOptionsRequest) throws AmazonServiceException, AmazonClientException
Deletes a set of DHCP options that you specify. Amazon VPC returns an error if the set of options you specify is currently associated with a VPC. You can disassociate the set of options by associating either a new set of options or the default options with the VPC.
deleteDhcpOptionsAsync
in interface AmazonEC2Async
deleteDhcpOptionsRequest
- Container for the necessary parameters
to execute the DeleteDhcpOptions 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.public 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.
deleteSecurityGroupAsync
in interface AmazonEC2Async
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.public Future<CreateImageResult> createImageAsync(CreateImageRequest createImageRequest) throws AmazonServiceException, AmazonClientException
Creates an AMI that uses an Amazon EBS root device 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.
createImageAsync
in interface AmazonEC2Async
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.public 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.
When authorizing a user/group pair permission, GroupName, SourceSecurityGroupName and SourceSecurityGroupOwnerId must be specified. When authorizing a CIDR IP permission, GroupName, IpProtocol, FromPort, ToPort and CidrIp must be specified. Mixing these two types of parameters is not allowed.
authorizeSecurityGroupIngressAsync
in interface AmazonEC2Async
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.public Future<DescribeSpotInstanceRequestsResult> describeSpotInstanceRequestsAsync(DescribeSpotInstanceRequestsRequest describeSpotInstanceRequestsRequest) throws AmazonServiceException, AmazonClientException
describeSpotInstanceRequestsAsync
in interface AmazonEC2Async
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.public Future<Void> associateDhcpOptionsAsync(AssociateDhcpOptionsRequest associateDhcpOptionsRequest) throws AmazonServiceException, AmazonClientException
Associates a set of DHCP options (that you've previously created) with the specified VPC. Or, associates the default DHCP options with the VPC. The default set consists of the standard EC2 host name, no domain name, no DNS server, no NTP server, and no NetBIOS server or node type. After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. For more information about the supported DHCP options and using them with Amazon VPC, go to Using DHCP Options in the Amazon Virtual Private Cloud Developer Guide.
associateDhcpOptionsAsync
in interface AmazonEC2Async
associateDhcpOptionsRequest
- Container for the necessary
parameters to execute the AssociateDhcpOptions 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.public 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.
getPasswordDataAsync
in interface AmazonEC2Async
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.public Future<CreateVpcResult> createVpcAsync(CreateVpcRequest createVpcRequest) throws AmazonServiceException, AmazonClientException
Creates a VPC with the CIDR block you specify. The smallest VPC you can create uses a /28 netmask (16 IP addresses), and the largest uses a /18 netmask (16,384 IP addresses). To help you decide how big to make your VPC, go to the topic about creating VPCs in the Amazon Virtual Private Cloud Developer Guide.
By default, each instance you launch in the VPC has the default DHCP options (the standard EC2 host name, no domain name, no DNS server, no NTP server, and no NetBIOS server or node type).
createVpcAsync
in interface AmazonEC2Async
createVpcRequest
- Container for the necessary parameters to
execute the CreateVpc 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.public 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.
stopInstancesAsync
in interface AmazonEC2Async
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.public Future<DescribeCustomerGatewaysResult> describeCustomerGatewaysAsync(DescribeCustomerGatewaysRequest describeCustomerGatewaysRequest) throws AmazonServiceException, AmazonClientException
Gives you information about your customer gateways. You can filter the results to return information only about customer gateways that match criteria you specify. For example, you could ask to get information about a particular customer gateway (or all) only if the gateway's state is pending or available. You can specify multiple filters (e.g., the customer gateway has a particular IP address for the Internet-routable external interface, and the gateway's state is pending or available). The result includes information for a particular customer gateway only if the gateway matches all your filters. If there's no match, no special message is returned; the response is simply empty. The following table shows the available filters.
describeCustomerGatewaysAsync
in interface AmazonEC2Async
describeCustomerGatewaysRequest
- Container for the necessary
parameters to execute the DescribeCustomerGateways 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.public Future<Void> 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.
createSecurityGroupAsync
in interface AmazonEC2Async
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.public 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 .
describeSpotPriceHistoryAsync
in interface AmazonEC2Async
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.public Future<DescribeRegionsResult> describeRegionsAsync(DescribeRegionsRequest describeRegionsRequest) throws AmazonServiceException, AmazonClientException
The DescribeRegions operation describes regions zones that are currently available to the account.
describeRegionsAsync
in interface AmazonEC2Async
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.public Future<CreateDhcpOptionsResult> createDhcpOptionsAsync(CreateDhcpOptionsRequest createDhcpOptionsRequest) throws AmazonServiceException, AmazonClientException
Creates a set of DHCP options that you can then associate with one or more VPCs, causing all existing and new instances that you launch in those VPCs to use the set of DHCP options. The following table lists the individual DHCP options you can specify. For more information about the options, go to http://www.ietf.org/rfc/rfc2132.txt
createDhcpOptionsAsync
in interface AmazonEC2Async
createDhcpOptionsRequest
- Container for the necessary parameters
to execute the CreateDhcpOptions 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.public Future<Void> resetSnapshotAttributeAsync(ResetSnapshotAttributeRequest resetSnapshotAttributeRequest) throws AmazonServiceException, AmazonClientException
Resets permission settings for the specified snapshot.
resetSnapshotAttributeAsync
in interface AmazonEC2Async
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.public 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.
describeSecurityGroupsAsync
in interface AmazonEC2Async
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.public 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.
requestSpotInstancesAsync
in interface AmazonEC2Async
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.public Future<Void> detachVpnGatewayAsync(DetachVpnGatewayRequest detachVpnGatewayRequest) throws AmazonServiceException, AmazonClientException
Detaches a VPN gateway from a VPC. You do this if you're planning to turn off the VPC and not use it anymore. You can confirm a VPN gateway has been completely detached from a VPC by describing the VPN gateway (any attachments to the VPN gateway are also described).
You must wait for the attachment's state to switch to detached before you can delete the VPC or attach a different VPC to the VPN gateway.
detachVpnGatewayAsync
in interface AmazonEC2Async
detachVpnGatewayRequest
- Container for the necessary parameters
to execute the DetachVpnGateway 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.public 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.
deregisterImageAsync
in interface AmazonEC2Async
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.public 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 .
describeSpotDatafeedSubscriptionAsync
in interface AmazonEC2Async
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.public Future<Void> deleteSubnetAsync(DeleteSubnetRequest deleteSubnetRequest) throws AmazonServiceException, AmazonClientException
Deletes a subnet from a VPC. You must terminate all running instances in the subnet before deleting it, otherwise Amazon VPC returns an error.
deleteSubnetAsync
in interface AmazonEC2Async
deleteSubnetRequest
- Container for the necessary parameters to
execute the DeleteSubnet 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.public Future<CreateVpnGatewayResult> createVpnGatewayAsync(CreateVpnGatewayRequest createVpnGatewayRequest) throws AmazonServiceException, AmazonClientException
Creates a new VPN gateway. A VPN gateway is the VPC-side endpoint for your VPN connection. You can create a VPN gateway before creating the VPC itself.
createVpnGatewayAsync
in interface AmazonEC2Async
createVpnGatewayRequest
- Container for the necessary parameters
to execute the CreateVpnGateway 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.public 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.
cancelBundleTaskAsync
in interface AmazonEC2Async
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.public Future<Void> deleteVpnGatewayAsync(DeleteVpnGatewayRequest deleteVpnGatewayRequest) throws AmazonServiceException, AmazonClientException
Deletes a VPN gateway. Use this when you want to delete a VPC and all its associated components because you no longer need them. We recommend that before you delete a VPN gateway, you detach it from the VPC and delete the VPN connection. Note that you don't need to delete the VPN gateway if you just want to delete and re-create the VPN connection between your VPC and data center.
deleteVpnGatewayAsync
in interface AmazonEC2Async
deleteVpnGatewayRequest
- Container for the necessary parameters
to execute the DeleteVpnGateway 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.public 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 .
cancelSpotInstanceRequestsAsync
in interface AmazonEC2Async
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.public Future<AttachVolumeResult> attachVolumeAsync(AttachVolumeRequest attachVolumeRequest) throws AmazonServiceException, AmazonClientException
Attach a previously created volume to a running instance.
attachVolumeAsync
in interface AmazonEC2Async
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.public 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.
purchaseReservedInstancesOfferingAsync
in interface AmazonEC2Async
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.public 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.
resetImageAttributeAsync
in interface AmazonEC2Async
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.public Future<DescribeVpnConnectionsResult> describeVpnConnectionsAsync(DescribeVpnConnectionsRequest describeVpnConnectionsRequest) throws AmazonServiceException, AmazonClientException
Gives you information about your VPN connections.
IMPORTANT: We strongly recommend you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway. You can filter the results to return information only about VPN connections that match criteria you specify. For example, you could ask to get information about a particular VPN connection (or all) only if the VPN's state is pending or available. You can specify multiple filters (e.g., the VPN connection is associated with a particular VPN gateway, and the gateway's state is pending or available). The result includes information for a particular VPN connection only if the VPN connection matches all your filters. If there's no match, no special message is returned; the response is simply empty. The following table shows the available filters.
describeVpnConnectionsAsync
in interface AmazonEC2Async
describeVpnConnectionsRequest
- Container for the necessary
parameters to execute the DescribeVpnConnections 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.public 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.
createSnapshotAsync
in interface AmazonEC2Async
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.public 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.
deleteVolumeAsync
in interface AmazonEC2Async
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.public Future<Void> modifySnapshotAttributeAsync(ModifySnapshotAttributeRequest modifySnapshotAttributeRequest) throws AmazonServiceException, AmazonClientException
Adds or remove permission settings for the specified snapshot.
modifySnapshotAttributeAsync
in interface AmazonEC2Async
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.public 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).
terminateInstancesAsync
in interface AmazonEC2Async
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.public 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 .
deleteSpotDatafeedSubscriptionAsync
in interface AmazonEC2Async
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.public Future<DescribeVpcsResult> describeVpcsAsync(DescribeVpcsRequest describeVpcsRequest) throws AmazonServiceException, AmazonClientException
Gives you information about your VPCs. You can filter the results to return information only about VPCs that match criteria you specify. For example, you could ask to get information about a particular VPC or VPCs (or all your VPCs) only if the VPC's state is available. You can specify multiple filters (e.g., the VPC uses one of several sets of DHCP options, and the VPC's state is available). The result includes information for a particular VPC only if the VPC matches all your filters. If there's no match, no special message is returned; the response is simply empty. The following table shows the available filters.
describeVpcsAsync
in interface AmazonEC2Async
describeVpcsRequest
- Container for the necessary parameters to
execute the DescribeVpcs 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.public Future<Void> 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.
associateAddressAsync
in interface AmazonEC2Async
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.public Future<DescribeSnapshotAttributeResult> describeSnapshotAttributeAsync(DescribeSnapshotAttributeRequest describeSnapshotAttributeRequest) throws AmazonServiceException, AmazonClientException
Returns information about an attribute of a snapshot. Only one attribute can be specified per call.
describeSnapshotAttributeAsync
in interface AmazonEC2Async
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.public Future<Void> deleteCustomerGatewayAsync(DeleteCustomerGatewayRequest deleteCustomerGatewayRequest) throws AmazonServiceException, AmazonClientException
Deletes a customer gateway. You must delete the VPN connection before deleting the customer gateway.
You can have a single active customer gateway per AWS account (active means that you've created a VPN connection with that customer gateway). AWS might delete any customer gateway you leave inactive for an extended period of time.
deleteCustomerGatewayAsync
in interface AmazonEC2Async
deleteCustomerGatewayRequest
- Container for the necessary
parameters to execute the DeleteCustomerGateway 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.public Future<DescribeAddressesResult> describeAddressesAsync(DescribeAddressesRequest describeAddressesRequest) throws AmazonServiceException, AmazonClientException
The DescribeAddresses operation lists elastic IP addresses assigned to your account.
describeAddressesAsync
in interface AmazonEC2Async
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.public 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.
describeKeyPairsAsync
in interface AmazonEC2Async
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.public 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.
describeImageAttributeAsync
in interface AmazonEC2Async
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.public 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.
confirmProductInstanceAsync
in interface AmazonEC2Async
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.public Future<CreateVolumeResult> createVolumeAsync(CreateVolumeRequest createVolumeRequest) throws AmazonServiceException, AmazonClientException
Initializes an empty volume of a given size.
createVolumeAsync
in interface AmazonEC2Async
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.public Future<DescribeVpnGatewaysResult> describeVpnGatewaysAsync(DescribeVpnGatewaysRequest describeVpnGatewaysRequest) throws AmazonServiceException, AmazonClientException
Gives you information about your VPN gateways. You can filter the results to return information only about VPN gateways that match criteria you specify. For example, you could ask to get information about a particular VPN gateway (or all) only if the gateway's state is pending or available. You can specify multiple filters (e.g., the VPN gateway is in a particular Availability Zone and the gateway's state is pending or available). The result includes information for a particular VPN gateway only if the gateway matches all your filters. If there's no match, no special message is returned; the response is simply empty. The following table shows the available filters.
describeVpnGatewaysAsync
in interface AmazonEC2Async
describeVpnGatewaysRequest
- Container for the necessary
parameters to execute the DescribeVpnGateways 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.public Future<CreateSubnetResult> createSubnetAsync(CreateSubnetRequest createSubnetRequest) throws AmazonServiceException, AmazonClientException
Creates a subnet in an existing VPC. You can create up to 20 subnets in a VPC. If you add more than one subnet to a VPC, they're set up in a star topology with a logical router in the middle. When you create each subnet, you provide the VPC ID and the CIDR block you want for the subnet. Once you create a subnet, you can't change its CIDR block. The subnet's CIDR block can be the same as the VPC's CIDR block (assuming you want only a single subnet in the VPC), or a subset of the VPC's CIDR block. If you create more than one subnet in a VPC, the subnets' CIDR blocks must not overlap. The smallest subnet (and VPC) you can create uses a /28 netmask (16 IP addresses), and the largest uses a /18 netmask (16,384 IP addresses).
IMPORTANT: AWS reserves both the first four and the last IP address in each subnet's CIDR block. They're not available for use.
createSubnetAsync
in interface AmazonEC2Async
createSubnetRequest
- Container for the necessary parameters to
execute the CreateSubnet 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.public 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.
describeReservedInstancesOfferingsAsync
in interface AmazonEC2Async
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.public Future<DescribeVolumesResult> describeVolumesAsync(DescribeVolumesRequest describeVolumesRequest) throws AmazonServiceException, AmazonClientException
Describes the status of the indicated or, in lieu of any specified, all volumes belonging to the caller. Volumes that have been deleted are not described.
describeVolumesAsync
in interface AmazonEC2Async
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.public Future<Void> deleteSnapshotAsync(DeleteSnapshotRequest deleteSnapshotRequest) throws AmazonServiceException, AmazonClientException
Deletes the snapshot identified by snapshotId.
deleteSnapshotAsync
in interface AmazonEC2Async
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.public Future<DescribeDhcpOptionsResult> describeDhcpOptionsAsync(DescribeDhcpOptionsRequest describeDhcpOptionsRequest) throws AmazonServiceException, AmazonClientException
Gives you information about one or more sets of DHCP options. You can specify one or more DHCP options set IDs, or no IDs (to describe all your sets of DHCP options). The returned information consists of:
describeDhcpOptionsAsync
in interface AmazonEC2Async
describeDhcpOptionsRequest
- Container for the necessary
parameters to execute the DescribeDhcpOptions 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.public Future<MonitorInstancesResult> monitorInstancesAsync(MonitorInstancesRequest monitorInstancesRequest) throws AmazonServiceException, AmazonClientException
Enables monitoring for a running instance.
monitorInstancesAsync
in interface AmazonEC2Async
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.public 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.
disassociateAddressAsync
in interface AmazonEC2Async
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.public 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.
describeBundleTasksAsync
in interface AmazonEC2Async
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.public 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.
bundleInstanceAsync
in interface AmazonEC2Async
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.public 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 is might occur, .
When revoking a user/group pair permission, GroupName, SourceSecurityGroupName and SourceSecurityGroupOwnerId must be specified. When authorizing a CIDR IP permission, GroupName, IpProtocol, FromPort, ToPort and CidrIp must be specified. Mixing these two types of parameters is not allowed.
revokeSecurityGroupIngressAsync
in interface AmazonEC2Async
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.public Future<Void> deleteVpcAsync(DeleteVpcRequest deleteVpcRequest) throws AmazonServiceException, AmazonClientException
Deletes a VPC. You must terminate all running instances and delete all subnets before deleting the VPC, otherwise Amazon VPC returns an error.
deleteVpcAsync
in interface AmazonEC2Async
deleteVpcRequest
- Container for the necessary parameters to
execute the DeleteVpc 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.public 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.
getConsoleOutputAsync
in interface AmazonEC2Async
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.public Future<AllocateAddressResult> allocateAddressAsync(AllocateAddressRequest allocateAddressRequest) throws AmazonServiceException, AmazonClientException
The AllocateAddress operation acquires an elastic IP address for use with your account.
allocateAddressAsync
in interface AmazonEC2Async
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.public Future<Void> modifyImageAttributeAsync(ModifyImageAttributeRequest modifyImageAttributeRequest) throws AmazonServiceException, AmazonClientException
The ModifyImageAttribute operation modifies an attribute of an AMI.
modifyImageAttributeAsync
in interface AmazonEC2Async
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.public 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.
releaseAddressAsync
in interface AmazonEC2Async
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.public Future<CreateCustomerGatewayResult> createCustomerGatewayAsync(CreateCustomerGatewayRequest createCustomerGatewayRequest) throws AmazonServiceException, AmazonClientException
Provides information to AWS about your customer gateway device. The customer gateway is the appliance at your end of the VPN connection (compared to the VPN gateway, which is the device at the AWS side of the VPN connection). You can have a single active customer gateway per AWS account (active means that you've created a VPN connection to use with the customer gateway). AWS might delete any customer gateway that you create with this operation if you leave it inactive for an extended period of time.
You must provide the Internet-routable IP address of the customer gateway's external interface. The IP address must be static.
You must also provide the device's Border Gateway Protocol (BGP) Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already, you can use a private ASN (in the 64512 - 65534 range). For more information about ASNs, go to http://en.wikipedia.org/wiki/Autonomous_system_%28Internet%29 .
createCustomerGatewayAsync
in interface AmazonEC2Async
createCustomerGatewayRequest
- Container for the necessary
parameters to execute the CreateCustomerGateway 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.public Future<Void> resetInstanceAttributeAsync(ResetInstanceAttributeRequest resetInstanceAttributeRequest) throws AmazonServiceException, AmazonClientException
Resets an attribute of an instance to its default value.
resetInstanceAttributeAsync
in interface AmazonEC2Async
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.public 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 .
createSpotDatafeedSubscriptionAsync
in interface AmazonEC2Async
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.public 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.
createKeyPairAsync
in interface AmazonEC2Async
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.public Future<DescribeSnapshotsResult> describeSnapshotsAsync(DescribeSnapshotsRequest describeSnapshotsRequest) throws AmazonServiceException, AmazonClientException
Describes the indicated snapshots, or in lieu of that, all snapshots owned by the caller.
describeSnapshotsAsync
in interface AmazonEC2Async
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.public 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.
registerImageAsync
in interface AmazonEC2Async
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.public Future<Void> deleteVpnConnectionAsync(DeleteVpnConnectionRequest deleteVpnConnectionRequest) throws AmazonServiceException, AmazonClientException
Deletes a VPN connection. Use this if you want to delete a VPC and all its associated components. Another reason to use this operation is if you believe the tunnel credentials for your VPN connection have been compromised. In that situation, you can delete the VPN connection and create a new one that has new keys, without needing to delete the VPC or VPN gateway. If you create a new VPN connection, you must reconfigure the customer gateway using the new configuration information returned with the new VPN connection ID.
If you're deleting the VPC and all its associated parts, we recommend you detach the VPN gateway from the VPC and delete the VPC before deleting the VPN connection.
deleteVpnConnectionAsync
in interface AmazonEC2Async
deleteVpnConnectionRequest
- Container for the necessary
parameters to execute the DeleteVpnConnection 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.public Future<CreateVpnConnectionResult> createVpnConnectionAsync(CreateVpnConnectionRequest createVpnConnectionRequest) throws AmazonServiceException, AmazonClientException
Creates a new VPN connection between an existing VPN gateway and customer gateway. The only supported connection type is ipsec.1.
The response includes information that you need to configure your customer gateway, in XML format. We recommend you use the command line version of this operation (ec2-create-vpn-connection), which takes an -f option (for format) and returns configuration information formatted as expected by the vendor you specified, or in a generic, human readable format. For information about the command, go to ec2-create-vpn-connection in the Amazon Virtual Private Cloud Command Line Reference.
IMPORTANT: We strongly recommend you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway. If you decide to shut down your VPN connection for any reason and then create a new one, you must re-configure your customer gateway with the new information returned from this call.
createVpnConnectionAsync
in interface AmazonEC2Async
createVpnConnectionRequest
- Container for the necessary
parameters to execute the CreateVpnConnection 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.public Future<DescribeInstanceAttributeResult> describeInstanceAttributeAsync(DescribeInstanceAttributeRequest describeInstanceAttributeRequest) throws AmazonServiceException, AmazonClientException
Returns information about an attribute of an instance. Only one attribute can be specified per call.
describeInstanceAttributeAsync
in interface AmazonEC2Async
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.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |