|
Did this page help you?Yes No Tell us about it... |
||||||
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
public class AmazonEC2Client
Client for accessing AmazonEC2. All service calls made using this client are blocking, and will not return until the service call completes.
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 | |
---|---|
AmazonEC2Client()
Constructs a new client to invoke service methods on AmazonEC2. |
|
AmazonEC2Client(AWSCredentials awsCredentials)
Constructs a new client to invoke service methods on AmazonEC2 using the specified AWS account credentials. |
|
AmazonEC2Client(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on AmazonEC2 using the specified AWS account credentials and client configuration options. |
|
AmazonEC2Client(AWSCredentialsProvider awsCredentialsProvider)
Constructs a new client to invoke service methods on AmazonEC2 using the specified AWS account credentials provider. |
|
AmazonEC2Client(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on AmazonEC2 using the specified AWS account credentials provider and client configuration options. |
|
AmazonEC2Client(ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on AmazonEC2. |
Method Summary | |
---|---|
void |
activateLicense(ActivateLicenseRequest activateLicenseRequest)
Activates a specific number of licenses for a 90-day period. |
AllocateAddressResult |
allocateAddress()
The AllocateAddress operation acquires an elastic IP address for use with your account. |
AllocateAddressResult |
allocateAddress(AllocateAddressRequest allocateAddressRequest)
The AllocateAddress operation acquires an elastic IP address for use with your account. |
void |
assignPrivateIpAddresses(AssignPrivateIpAddressesRequest assignPrivateIpAddressesRequest)
|
AssociateAddressResult |
associateAddress(AssociateAddressRequest associateAddressRequest)
The AssociateAddress operation associates an elastic IP address with an instance. |
void |
associateDhcpOptions(AssociateDhcpOptionsRequest associateDhcpOptionsRequest)
Associates a set of DHCP options (that you've previously created) with the specified VPC. |
AssociateRouteTableResult |
associateRouteTable(AssociateRouteTableRequest associateRouteTableRequest)
Associates a subnet with a route table. |
void |
attachInternetGateway(AttachInternetGatewayRequest attachInternetGatewayRequest)
Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC. |
AttachNetworkInterfaceResult |
attachNetworkInterface(AttachNetworkInterfaceRequest attachNetworkInterfaceRequest)
|
AttachVolumeResult |
attachVolume(AttachVolumeRequest attachVolumeRequest)
Attach a previously created volume to a running instance. |
AttachVpnGatewayResult |
attachVpnGateway(AttachVpnGatewayRequest attachVpnGatewayRequest)
Attaches a VPN gateway to a VPC. |
void |
authorizeSecurityGroupEgress(AuthorizeSecurityGroupEgressRequest authorizeSecurityGroupEgressRequest)
This action applies only to security groups in a VPC; it's not supported for EC2 security groups. |
void |
authorizeSecurityGroupIngress()
The AuthorizeSecurityGroupIngress operation adds permissions to a security group. |
void |
authorizeSecurityGroupIngress(AuthorizeSecurityGroupIngressRequest authorizeSecurityGroupIngressRequest)
The AuthorizeSecurityGroupIngress operation adds permissions to a security group. |
BundleInstanceResult |
bundleInstance(BundleInstanceRequest bundleInstanceRequest)
The BundleInstance operation request that an instance is bundled the next time it boots. |
CancelBundleTaskResult |
cancelBundleTask(CancelBundleTaskRequest cancelBundleTaskRequest)
CancelBundleTask operation cancels a pending or in-progress bundling task. |
void |
cancelConversionTask(CancelConversionTaskRequest cancelConversionTaskRequest)
|
void |
cancelExportTask(CancelExportTaskRequest cancelExportTaskRequest)
|
CancelSpotInstanceRequestsResult |
cancelSpotInstanceRequests(CancelSpotInstanceRequestsRequest cancelSpotInstanceRequestsRequest)
Cancels one or more Spot Instance requests. |
ConfirmProductInstanceResult |
confirmProductInstance(ConfirmProductInstanceRequest confirmProductInstanceRequest)
The ConfirmProductInstance operation returns true if the specified product code is attached to the specified instance. |
CreateCustomerGatewayResult |
createCustomerGateway(CreateCustomerGatewayRequest createCustomerGatewayRequest)
Provides information to AWS about your customer gateway device. |
CreateDhcpOptionsResult |
createDhcpOptions(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. |
CreateImageResult |
createImage(CreateImageRequest createImageRequest)
Creates an Amazon EBS-backed AMI from a "running" or "stopped" instance. |
CreateInstanceExportTaskResult |
createInstanceExportTask(CreateInstanceExportTaskRequest createInstanceExportTaskRequest)
|
CreateInternetGatewayResult |
createInternetGateway()
Creates a new Internet gateway in your AWS account. |
CreateInternetGatewayResult |
createInternetGateway(CreateInternetGatewayRequest createInternetGatewayRequest)
Creates a new Internet gateway in your AWS account. |
CreateKeyPairResult |
createKeyPair(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. |
CreateNetworkAclResult |
createNetworkAcl(CreateNetworkAclRequest createNetworkAclRequest)
Creates a new network ACL in a VPC. |
void |
createNetworkAclEntry(CreateNetworkAclEntryRequest createNetworkAclEntryRequest)
Creates an entry (i.e., rule) in a network ACL with a rule number you specify. |
CreateNetworkInterfaceResult |
createNetworkInterface(CreateNetworkInterfaceRequest createNetworkInterfaceRequest)
|
void |
createPlacementGroup(CreatePlacementGroupRequest createPlacementGroupRequest)
Creates a PlacementGroup into which multiple Amazon EC2 instances can be launched. |
void |
createRoute(CreateRouteRequest createRouteRequest)
Creates a new route in a route table within a VPC. |
CreateRouteTableResult |
createRouteTable(CreateRouteTableRequest createRouteTableRequest)
Creates a new route table within a VPC. |
CreateSecurityGroupResult |
createSecurityGroup(CreateSecurityGroupRequest createSecurityGroupRequest)
The CreateSecurityGroup operation creates a new security group. |
CreateSnapshotResult |
createSnapshot(CreateSnapshotRequest createSnapshotRequest)
Create a snapshot of the volume identified by volume ID. |
CreateSpotDatafeedSubscriptionResult |
createSpotDatafeedSubscription(CreateSpotDatafeedSubscriptionRequest createSpotDatafeedSubscriptionRequest)
Creates the data feed for Spot Instances, enabling you to view Spot Instance usage logs. |
CreateSubnetResult |
createSubnet(CreateSubnetRequest createSubnetRequest)
Creates a subnet in an existing VPC. |
void |
createTags(CreateTagsRequest createTagsRequest)
Adds or overwrites tags for the specified resources. |
CreateVolumeResult |
createVolume(CreateVolumeRequest createVolumeRequest)
Initializes an empty volume of a given size. |
CreateVpcResult |
createVpc(CreateVpcRequest createVpcRequest)
Creates a VPC with the CIDR block you specify. |
CreateVpnConnectionResult |
createVpnConnection(CreateVpnConnectionRequest createVpnConnectionRequest)
Creates a new VPN connection between an existing VPN gateway and customer gateway. |
CreateVpnGatewayResult |
createVpnGateway(CreateVpnGatewayRequest createVpnGatewayRequest)
Creates a new VPN gateway. |
void |
deactivateLicense(DeactivateLicenseRequest deactivateLicenseRequest)
Deactivates a specific number of licenses. |
void |
deleteCustomerGateway(DeleteCustomerGatewayRequest deleteCustomerGatewayRequest)
Deletes a customer gateway. |
void |
deleteDhcpOptions(DeleteDhcpOptionsRequest deleteDhcpOptionsRequest)
Deletes a set of DHCP options that you specify. |
void |
deleteInternetGateway(DeleteInternetGatewayRequest deleteInternetGatewayRequest)
Deletes an Internet gateway from your AWS account. |
void |
deleteKeyPair(DeleteKeyPairRequest deleteKeyPairRequest)
The DeleteKeyPair operation deletes a key pair. |
void |
deleteNetworkAcl(DeleteNetworkAclRequest deleteNetworkAclRequest)
Deletes a network ACL from a VPC. |
void |
deleteNetworkAclEntry(DeleteNetworkAclEntryRequest deleteNetworkAclEntryRequest)
Deletes an ingress or egress entry (i.e., rule) from a network ACL. |
void |
deleteNetworkInterface(DeleteNetworkInterfaceRequest deleteNetworkInterfaceRequest)
|
void |
deletePlacementGroup(DeletePlacementGroupRequest deletePlacementGroupRequest)
Deletes a PlacementGroup from a user's account. |
void |
deleteRoute(DeleteRouteRequest deleteRouteRequest)
Deletes a route from a route table in a VPC. |
void |
deleteRouteTable(DeleteRouteTableRequest deleteRouteTableRequest)
Deletes a route table from a VPC. |
void |
deleteSecurityGroup()
The DeleteSecurityGroup operation deletes a security group. |
void |
deleteSecurityGroup(DeleteSecurityGroupRequest deleteSecurityGroupRequest)
The DeleteSecurityGroup operation deletes a security group. |
void |
deleteSnapshot(DeleteSnapshotRequest deleteSnapshotRequest)
Deletes the snapshot identified by snapshotId . |
void |
deleteSpotDatafeedSubscription()
Deletes the data feed for Spot Instances. |
void |
deleteSpotDatafeedSubscription(DeleteSpotDatafeedSubscriptionRequest deleteSpotDatafeedSubscriptionRequest)
Deletes the data feed for Spot Instances. |
void |
deleteSubnet(DeleteSubnetRequest deleteSubnetRequest)
Deletes a subnet from a VPC. |
void |
deleteTags(DeleteTagsRequest deleteTagsRequest)
Deletes tags from the specified Amazon EC2 resources. |
void |
deleteVolume(DeleteVolumeRequest deleteVolumeRequest)
Deletes a previously created volume. |
void |
deleteVpc(DeleteVpcRequest deleteVpcRequest)
Deletes a VPC. |
void |
deleteVpnConnection(DeleteVpnConnectionRequest deleteVpnConnectionRequest)
Deletes a VPN connection. |
void |
deleteVpnGateway(DeleteVpnGatewayRequest deleteVpnGatewayRequest)
Deletes a VPN gateway. |
void |
deregisterImage(DeregisterImageRequest deregisterImageRequest)
The DeregisterImage operation deregisters an AMI. |
DescribeAddressesResult |
describeAddresses()
The DescribeAddresses operation lists elastic IP addresses assigned to your account. |
DescribeAddressesResult |
describeAddresses(DescribeAddressesRequest describeAddressesRequest)
The DescribeAddresses operation lists elastic IP addresses assigned to your account. |
DescribeAvailabilityZonesResult |
describeAvailabilityZones()
The DescribeAvailabilityZones operation describes availability zones that are currently available to the account and their states. |
DescribeAvailabilityZonesResult |
describeAvailabilityZones(DescribeAvailabilityZonesRequest describeAvailabilityZonesRequest)
The DescribeAvailabilityZones operation describes availability zones that are currently available to the account and their states. |
DescribeBundleTasksResult |
describeBundleTasks()
The DescribeBundleTasks operation describes in-progress and recent bundle tasks. |
DescribeBundleTasksResult |
describeBundleTasks(DescribeBundleTasksRequest describeBundleTasksRequest)
The DescribeBundleTasks operation describes in-progress and recent bundle tasks. |
DescribeConversionTasksResult |
describeConversionTasks()
|
DescribeConversionTasksResult |
describeConversionTasks(DescribeConversionTasksRequest describeConversionTasksRequest)
|
DescribeCustomerGatewaysResult |
describeCustomerGateways()
Gives you information about your customer gateways. |
DescribeCustomerGatewaysResult |
describeCustomerGateways(DescribeCustomerGatewaysRequest describeCustomerGatewaysRequest)
Gives you information about your customer gateways. |
DescribeDhcpOptionsResult |
describeDhcpOptions()
Gives you information about one or more sets of DHCP options. |
DescribeDhcpOptionsResult |
describeDhcpOptions(DescribeDhcpOptionsRequest describeDhcpOptionsRequest)
Gives you information about one or more sets of DHCP options. |
DescribeExportTasksResult |
describeExportTasks()
|
DescribeExportTasksResult |
describeExportTasks(DescribeExportTasksRequest describeExportTasksRequest)
|
DescribeImageAttributeResult |
describeImageAttribute(DescribeImageAttributeRequest describeImageAttributeRequest)
The DescribeImageAttribute operation returns information about an attribute of an AMI. |
DescribeImagesResult |
describeImages()
The DescribeImages operation returns information about AMIs, AKIs, and ARIs available to the user. |
DescribeImagesResult |
describeImages(DescribeImagesRequest describeImagesRequest)
The DescribeImages operation returns information about AMIs, AKIs, and ARIs available to the user. |
DescribeInstanceAttributeResult |
describeInstanceAttribute(DescribeInstanceAttributeRequest describeInstanceAttributeRequest)
Returns information about an attribute of an instance. |
DescribeInstancesResult |
describeInstances()
The DescribeInstances operation returns information about instances that you own. |
DescribeInstancesResult |
describeInstances(DescribeInstancesRequest describeInstancesRequest)
The DescribeInstances operation returns information about instances that you own. |
DescribeInstanceStatusResult |
describeInstanceStatus()
Describes the status of an Amazon Elastic Compute Cloud (Amazon EC2) instance. |
DescribeInstanceStatusResult |
describeInstanceStatus(DescribeInstanceStatusRequest describeInstanceStatusRequest)
Describes the status of an Amazon Elastic Compute Cloud (Amazon EC2) instance. |
DescribeInternetGatewaysResult |
describeInternetGateways()
Gives you information about your Internet gateways. |
DescribeInternetGatewaysResult |
describeInternetGateways(DescribeInternetGatewaysRequest describeInternetGatewaysRequest)
Gives you information about your Internet gateways. |
DescribeKeyPairsResult |
describeKeyPairs()
The DescribeKeyPairs operation returns information about key pairs available to you. |
DescribeKeyPairsResult |
describeKeyPairs(DescribeKeyPairsRequest describeKeyPairsRequest)
The DescribeKeyPairs operation returns information about key pairs available to you. |
DescribeLicensesResult |
describeLicenses()
Provides details of a user's registered licenses. |
DescribeLicensesResult |
describeLicenses(DescribeLicensesRequest describeLicensesRequest)
Provides details of a user's registered licenses. |
DescribeNetworkAclsResult |
describeNetworkAcls()
Gives you information about the network ACLs in your VPC. |
DescribeNetworkAclsResult |
describeNetworkAcls(DescribeNetworkAclsRequest describeNetworkAclsRequest)
Gives you information about the network ACLs in your VPC. |
DescribeNetworkInterfaceAttributeResult |
describeNetworkInterfaceAttribute(DescribeNetworkInterfaceAttributeRequest describeNetworkInterfaceAttributeRequest)
|
DescribeNetworkInterfacesResult |
describeNetworkInterfaces()
|
DescribeNetworkInterfacesResult |
describeNetworkInterfaces(DescribeNetworkInterfacesRequest describeNetworkInterfacesRequest)
|
DescribePlacementGroupsResult |
describePlacementGroups()
Returns information about one or more PlacementGroup instances in a user's account. |
DescribePlacementGroupsResult |
describePlacementGroups(DescribePlacementGroupsRequest describePlacementGroupsRequest)
Returns information about one or more PlacementGroup instances in a user's account. |
DescribeRegionsResult |
describeRegions()
The DescribeRegions operation describes regions zones that are currently available to the account. |
DescribeRegionsResult |
describeRegions(DescribeRegionsRequest describeRegionsRequest)
The DescribeRegions operation describes regions zones that are currently available to the account. |
DescribeReservedInstancesResult |
describeReservedInstances()
The DescribeReservedInstances operation describes Reserved Instances that were purchased for use with your account. |
DescribeReservedInstancesResult |
describeReservedInstances(DescribeReservedInstancesRequest describeReservedInstancesRequest)
The DescribeReservedInstances operation describes Reserved Instances that were purchased for use with your account. |
DescribeReservedInstancesOfferingsResult |
describeReservedInstancesOfferings()
The DescribeReservedInstancesOfferings operation describes Reserved Instance offerings that are available for purchase. |
DescribeReservedInstancesOfferingsResult |
describeReservedInstancesOfferings(DescribeReservedInstancesOfferingsRequest describeReservedInstancesOfferingsRequest)
The DescribeReservedInstancesOfferings operation describes Reserved Instance offerings that are available for purchase. |
DescribeRouteTablesResult |
describeRouteTables()
Gives you information about your route tables. |
DescribeRouteTablesResult |
describeRouteTables(DescribeRouteTablesRequest describeRouteTablesRequest)
Gives you information about your route tables. |
DescribeSecurityGroupsResult |
describeSecurityGroups()
The DescribeSecurityGroups operation returns information about security groups that you own. |
DescribeSecurityGroupsResult |
describeSecurityGroups(DescribeSecurityGroupsRequest describeSecurityGroupsRequest)
The DescribeSecurityGroups operation returns information about security groups that you own. |
DescribeSnapshotAttributeResult |
describeSnapshotAttribute(DescribeSnapshotAttributeRequest describeSnapshotAttributeRequest)
Returns information about an attribute of a snapshot. |
DescribeSnapshotsResult |
describeSnapshots()
Returns information about the Amazon EBS snapshots available to you. |
DescribeSnapshotsResult |
describeSnapshots(DescribeSnapshotsRequest describeSnapshotsRequest)
Returns information about the Amazon EBS snapshots available to you. |
DescribeSpotDatafeedSubscriptionResult |
describeSpotDatafeedSubscription()
Describes the data feed for Spot Instances. |
DescribeSpotDatafeedSubscriptionResult |
describeSpotDatafeedSubscription(DescribeSpotDatafeedSubscriptionRequest describeSpotDatafeedSubscriptionRequest)
Describes the data feed for Spot Instances. |
DescribeSpotInstanceRequestsResult |
describeSpotInstanceRequests()
Describes Spot Instance requests. |
DescribeSpotInstanceRequestsResult |
describeSpotInstanceRequests(DescribeSpotInstanceRequestsRequest describeSpotInstanceRequestsRequest)
Describes Spot Instance requests. |
DescribeSpotPriceHistoryResult |
describeSpotPriceHistory()
Describes the Spot Price history. |
DescribeSpotPriceHistoryResult |
describeSpotPriceHistory(DescribeSpotPriceHistoryRequest describeSpotPriceHistoryRequest)
Describes the Spot Price history. |
DescribeSubnetsResult |
describeSubnets()
Gives you information about your subnets. |
DescribeSubnetsResult |
describeSubnets(DescribeSubnetsRequest describeSubnetsRequest)
Gives you information about your subnets. |
DescribeTagsResult |
describeTags()
Describes the tags for the specified resources. |
DescribeTagsResult |
describeTags(DescribeTagsRequest describeTagsRequest)
Describes the tags for the specified resources. |
DescribeVolumeAttributeResult |
describeVolumeAttribute(DescribeVolumeAttributeRequest describeVolumeAttributeRequest)
|
DescribeVolumesResult |
describeVolumes()
Describes the status of the indicated volume or, in lieu of any specified, all volumes belonging to the caller. |
DescribeVolumesResult |
describeVolumes(DescribeVolumesRequest describeVolumesRequest)
Describes the status of the indicated volume or, in lieu of any specified, all volumes belonging to the caller. |
DescribeVolumeStatusResult |
describeVolumeStatus()
Describes the status of a volume. |
DescribeVolumeStatusResult |
describeVolumeStatus(DescribeVolumeStatusRequest describeVolumeStatusRequest)
Describes the status of a volume. |
DescribeVpcsResult |
describeVpcs()
Gives you information about your VPCs. |
DescribeVpcsResult |
describeVpcs(DescribeVpcsRequest describeVpcsRequest)
Gives you information about your VPCs. |
DescribeVpnConnectionsResult |
describeVpnConnections()
Gives you information about your VPN connections. |
DescribeVpnConnectionsResult |
describeVpnConnections(DescribeVpnConnectionsRequest describeVpnConnectionsRequest)
Gives you information about your VPN connections. |
DescribeVpnGatewaysResult |
describeVpnGateways()
Gives you information about your VPN gateways. |
DescribeVpnGatewaysResult |
describeVpnGateways(DescribeVpnGatewaysRequest describeVpnGatewaysRequest)
Gives you information about your VPN gateways. |
void |
detachInternetGateway(DetachInternetGatewayRequest detachInternetGatewayRequest)
Detaches an Internet gateway from a VPC, disabling connectivity between the Internet and the VPC. |
void |
detachNetworkInterface(DetachNetworkInterfaceRequest detachNetworkInterfaceRequest)
|
DetachVolumeResult |
detachVolume(DetachVolumeRequest detachVolumeRequest)
Detach a previously attached volume from a running instance. |
void |
detachVpnGateway(DetachVpnGatewayRequest detachVpnGatewayRequest)
Detaches a VPN gateway from a VPC. |
void |
disassociateAddress(DisassociateAddressRequest disassociateAddressRequest)
The DisassociateAddress operation disassociates the specified elastic IP address from the instance to which it is assigned. |
void |
disassociateRouteTable(DisassociateRouteTableRequest disassociateRouteTableRequest)
Disassociates a subnet from a route table. |
void |
enableVolumeIO(EnableVolumeIORequest enableVolumeIORequest)
Enable IO on the volume after an event has occured. |
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected. |
GetConsoleOutputResult |
getConsoleOutput(GetConsoleOutputRequest getConsoleOutputRequest)
The GetConsoleOutput operation retrieves console output for the specified instance. |
GetPasswordDataResult |
getPasswordData(GetPasswordDataRequest getPasswordDataRequest)
Retrieves the encrypted administrator password for the instances running Windows. |
ImportInstanceResult |
importInstance(ImportInstanceRequest importInstanceRequest)
|
ImportKeyPairResult |
importKeyPair(ImportKeyPairRequest importKeyPairRequest)
Imports the public key from an RSA key pair created with a third-party tool. |
ImportVolumeResult |
importVolume()
|
ImportVolumeResult |
importVolume(ImportVolumeRequest importVolumeRequest)
|
void |
modifyImageAttribute(ModifyImageAttributeRequest modifyImageAttributeRequest)
The ModifyImageAttribute operation modifies an attribute of an AMI. |
void |
modifyInstanceAttribute(ModifyInstanceAttributeRequest modifyInstanceAttributeRequest)
Modifies an attribute of an instance. |
void |
modifyNetworkInterfaceAttribute(ModifyNetworkInterfaceAttributeRequest modifyNetworkInterfaceAttributeRequest)
|
void |
modifySnapshotAttribute(ModifySnapshotAttributeRequest modifySnapshotAttributeRequest)
Adds or remove permission settings for the specified snapshot. |
void |
modifyVolumeAttribute(ModifyVolumeAttributeRequest modifyVolumeAttributeRequest)
|
MonitorInstancesResult |
monitorInstances(MonitorInstancesRequest monitorInstancesRequest)
Enables monitoring for a running instance. |
PurchaseReservedInstancesOfferingResult |
purchaseReservedInstancesOffering(PurchaseReservedInstancesOfferingRequest purchaseReservedInstancesOfferingRequest)
The PurchaseReservedInstancesOffering operation purchases a Reserved Instance for use with your account. |
void |
rebootInstances(RebootInstancesRequest rebootInstancesRequest)
The RebootInstances operation requests a reboot of one or more instances. |
RegisterImageResult |
registerImage()
The RegisterImage operation registers an AMI with Amazon EC2. |
RegisterImageResult |
registerImage(RegisterImageRequest registerImageRequest)
The RegisterImage operation registers an AMI with Amazon EC2. |
void |
releaseAddress()
The ReleaseAddress operation releases an elastic IP address associated with your account. |
void |
releaseAddress(ReleaseAddressRequest releaseAddressRequest)
The ReleaseAddress operation releases an elastic IP address associated with your account. |
ReplaceNetworkAclAssociationResult |
replaceNetworkAclAssociation(ReplaceNetworkAclAssociationRequest replaceNetworkAclAssociationRequest)
Changes which network ACL a subnet is associated with. |
void |
replaceNetworkAclEntry(ReplaceNetworkAclEntryRequest replaceNetworkAclEntryRequest)
Replaces an entry (i.e., rule) in a network ACL. |
void |
replaceRoute(ReplaceRouteRequest replaceRouteRequest)
Replaces an existing route within a route table in a VPC. |
ReplaceRouteTableAssociationResult |
replaceRouteTableAssociation(ReplaceRouteTableAssociationRequest replaceRouteTableAssociationRequest)
Changes the route table associated with a given subnet in a VPC. |
void |
reportInstanceStatus()
|
void |
reportInstanceStatus(ReportInstanceStatusRequest reportInstanceStatusRequest)
|
RequestSpotInstancesResult |
requestSpotInstances(RequestSpotInstancesRequest requestSpotInstancesRequest)
Creates a Spot Instance request. |
void |
resetImageAttribute(ResetImageAttributeRequest resetImageAttributeRequest)
The ResetImageAttribute operation resets an attribute of an AMI to its default value. |
void |
resetInstanceAttribute(ResetInstanceAttributeRequest resetInstanceAttributeRequest)
Resets an attribute of an instance to its default value. |
void |
resetNetworkInterfaceAttribute(ResetNetworkInterfaceAttributeRequest resetNetworkInterfaceAttributeRequest)
|
void |
resetSnapshotAttribute(ResetSnapshotAttributeRequest resetSnapshotAttributeRequest)
Resets permission settings for the specified snapshot. |
void |
revokeSecurityGroupEgress(RevokeSecurityGroupEgressRequest revokeSecurityGroupEgressRequest)
This action applies only to security groups in a VPC. |
void |
revokeSecurityGroupIngress()
The RevokeSecurityGroupIngress operation revokes permissions from a security group. |
void |
revokeSecurityGroupIngress(RevokeSecurityGroupIngressRequest revokeSecurityGroupIngressRequest)
The RevokeSecurityGroupIngress operation revokes permissions from a security group. |
RunInstancesResult |
runInstances(RunInstancesRequest runInstancesRequest)
The RunInstances operation launches a specified number of instances. |
StartInstancesResult |
startInstances(StartInstancesRequest startInstancesRequest)
Starts an instance that uses an Amazon EBS volume as its root device. |
StopInstancesResult |
stopInstances(StopInstancesRequest stopInstancesRequest)
Stops an instance that uses an Amazon EBS volume as its root device. |
TerminateInstancesResult |
terminateInstances(TerminateInstancesRequest terminateInstancesRequest)
The TerminateInstances operation shuts down one or more instances. |
void |
unassignPrivateIpAddresses(UnassignPrivateIpAddressesRequest unassignPrivateIpAddressesRequest)
|
UnmonitorInstancesResult |
unmonitorInstances(UnmonitorInstancesRequest unmonitorInstancesRequest)
Disables monitoring for a running instance. |
Methods inherited from class com.amazonaws.AmazonWebServiceClient |
---|
addRequestHandler, removeRequestHandler, setConfiguration, setEndpoint, shutdown |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface com.amazonaws.services.ec2.AmazonEC2 |
---|
setEndpoint, shutdown |
Constructor Detail |
---|
public AmazonEC2Client()
All service calls made using this new client object are blocking, and will not return until the service call completes.
DefaultAWSCredentialsProvider
public AmazonEC2Client(ClientConfiguration clientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
clientConfiguration
- The client configuration options controlling how this
client connects to AmazonEC2
(ex: proxy settings, retry counts, etc.).DefaultAWSCredentialsProvider
public AmazonEC2Client(AWSCredentials awsCredentials)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use
when authenticating with AWS services.public AmazonEC2Client(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use
when authenticating with AWS services.clientConfiguration
- The client configuration options controlling how this
client connects to AmazonEC2
(ex: proxy settings, retry counts, etc.).public AmazonEC2Client(AWSCredentialsProvider awsCredentialsProvider)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials
to authenticate requests with AWS services.public AmazonEC2Client(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials
to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this
client connects to AmazonEC2
(ex: proxy settings, retry counts, etc.).Method Detail |
---|
public void rebootInstances(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.
rebootInstances
in interface AmazonEC2
rebootInstancesRequest
- Container for the necessary parameters
to execute the RebootInstances service method 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 DescribeReservedInstancesResult describeReservedInstances(DescribeReservedInstancesRequest describeReservedInstancesRequest) throws AmazonServiceException, AmazonClientException
The DescribeReservedInstances operation describes Reserved Instances that were purchased for use with your account.
describeReservedInstances
in interface AmazonEC2
describeReservedInstancesRequest
- Container for the necessary
parameters to execute the DescribeReservedInstances service method 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 DescribeAvailabilityZonesResult describeAvailabilityZones(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.
describeAvailabilityZones
in interface AmazonEC2
describeAvailabilityZonesRequest
- Container for the necessary
parameters to execute the DescribeAvailabilityZones service method 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 DetachVolumeResult detachVolume(DetachVolumeRequest detachVolumeRequest) throws AmazonServiceException, AmazonClientException
Detach a previously attached volume from a running instance.
detachVolume
in interface AmazonEC2
detachVolumeRequest
- Container for the necessary parameters to
execute the DetachVolume service method 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 void deleteKeyPair(DeleteKeyPairRequest deleteKeyPairRequest) throws AmazonServiceException, AmazonClientException
The DeleteKeyPair operation deletes a key pair.
deleteKeyPair
in interface AmazonEC2
deleteKeyPairRequest
- Container for the necessary parameters to
execute the DeleteKeyPair service method 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 UnmonitorInstancesResult unmonitorInstances(UnmonitorInstancesRequest unmonitorInstancesRequest) throws AmazonServiceException, AmazonClientException
Disables monitoring for a running instance.
unmonitorInstances
in interface AmazonEC2
unmonitorInstancesRequest
- Container for the necessary
parameters to execute the UnmonitorInstances service method 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 AttachVpnGatewayResult attachVpnGateway(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.
attachVpnGateway
in interface AmazonEC2
attachVpnGatewayRequest
- Container for the necessary parameters
to execute the AttachVpnGateway service method 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 CreateImageResult createImage(CreateImageRequest createImageRequest) throws AmazonServiceException, AmazonClientException
Creates an Amazon EBS-backed AMI from a "running" or "stopped" instance. AMIs that use an Amazon EBS root device boot faster than AMIs that use instance stores. They can be up to 1 TiB in size, use storage that persists on instance failure, and can be stopped and started.
createImage
in interface AmazonEC2
createImageRequest
- Container for the necessary parameters to
execute the CreateImage service method 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 void deleteSecurityGroup(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.
deleteSecurityGroup
in interface AmazonEC2
deleteSecurityGroupRequest
- Container for the necessary
parameters to execute the DeleteSecurityGroup service method 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 CreateInstanceExportTaskResult createInstanceExportTask(CreateInstanceExportTaskRequest createInstanceExportTaskRequest) throws AmazonServiceException, AmazonClientException
createInstanceExportTask
in interface AmazonEC2
createInstanceExportTaskRequest
- Container for the necessary
parameters to execute the CreateInstanceExportTask service method 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 void authorizeSecurityGroupEgress(AuthorizeSecurityGroupEgressRequest authorizeSecurityGroupEgressRequest) throws AmazonServiceException, AmazonClientException
This action applies only to security groups in a VPC; it's not supported for EC2 security groups. For information about Amazon Virtual Private Cloud and VPC security groups, go to the Amazon Virtual Private Cloud User Guide.
The action adds one or more egress rules to a VPC security group. Specifically, this permits instances in a security group to send traffic to either one or more destination CIDR IP address ranges, or to one or more destination security groups in the same VPC.
Each rule consists of the protocol (e.g., TCP), plus either a CIDR
range, or a source group. For the TCP and UDP protocols, you must also
specify the destination port or port range. For the ICMP protocol, you
must also specify the ICMP type and code. You can use -1
as a wildcard for the ICMP type or code.
Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.
Important: For VPC security groups: You can have up to 50 rules total per group (covering both ingress and egress).
authorizeSecurityGroupEgress
in interface AmazonEC2
authorizeSecurityGroupEgressRequest
- Container for the necessary
parameters to execute the AuthorizeSecurityGroupEgress service method
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 GetPasswordDataResult getPasswordData(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.
getPasswordData
in interface AmazonEC2
getPasswordDataRequest
- Container for the necessary parameters
to execute the GetPasswordData service method 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 void associateDhcpOptions(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.
associateDhcpOptions
in interface AmazonEC2
associateDhcpOptionsRequest
- Container for the necessary
parameters to execute the AssociateDhcpOptions service method 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 StopInstancesResult stopInstances(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.
stopInstances
in interface AmazonEC2
stopInstancesRequest
- Container for the necessary parameters to
execute the StopInstances service method 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 ImportKeyPairResult importKeyPair(ImportKeyPairRequest importKeyPairRequest) throws AmazonServiceException, AmazonClientException
Imports the public key from an RSA key pair created with a third-party tool. This operation differs from CreateKeyPair as the private key is never transferred between the caller and AWS servers.
RSA key pairs are easily created on Microsoft Windows and Linux OS
systems using the ssh-keygen
command line tool provided
with the standard OpenSSH installation. Standard library support for
RSA key pair creation is also available for Java, Ruby, Python, and
many other programming languages.
The following formats are supported:
importKeyPair
in interface AmazonEC2
importKeyPairRequest
- Container for the necessary parameters to
execute the ImportKeyPair service method 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 void deleteNetworkInterface(DeleteNetworkInterfaceRequest deleteNetworkInterfaceRequest) throws AmazonServiceException, AmazonClientException
deleteNetworkInterface
in interface AmazonEC2
deleteNetworkInterfaceRequest
- Container for the necessary
parameters to execute the DeleteNetworkInterface service method 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 CreateSecurityGroupResult createSecurityGroup(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.
createSecurityGroup
in interface AmazonEC2
createSecurityGroupRequest
- Container for the necessary
parameters to execute the CreateSecurityGroup service method 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 DescribeSpotPriceHistoryResult describeSpotPriceHistory(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 .
describeSpotPriceHistory
in interface AmazonEC2
describeSpotPriceHistoryRequest
- Container for the necessary
parameters to execute the DescribeSpotPriceHistory service method 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 DescribeNetworkInterfacesResult describeNetworkInterfaces(DescribeNetworkInterfacesRequest describeNetworkInterfacesRequest) throws AmazonServiceException, AmazonClientException
describeNetworkInterfaces
in interface AmazonEC2
describeNetworkInterfacesRequest
- Container for the necessary
parameters to execute the DescribeNetworkInterfaces service method 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 DescribeRegionsResult describeRegions(DescribeRegionsRequest describeRegionsRequest) throws AmazonServiceException, AmazonClientException
The DescribeRegions operation describes regions zones that are currently available to the account.
describeRegions
in interface AmazonEC2
describeRegionsRequest
- Container for the necessary parameters
to execute the DescribeRegions service method 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 CreateDhcpOptionsResult createDhcpOptions(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
createDhcpOptions
in interface AmazonEC2
createDhcpOptionsRequest
- Container for the necessary parameters
to execute the CreateDhcpOptions service method 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 void resetSnapshotAttribute(ResetSnapshotAttributeRequest resetSnapshotAttributeRequest) throws AmazonServiceException, AmazonClientException
Resets permission settings for the specified snapshot.
resetSnapshotAttribute
in interface AmazonEC2
resetSnapshotAttributeRequest
- Container for the necessary
parameters to execute the ResetSnapshotAttribute service method 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 void deleteRoute(DeleteRouteRequest deleteRouteRequest) throws AmazonServiceException, AmazonClientException
Deletes a route from a route table in a VPC. For more information about route tables, go to Route Tables in the Amazon Virtual Private Cloud User Guide.
deleteRoute
in interface AmazonEC2
deleteRouteRequest
- Container for the necessary parameters to
execute the DeleteRoute service method 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 DescribeInternetGatewaysResult describeInternetGateways(DescribeInternetGatewaysRequest describeInternetGatewaysRequest) throws AmazonServiceException, AmazonClientException
Gives you information about your Internet gateways. You can filter the results to return information only about Internet gateways that match criteria you specify. For example, you could get information only about gateways with particular tags. The Internet gateway must match at least one of the specified values for it to be included in the results.
You can specify multiple filters (e.g., the Internet gateway is attached to a particular VPC and is tagged with a particular value). The result includes information for a particular Internet gateway only if the gateway matches all your filters. If there's no match, no special message is returned; the response is simply empty.
You can use wildcards with the filter values: an asterisk matches
zero or more characters, and ?
matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\
.
describeInternetGateways
in interface AmazonEC2
describeInternetGatewaysRequest
- Container for the necessary
parameters to execute the DescribeInternetGateways service method 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 ImportVolumeResult importVolume(ImportVolumeRequest importVolumeRequest) throws AmazonServiceException, AmazonClientException
importVolume
in interface AmazonEC2
importVolumeRequest
- Container for the necessary parameters to
execute the ImportVolume service method 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 DescribeSecurityGroupsResult describeSecurityGroups(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.
describeSecurityGroups
in interface AmazonEC2
describeSecurityGroupsRequest
- Container for the necessary
parameters to execute the DescribeSecurityGroups service method 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 void detachVpnGateway(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.
detachVpnGateway
in interface AmazonEC2
detachVpnGatewayRequest
- Container for the necessary parameters
to execute the DetachVpnGateway service method 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 void deregisterImage(DeregisterImageRequest deregisterImageRequest) throws AmazonServiceException, AmazonClientException
The DeregisterImage operation deregisters an AMI. Once deregistered, instances of the AMI can no longer be launched.
deregisterImage
in interface AmazonEC2
deregisterImageRequest
- Container for the necessary parameters
to execute the DeregisterImage service method 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 DescribeSpotDatafeedSubscriptionResult describeSpotDatafeedSubscription(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 .
describeSpotDatafeedSubscription
in interface AmazonEC2
describeSpotDatafeedSubscriptionRequest
- Container for the
necessary parameters to execute the DescribeSpotDatafeedSubscription
service method 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 void deleteTags(DeleteTagsRequest deleteTagsRequest) throws AmazonServiceException, AmazonClientException
Deletes tags from the specified Amazon EC2 resources.
deleteTags
in interface AmazonEC2
deleteTagsRequest
- Container for the necessary parameters to
execute the DeleteTags service method 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 void deleteSubnet(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.
deleteSubnet
in interface AmazonEC2
deleteSubnetRequest
- Container for the necessary parameters to
execute the DeleteSubnet service method 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 CreateVpnGatewayResult createVpnGateway(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.
createVpnGateway
in interface AmazonEC2
createVpnGatewayRequest
- Container for the necessary parameters
to execute the CreateVpnGateway service method 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 void enableVolumeIO(EnableVolumeIORequest enableVolumeIORequest) throws AmazonServiceException, AmazonClientException
Enable IO on the volume after an event has occured.
enableVolumeIO
in interface AmazonEC2
enableVolumeIORequest
- Container for the necessary parameters to
execute the EnableVolumeIO service method 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 void deleteVpnGateway(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.
deleteVpnGateway
in interface AmazonEC2
deleteVpnGatewayRequest
- Container for the necessary parameters
to execute the DeleteVpnGateway service method 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 AttachVolumeResult attachVolume(AttachVolumeRequest attachVolumeRequest) throws AmazonServiceException, AmazonClientException
Attach a previously created volume to a running instance.
attachVolume
in interface AmazonEC2
attachVolumeRequest
- Container for the necessary parameters to
execute the AttachVolume service method 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 DescribeLicensesResult describeLicenses(DescribeLicensesRequest describeLicensesRequest) throws AmazonServiceException, AmazonClientException
Provides details of a user's registered licenses. Zero or more IDs may be specified on the call. When one or more license IDs are specified, only data for the specified IDs are returned.
describeLicenses
in interface AmazonEC2
describeLicensesRequest
- Container for the necessary parameters
to execute the DescribeLicenses service method 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 DescribeVolumeStatusResult describeVolumeStatus(DescribeVolumeStatusRequest describeVolumeStatusRequest) throws AmazonServiceException, AmazonClientException
Describes the status of a volume.
describeVolumeStatus
in interface AmazonEC2
describeVolumeStatusRequest
- Container for the necessary
parameters to execute the DescribeVolumeStatus service method 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 void activateLicense(ActivateLicenseRequest activateLicenseRequest) throws AmazonServiceException, AmazonClientException
Activates a specific number of licenses for a 90-day period. Activations can be done against a specific license ID.
activateLicense
in interface AmazonEC2
activateLicenseRequest
- Container for the necessary parameters
to execute the ActivateLicense service method 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 void resetImageAttribute(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.
resetImageAttribute
in interface AmazonEC2
resetImageAttributeRequest
- Container for the necessary
parameters to execute the ResetImageAttribute service method 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 DescribeVpnConnectionsResult describeVpnConnections(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.
describeVpnConnections
in interface AmazonEC2
describeVpnConnectionsRequest
- Container for the necessary
parameters to execute the DescribeVpnConnections service method 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 CreateSnapshotResult createSnapshot(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.
createSnapshot
in interface AmazonEC2
createSnapshotRequest
- Container for the necessary parameters to
execute the CreateSnapshot service method 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 void deleteVolume(DeleteVolumeRequest deleteVolumeRequest) throws AmazonServiceException, AmazonClientException
Deletes a previously created volume. Once successfully deleted, a new volume can be created with the same name.
deleteVolume
in interface AmazonEC2
deleteVolumeRequest
- Container for the necessary parameters to
execute the DeleteVolume service method 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 CreateNetworkInterfaceResult createNetworkInterface(CreateNetworkInterfaceRequest createNetworkInterfaceRequest) throws AmazonServiceException, AmazonClientException
createNetworkInterface
in interface AmazonEC2
createNetworkInterfaceRequest
- Container for the necessary
parameters to execute the CreateNetworkInterface service method 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 DescribeVpcsResult describeVpcs(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.
describeVpcs
in interface AmazonEC2
describeVpcsRequest
- Container for the necessary parameters to
execute the DescribeVpcs service method 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 void unassignPrivateIpAddresses(UnassignPrivateIpAddressesRequest unassignPrivateIpAddressesRequest) throws AmazonServiceException, AmazonClientException
unassignPrivateIpAddresses
in interface AmazonEC2
unassignPrivateIpAddressesRequest
- Container for the necessary
parameters to execute the UnassignPrivateIpAddresses service method 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 void deactivateLicense(DeactivateLicenseRequest deactivateLicenseRequest) throws AmazonServiceException, AmazonClientException
Deactivates a specific number of licenses. Deactivations can be done against a specific license ID after they have persisted for at least a 90-day period.
deactivateLicense
in interface AmazonEC2
deactivateLicenseRequest
- Container for the necessary parameters
to execute the DeactivateLicense service method 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 AssociateAddressResult associateAddress(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.
associateAddress
in interface AmazonEC2
associateAddressRequest
- Container for the necessary parameters
to execute the AssociateAddress service method 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 void cancelConversionTask(CancelConversionTaskRequest cancelConversionTaskRequest) throws AmazonServiceException, AmazonClientException
cancelConversionTask
in interface AmazonEC2
cancelConversionTaskRequest
- Container for the necessary
parameters to execute the CancelConversionTask service method 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 void deleteCustomerGateway(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.
deleteCustomerGateway
in interface AmazonEC2
deleteCustomerGatewayRequest
- Container for the necessary
parameters to execute the DeleteCustomerGateway service method 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 void createNetworkAclEntry(CreateNetworkAclEntryRequest createNetworkAclEntryRequest) throws AmazonServiceException, AmazonClientException
Creates an entry (i.e., rule) in a network ACL with a rule number you specify. Each network ACL has a set of numbered ingress rules and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated with the ACL, Amazon VPC processes the entries in the ACL according to the rule numbers, in ascending order.
Important: We recommend that you leave room between the rules (e.g., 100, 110, 120, etc.), and not number them sequentially (101, 102, 103, etc.). This allows you to easily add a new rule between existing ones without having to renumber the rules.
After you add an entry, you can't modify it; you must either replace it, or create a new entry and delete the old one.
For more information about network ACLs, go to Network ACLs in the Amazon Virtual Private Cloud User Guide.
createNetworkAclEntry
in interface AmazonEC2
createNetworkAclEntryRequest
- Container for the necessary
parameters to execute the CreateNetworkAclEntry service method 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 DescribeExportTasksResult describeExportTasks(DescribeExportTasksRequest describeExportTasksRequest) throws AmazonServiceException, AmazonClientException
describeExportTasks
in interface AmazonEC2
describeExportTasksRequest
- Container for the necessary
parameters to execute the DescribeExportTasks service method 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 void detachInternetGateway(DetachInternetGatewayRequest detachInternetGatewayRequest) throws AmazonServiceException, AmazonClientException
Detaches an Internet gateway from a VPC, disabling connectivity between the Internet and the VPC. The VPC must not contain any running instances with elastic IP addresses. For more information about your VPC and Internet gateway, go to Amazon Virtual Private Cloud User Guide.
For more information about Amazon Virtual Private Cloud and Internet gateways, go to the Amazon Virtual Private Cloud User Guide.
detachInternetGateway
in interface AmazonEC2
detachInternetGatewayRequest
- Container for the necessary
parameters to execute the DetachInternetGateway service method 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 CreateRouteTableResult createRouteTable(CreateRouteTableRequest createRouteTableRequest) throws AmazonServiceException, AmazonClientException
Creates a new route table within a VPC. After you create a new route table, you can add routes and associate the table with a subnet. For more information about route tables, go to Route Tables in the Amazon Virtual Private Cloud User Guide.
createRouteTable
in interface AmazonEC2
createRouteTableRequest
- Container for the necessary parameters
to execute the CreateRouteTable service method 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 DescribeVolumesResult describeVolumes(DescribeVolumesRequest describeVolumesRequest) throws AmazonServiceException, AmazonClientException
Describes the status of the indicated volume or, in lieu of any specified, all volumes belonging to the caller. Volumes that have been deleted are not described.
describeVolumes
in interface AmazonEC2
describeVolumesRequest
- Container for the necessary parameters
to execute the DescribeVolumes service method 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 void reportInstanceStatus(ReportInstanceStatusRequest reportInstanceStatusRequest) throws AmazonServiceException, AmazonClientException
reportInstanceStatus
in interface AmazonEC2
reportInstanceStatusRequest
- Container for the necessary
parameters to execute the ReportInstanceStatus service method 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 DescribeRouteTablesResult describeRouteTables(DescribeRouteTablesRequest describeRouteTablesRequest) throws AmazonServiceException, AmazonClientException
Gives you information about your route tables. You can filter the results to return information only about tables that match criteria you specify. For example, you could get information only about a table associated with a particular subnet. You can specify multiple values for the filter. The table must match at least one of the specified values for it to be included in the results.
You can specify multiple filters (e.g., the table has a particular route, and is associated with a particular subnet). The result includes information for a particular table only if it matches all your filters. If there's no match, no special message is returned; the response is simply empty.
You can use wildcards with the filter values: an asterisk matches
zero or more characters, and ?
matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\
.
describeRouteTables
in interface AmazonEC2
describeRouteTablesRequest
- Container for the necessary
parameters to execute the DescribeRouteTables service method 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 DescribeDhcpOptionsResult describeDhcpOptions(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:
describeDhcpOptions
in interface AmazonEC2
describeDhcpOptionsRequest
- Container for the necessary
parameters to execute the DescribeDhcpOptions service method 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 MonitorInstancesResult monitorInstances(MonitorInstancesRequest monitorInstancesRequest) throws AmazonServiceException, AmazonClientException
Enables monitoring for a running instance.
monitorInstances
in interface AmazonEC2
monitorInstancesRequest
- Container for the necessary parameters
to execute the MonitorInstances service method 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 DescribeNetworkAclsResult describeNetworkAcls(DescribeNetworkAclsRequest describeNetworkAclsRequest) throws AmazonServiceException, AmazonClientException
Gives you information about the network ACLs in your VPC. You can filter the results to return information only about ACLs that match criteria you specify. For example, you could get information only the ACL associated with a particular subnet. The ACL must match at least one of the specified values for it to be included in the results.
You can specify multiple filters (e.g., the ACL is associated with a particular subnet and has an egress entry that denies traffic to a particular port). The result includes information for a particular ACL only if it matches all your filters. If there's no match, no special message is returned; the response is simply empty.
You can use wildcards with the filter values: an asterisk matches
zero or more characters, and ?
matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\
.
describeNetworkAcls
in interface AmazonEC2
describeNetworkAclsRequest
- Container for the necessary
parameters to execute the DescribeNetworkAcls service method 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 DescribeBundleTasksResult describeBundleTasks(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.
describeBundleTasks
in interface AmazonEC2
describeBundleTasksRequest
- Container for the necessary
parameters to execute the DescribeBundleTasks service method 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 ImportInstanceResult importInstance(ImportInstanceRequest importInstanceRequest) throws AmazonServiceException, AmazonClientException
importInstance
in interface AmazonEC2
importInstanceRequest
- Container for the necessary parameters to
execute the ImportInstance service method 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 void revokeSecurityGroupIngress(RevokeSecurityGroupIngressRequest revokeSecurityGroupIngressRequest) throws AmazonServiceException, AmazonClientException
The RevokeSecurityGroupIngress operation revokes permissions from a security group. The permissions used to revoke must be specified using the same values used to grant the permissions.
Permissions are specified by IP protocol (TCP, UDP, or ICMP), the source of the request (by IP range or an Amazon EC2 user-group pair), the source and destination port ranges (for TCP and UDP), and the ICMP codes and types (for ICMP).
Permission changes are quickly propagated to instances within the security group. However, depending on the number of instances in the group, a small delay might occur.
revokeSecurityGroupIngress
in interface AmazonEC2
revokeSecurityGroupIngressRequest
- Container for the necessary
parameters to execute the RevokeSecurityGroupIngress service method 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 GetConsoleOutputResult getConsoleOutput(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.
getConsoleOutput
in interface AmazonEC2
getConsoleOutputRequest
- Container for the necessary parameters
to execute the GetConsoleOutput service method 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 CreateInternetGatewayResult createInternetGateway(CreateInternetGatewayRequest createInternetGatewayRequest) throws AmazonServiceException, AmazonClientException
Creates a new Internet gateway in your AWS account. After creating
the Internet gateway, you then attach it to a VPC using
AttachInternetGateway
. For more information about your
VPC and Internet gateway, go to Amazon Virtual Private Cloud User
Guide.
createInternetGateway
in interface AmazonEC2
createInternetGatewayRequest
- Container for the necessary
parameters to execute the CreateInternetGateway service method 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 void detachNetworkInterface(DetachNetworkInterfaceRequest detachNetworkInterfaceRequest) throws AmazonServiceException, AmazonClientException
detachNetworkInterface
in interface AmazonEC2
detachNetworkInterfaceRequest
- Container for the necessary
parameters to execute the DetachNetworkInterface service method 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 void modifyImageAttribute(ModifyImageAttributeRequest modifyImageAttributeRequest) throws AmazonServiceException, AmazonClientException
The ModifyImageAttribute operation modifies an attribute of an AMI.
modifyImageAttribute
in interface AmazonEC2
modifyImageAttributeRequest
- Container for the necessary
parameters to execute the ModifyImageAttribute service method 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 CreateCustomerGatewayResult createCustomerGateway(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 .
createCustomerGateway
in interface AmazonEC2
createCustomerGatewayRequest
- Container for the necessary
parameters to execute the CreateCustomerGateway service method 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 CreateSpotDatafeedSubscriptionResult createSpotDatafeedSubscription(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 .
createSpotDatafeedSubscription
in interface AmazonEC2
createSpotDatafeedSubscriptionRequest
- Container for the
necessary parameters to execute the CreateSpotDatafeedSubscription
service method 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 void attachInternetGateway(AttachInternetGatewayRequest attachInternetGatewayRequest) throws AmazonServiceException, AmazonClientException
Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC. For more information about your VPC and Internet gateway, go to the Amazon Virtual Private Cloud User Guide.
attachInternetGateway
in interface AmazonEC2
attachInternetGatewayRequest
- Container for the necessary
parameters to execute the AttachInternetGateway service method 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 void deleteVpnConnection(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.
deleteVpnConnection
in interface AmazonEC2
deleteVpnConnectionRequest
- Container for the necessary
parameters to execute the DeleteVpnConnection service method 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 DescribeConversionTasksResult describeConversionTasks(DescribeConversionTasksRequest describeConversionTasksRequest) throws AmazonServiceException, AmazonClientException
describeConversionTasks
in interface AmazonEC2
describeConversionTasksRequest
- Container for the necessary
parameters to execute the DescribeConversionTasks service method 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 CreateVpnConnectionResult createVpnConnection(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.
createVpnConnection
in interface AmazonEC2
createVpnConnectionRequest
- Container for the necessary
parameters to execute the CreateVpnConnection service method 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 DescribeInstanceAttributeResult describeInstanceAttribute(DescribeInstanceAttributeRequest describeInstanceAttributeRequest) throws AmazonServiceException, AmazonClientException
Returns information about an attribute of an instance. Only one attribute can be specified per call.
describeInstanceAttribute
in interface AmazonEC2
describeInstanceAttributeRequest
- Container for the necessary
parameters to execute the DescribeInstanceAttribute service method 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 DescribeSubnetsResult describeSubnets(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.
describeSubnets
in interface AmazonEC2
describeSubnetsRequest
- Container for the necessary parameters
to execute the DescribeSubnets service method 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 RunInstancesResult runInstances(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.
runInstances
in interface AmazonEC2
runInstancesRequest
- Container for the necessary parameters to
execute the RunInstances service method 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 DescribePlacementGroupsResult describePlacementGroups(DescribePlacementGroupsRequest describePlacementGroupsRequest) throws AmazonServiceException, AmazonClientException
Returns information about one or more PlacementGroup instances in a user's account.
describePlacementGroups
in interface AmazonEC2
describePlacementGroupsRequest
- Container for the necessary
parameters to execute the DescribePlacementGroups service method 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 AssociateRouteTableResult associateRouteTable(AssociateRouteTableRequest associateRouteTableRequest) throws AmazonServiceException, AmazonClientException
Associates a subnet with a route table. The subnet and route table must be in the same VPC. This association causes traffic originating from the subnet to be routed according to the routes in the route table. The action returns an association ID, which you need if you want to disassociate the route table from the subnet later. A route table can be associated with multiple subnets.
For more information about route tables, go to Route Tables in the Amazon Virtual Private Cloud User Guide.
associateRouteTable
in interface AmazonEC2
associateRouteTableRequest
- Container for the necessary
parameters to execute the AssociateRouteTable service method 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 DescribeInstancesResult describeInstances(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.
describeInstances
in interface AmazonEC2
describeInstancesRequest
- Container for the necessary parameters
to execute the DescribeInstances service method 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 void deleteNetworkAcl(DeleteNetworkAclRequest deleteNetworkAclRequest) throws AmazonServiceException, AmazonClientException
Deletes a network ACL from a VPC. The ACL must not have any subnets associated with it. You can't delete the default network ACL. For more information about network ACLs, go to Network ACLs in the Amazon Virtual Private Cloud User Guide.
deleteNetworkAcl
in interface AmazonEC2
deleteNetworkAclRequest
- Container for the necessary parameters
to execute the DeleteNetworkAcl service method 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 void modifyVolumeAttribute(ModifyVolumeAttributeRequest modifyVolumeAttributeRequest) throws AmazonServiceException, AmazonClientException
modifyVolumeAttribute
in interface AmazonEC2
modifyVolumeAttributeRequest
- Container for the necessary
parameters to execute the ModifyVolumeAttribute service method 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 DescribeImagesResult describeImages(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.
describeImages
in interface AmazonEC2
describeImagesRequest
- Container for the necessary parameters to
execute the DescribeImages service method 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 StartInstancesResult startInstances(StartInstancesRequest startInstancesRequest) throws AmazonServiceException, AmazonClientException
Starts an instance that uses an Amazon EBS volume as its root device. Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time.
NOTE: Performing this operation on an instance that uses an instance store as its root device returns an error.
startInstances
in interface AmazonEC2
startInstancesRequest
- Container for the necessary parameters to
execute the StartInstances service method 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 void modifyInstanceAttribute(ModifyInstanceAttributeRequest modifyInstanceAttributeRequest) throws AmazonServiceException, AmazonClientException
Modifies an attribute of an instance.
modifyInstanceAttribute
in interface AmazonEC2
modifyInstanceAttributeRequest
- Container for the necessary
parameters to execute the ModifyInstanceAttribute service method 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 void deleteDhcpOptions(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.
deleteDhcpOptions
in interface AmazonEC2
deleteDhcpOptionsRequest
- Container for the necessary parameters
to execute the DeleteDhcpOptions service method 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 void authorizeSecurityGroupIngress(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.
authorizeSecurityGroupIngress
in interface AmazonEC2
authorizeSecurityGroupIngressRequest
- Container for the
necessary parameters to execute the AuthorizeSecurityGroupIngress
service method 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 DescribeSpotInstanceRequestsResult describeSpotInstanceRequests(DescribeSpotInstanceRequestsRequest describeSpotInstanceRequestsRequest) throws AmazonServiceException, AmazonClientException
Describes Spot Instance requests. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests. For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
You can filter the results to return information only about Spot
Instance requests that match criteria you specify. For example, you
could get information about requests where the Spot Price you
specified is a certain value (you can't use greater than or less than
comparison, but you can use *
and ?
wildcards). You can specify multiple values for a filter. A Spot
Instance request must match at least one of the specified values for
it to be included in the results.
You can specify multiple filters (e.g., the Spot Price is equal to a
particular value, and the instance type is m1.small
).
The result includes information for a particular request only if it
matches all your filters. If there's no match, no special message is
returned; the response is simply empty.
You can use wildcards with the filter values: an asterisk matches
zero or more characters, and ?
matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\
.
describeSpotInstanceRequests
in interface AmazonEC2
describeSpotInstanceRequestsRequest
- Container for the necessary
parameters to execute the DescribeSpotInstanceRequests service method
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 CreateVpcResult createVpc(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).
createVpc
in interface AmazonEC2
createVpcRequest
- Container for the necessary parameters to
execute the CreateVpc service method 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 DescribeCustomerGatewaysResult describeCustomerGateways(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.
describeCustomerGateways
in interface AmazonEC2
describeCustomerGatewaysRequest
- Container for the necessary
parameters to execute the DescribeCustomerGateways service method 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 void cancelExportTask(CancelExportTaskRequest cancelExportTaskRequest) throws AmazonServiceException, AmazonClientException
cancelExportTask
in interface AmazonEC2
cancelExportTaskRequest
- Container for the necessary parameters
to execute the CancelExportTask service method 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 void createRoute(CreateRouteRequest createRouteRequest) throws AmazonServiceException, AmazonClientException
Creates a new route in a route table within a VPC. The route's target can be either a gateway attached to the VPC or a NAT instance in the VPC.
When determining how to route traffic, we use the route with the most
specific match. For example, let's say the traffic is destined for
192.0.2.3
, and the route table includes the following
two routes:
192.0.2.0/24
(goes to some target A) 192.0.2.0/28
(goes to some target B)
Both routes apply to the traffic destined for 192.0.2.3
. However, the second route in the list is more specific, so we use
that route to determine where to target the traffic.
For more information about route tables, go to Route Tables in the Amazon Virtual Private Cloud User Guide.
createRoute
in interface AmazonEC2
createRouteRequest
- Container for the necessary parameters to
execute the CreateRoute service method 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 void modifyNetworkInterfaceAttribute(ModifyNetworkInterfaceAttributeRequest modifyNetworkInterfaceAttributeRequest) throws AmazonServiceException, AmazonClientException
modifyNetworkInterfaceAttribute
in interface AmazonEC2
modifyNetworkInterfaceAttributeRequest
- Container for the
necessary parameters to execute the ModifyNetworkInterfaceAttribute
service method 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 void deleteRouteTable(DeleteRouteTableRequest deleteRouteTableRequest) throws AmazonServiceException, AmazonClientException
Deletes a route table from a VPC. The route table must not be associated with a subnet. You can't delete the main route table. For more information about route tables, go to Route Tables in the Amazon Virtual Private Cloud User Guide.
deleteRouteTable
in interface AmazonEC2
deleteRouteTableRequest
- Container for the necessary parameters
to execute the DeleteRouteTable service method 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 DescribeNetworkInterfaceAttributeResult describeNetworkInterfaceAttribute(DescribeNetworkInterfaceAttributeRequest describeNetworkInterfaceAttributeRequest) throws AmazonServiceException, AmazonClientException
describeNetworkInterfaceAttribute
in interface AmazonEC2
describeNetworkInterfaceAttributeRequest
- Container for the
necessary parameters to execute the DescribeNetworkInterfaceAttribute
service method 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 RequestSpotInstancesResult requestSpotInstances(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.
requestSpotInstances
in interface AmazonEC2
requestSpotInstancesRequest
- Container for the necessary
parameters to execute the RequestSpotInstances service method 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 void createTags(CreateTagsRequest createTagsRequest) throws AmazonServiceException, AmazonClientException
Adds or overwrites tags for the specified resources. Each resource can have a maximum of 10 tags. Each tag consists of a key-value pair. Tag keys must be unique per resource.
createTags
in interface AmazonEC2
createTagsRequest
- Container for the necessary parameters to
execute the CreateTags service method 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 AttachNetworkInterfaceResult attachNetworkInterface(AttachNetworkInterfaceRequest attachNetworkInterfaceRequest) throws AmazonServiceException, AmazonClientException
attachNetworkInterface
in interface AmazonEC2
attachNetworkInterfaceRequest
- Container for the necessary
parameters to execute the AttachNetworkInterface service method 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 DescribeVolumeAttributeResult describeVolumeAttribute(DescribeVolumeAttributeRequest describeVolumeAttributeRequest) throws AmazonServiceException, AmazonClientException
describeVolumeAttribute
in interface AmazonEC2
describeVolumeAttributeRequest
- Container for the necessary
parameters to execute the DescribeVolumeAttribute service method 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 void replaceRoute(ReplaceRouteRequest replaceRouteRequest) throws AmazonServiceException, AmazonClientException
Replaces an existing route within a route table in a VPC. For more information about route tables, go to Route Tables in the Amazon Virtual Private Cloud User Guide.
replaceRoute
in interface AmazonEC2
replaceRouteRequest
- Container for the necessary parameters to
execute the ReplaceRoute service method 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 DescribeTagsResult describeTags(DescribeTagsRequest describeTagsRequest) throws AmazonServiceException, AmazonClientException
Describes the tags for the specified resources.
describeTags
in interface AmazonEC2
describeTagsRequest
- Container for the necessary parameters to
execute the DescribeTags service method 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 CancelBundleTaskResult cancelBundleTask(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.
cancelBundleTask
in interface AmazonEC2
cancelBundleTaskRequest
- Container for the necessary parameters
to execute the CancelBundleTask service method 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 CancelSpotInstanceRequestsResult cancelSpotInstanceRequests(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 .
cancelSpotInstanceRequests
in interface AmazonEC2
cancelSpotInstanceRequestsRequest
- Container for the necessary
parameters to execute the CancelSpotInstanceRequests service method 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 PurchaseReservedInstancesOfferingResult purchaseReservedInstancesOffering(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.
purchaseReservedInstancesOffering
in interface AmazonEC2
purchaseReservedInstancesOfferingRequest
- Container for the
necessary parameters to execute the PurchaseReservedInstancesOffering
service method 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 void modifySnapshotAttribute(ModifySnapshotAttributeRequest modifySnapshotAttributeRequest) throws AmazonServiceException, AmazonClientException
Adds or remove permission settings for the specified snapshot.
modifySnapshotAttribute
in interface AmazonEC2
modifySnapshotAttributeRequest
- Container for the necessary
parameters to execute the ModifySnapshotAttribute service method 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 TerminateInstancesResult terminateInstances(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).
terminateInstances
in interface AmazonEC2
terminateInstancesRequest
- Container for the necessary
parameters to execute the TerminateInstances service method 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 void deleteSpotDatafeedSubscription(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 .
deleteSpotDatafeedSubscription
in interface AmazonEC2
deleteSpotDatafeedSubscriptionRequest
- Container for the
necessary parameters to execute the DeleteSpotDatafeedSubscription
service method 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 void deleteInternetGateway(DeleteInternetGatewayRequest deleteInternetGatewayRequest) throws AmazonServiceException, AmazonClientException
Deletes an Internet gateway from your AWS account. The gateway must not be attached to a VPC. For more information about your VPC and Internet gateway, go to Amazon Virtual Private Cloud User Guide.
deleteInternetGateway
in interface AmazonEC2
deleteInternetGatewayRequest
- Container for the necessary
parameters to execute the DeleteInternetGateway service method 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 DescribeSnapshotAttributeResult describeSnapshotAttribute(DescribeSnapshotAttributeRequest describeSnapshotAttributeRequest) throws AmazonServiceException, AmazonClientException
Returns information about an attribute of a snapshot. Only one attribute can be specified per call.
describeSnapshotAttribute
in interface AmazonEC2
describeSnapshotAttributeRequest
- Container for the necessary
parameters to execute the DescribeSnapshotAttribute service method 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 ReplaceRouteTableAssociationResult replaceRouteTableAssociation(ReplaceRouteTableAssociationRequest replaceRouteTableAssociationRequest) throws AmazonServiceException, AmazonClientException
Changes the route table associated with a given subnet in a VPC. After you execute this action, the subnet uses the routes in the new route table it's associated with. For more information about route tables, go to Route Tables in the Amazon Virtual Private Cloud User Guide.
You can also use this to change which table is the main route table in the VPC. You just specify the main route table's association ID and the route table that you want to be the new main route table.
replaceRouteTableAssociation
in interface AmazonEC2
replaceRouteTableAssociationRequest
- Container for the necessary
parameters to execute the ReplaceRouteTableAssociation service method
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 DescribeAddressesResult describeAddresses(DescribeAddressesRequest describeAddressesRequest) throws AmazonServiceException, AmazonClientException
The DescribeAddresses operation lists elastic IP addresses assigned to your account.
describeAddresses
in interface AmazonEC2
describeAddressesRequest
- Container for the necessary parameters
to execute the DescribeAddresses service method 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 DescribeImageAttributeResult describeImageAttribute(DescribeImageAttributeRequest describeImageAttributeRequest) throws AmazonServiceException, AmazonClientException
The DescribeImageAttribute operation returns information about an attribute of an AMI. Only one attribute can be specified per call.
describeImageAttribute
in interface AmazonEC2
describeImageAttributeRequest
- Container for the necessary
parameters to execute the DescribeImageAttribute service method 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 DescribeKeyPairsResult describeKeyPairs(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.
describeKeyPairs
in interface AmazonEC2
describeKeyPairsRequest
- Container for the necessary parameters
to execute the DescribeKeyPairs service method 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 ConfirmProductInstanceResult confirmProductInstance(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.
confirmProductInstance
in interface AmazonEC2
confirmProductInstanceRequest
- Container for the necessary
parameters to execute the ConfirmProductInstance service method 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 void disassociateRouteTable(DisassociateRouteTableRequest disassociateRouteTableRequest) throws AmazonServiceException, AmazonClientException
Disassociates a subnet from a route table.
After you perform this action, the subnet no longer uses the routes in the route table. Instead it uses the routes in the VPC's main route table. For more information about route tables, go to Route Tables in the Amazon Virtual Private Cloud User Guide.
disassociateRouteTable
in interface AmazonEC2
disassociateRouteTableRequest
- Container for the necessary
parameters to execute the DisassociateRouteTable service method 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 void revokeSecurityGroupEgress(RevokeSecurityGroupEgressRequest revokeSecurityGroupEgressRequest) throws AmazonServiceException, AmazonClientException
This action applies only to security groups in a VPC. It doesn't work with EC2 security groups. For information about Amazon Virtual Private Cloud and VPC security groups, go to the Amazon Virtual Private Cloud User Guide.
The action removes one or more egress rules from a VPC security group. The values that you specify in the revoke request (e.g., ports, etc.) must match the existing rule's values in order for the rule to be revoked.
Each rule consists of the protocol, and the CIDR range or destination security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.
Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.
revokeSecurityGroupEgress
in interface AmazonEC2
revokeSecurityGroupEgressRequest
- Container for the necessary
parameters to execute the RevokeSecurityGroupEgress service method 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 void deleteNetworkAclEntry(DeleteNetworkAclEntryRequest deleteNetworkAclEntryRequest) throws AmazonServiceException, AmazonClientException
Deletes an ingress or egress entry (i.e., rule) from a network ACL. For more information about network ACLs, go to Network ACLs in the Amazon Virtual Private Cloud User Guide.
deleteNetworkAclEntry
in interface AmazonEC2
deleteNetworkAclEntryRequest
- Container for the necessary
parameters to execute the DeleteNetworkAclEntry service method 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 CreateVolumeResult createVolume(CreateVolumeRequest createVolumeRequest) throws AmazonServiceException, AmazonClientException
Initializes an empty volume of a given size.
createVolume
in interface AmazonEC2
createVolumeRequest
- Container for the necessary parameters to
execute the CreateVolume service method 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 DescribeInstanceStatusResult describeInstanceStatus(DescribeInstanceStatusRequest describeInstanceStatusRequest) throws AmazonServiceException, AmazonClientException
Describes the status of an Amazon Elastic Compute Cloud (Amazon EC2) instance. Instance status provides information about two types of scheduled events for an instance that may require your attention:
system-reboot
or instance-reboot
.
System reboot commonly occurs if certain maintenance or upgrade
operations require a reboot of the underlying host that supports an
instance. Instance reboot commonly occurs if the instance must be
rebooted, rather than the underlying host. Rebooting events include a
scheduled start and end time. instance-retirement
. Retirement commonly
occurs when the underlying host is degraded and must be replaced.
Retirement events include a scheduled start and end time. You're also
notified by email if one of your instances is set to retiring. The
email message indicates when your instance will be permanently
retired.
If your instance is permanently retired, it will not be restarted.
You can avoid retirement by manually restarting your instance when its
event code is instance-retirement
. This ensures that
your instance is started on a healthy host.
DescribeInstanceStatus
returns information only for
instances in the running state.
You can filter the results to return information only about instances that match criteria you specify. For example, you could get information about instances in a specific Availability Zone. You can specify multiple values for a filter (e.g., more than one Availability Zone). An instance must match at least one of the specified values for it to be included in the results.
You can specify multiple filters. An instance must match all the filters for it to be included in the results. If there's no match, no special message is returned; the response is simply empty.
You can use wildcards with the filter values: *
matches
zero or more characters, and ?
matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\
.
The following filters are available:
availability-zone
- Filter on an instance's
availability zone. instance-state-name
- Filter on the intended state
of the instance, e.g., running. instance-state-code
- Filter on the intended state
code of the instance, e.g., 16.
describeInstanceStatus
in interface AmazonEC2
describeInstanceStatusRequest
- Container for the necessary
parameters to execute the DescribeInstanceStatus service method 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 DescribeVpnGatewaysResult describeVpnGateways(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.
describeVpnGateways
in interface AmazonEC2
describeVpnGatewaysRequest
- Container for the necessary
parameters to execute the DescribeVpnGateways service method 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 CreateSubnetResult createSubnet(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.
createSubnet
in interface AmazonEC2
createSubnetRequest
- Container for the necessary parameters to
execute the CreateSubnet service method 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 DescribeReservedInstancesOfferingsResult describeReservedInstancesOfferings(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.
describeReservedInstancesOfferings
in interface AmazonEC2
describeReservedInstancesOfferingsRequest
- Container for the
necessary parameters to execute the DescribeReservedInstancesOfferings
service method 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 void assignPrivateIpAddresses(AssignPrivateIpAddressesRequest assignPrivateIpAddressesRequest) throws AmazonServiceException, AmazonClientException
assignPrivateIpAddresses
in interface AmazonEC2
assignPrivateIpAddressesRequest
- Container for the necessary
parameters to execute the AssignPrivateIpAddresses service method 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 void deleteSnapshot(DeleteSnapshotRequest deleteSnapshotRequest) throws AmazonServiceException, AmazonClientException
Deletes the snapshot identified by snapshotId
.
deleteSnapshot
in interface AmazonEC2
deleteSnapshotRequest
- Container for the necessary parameters to
execute the DeleteSnapshot service method 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 ReplaceNetworkAclAssociationResult replaceNetworkAclAssociation(ReplaceNetworkAclAssociationRequest replaceNetworkAclAssociationRequest) throws AmazonServiceException, AmazonClientException
Changes which network ACL a subnet is associated with. By default when you create a subnet, it's automatically associated with the default network ACL. For more information about network ACLs, go to Network ACLs in the Amazon Virtual Private Cloud User Guide.
replaceNetworkAclAssociation
in interface AmazonEC2
replaceNetworkAclAssociationRequest
- Container for the necessary
parameters to execute the ReplaceNetworkAclAssociation service method
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 void disassociateAddress(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.
disassociateAddress
in interface AmazonEC2
disassociateAddressRequest
- Container for the necessary
parameters to execute the DisassociateAddress service method 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 void createPlacementGroup(CreatePlacementGroupRequest createPlacementGroupRequest) throws AmazonServiceException, AmazonClientException
Creates a PlacementGroup into which multiple Amazon EC2 instances can be launched. Users must give the group a name unique within the scope of the user account.
createPlacementGroup
in interface AmazonEC2
createPlacementGroupRequest
- Container for the necessary
parameters to execute the CreatePlacementGroup service method 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 BundleInstanceResult bundleInstance(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.
bundleInstance
in interface AmazonEC2
bundleInstanceRequest
- Container for the necessary parameters to
execute the BundleInstance service method 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 void deletePlacementGroup(DeletePlacementGroupRequest deletePlacementGroupRequest) throws AmazonServiceException, AmazonClientException
Deletes a PlacementGroup from a user's account. Terminate all Amazon EC2 instances in the placement group before deletion.
deletePlacementGroup
in interface AmazonEC2
deletePlacementGroupRequest
- Container for the necessary
parameters to execute the DeletePlacementGroup service method 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 void deleteVpc(DeleteVpcRequest deleteVpcRequest) throws AmazonServiceException, AmazonClientException
Deletes a VPC. You must detach or delete all gateways or other objects that are dependent on the VPC first. For example, you must terminate all running instances, delete all VPC security groups (except the default), delete all the route tables (except the default), etc.
deleteVpc
in interface AmazonEC2
deleteVpcRequest
- Container for the necessary parameters to
execute the DeleteVpc service method 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 AllocateAddressResult allocateAddress(AllocateAddressRequest allocateAddressRequest) throws AmazonServiceException, AmazonClientException
The AllocateAddress operation acquires an elastic IP address for use with your account.
allocateAddress
in interface AmazonEC2
allocateAddressRequest
- Container for the necessary parameters
to execute the AllocateAddress service method 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 void releaseAddress(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.
releaseAddress
in interface AmazonEC2
releaseAddressRequest
- Container for the necessary parameters to
execute the ReleaseAddress service method 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 void resetInstanceAttribute(ResetInstanceAttributeRequest resetInstanceAttributeRequest) throws AmazonServiceException, AmazonClientException
Resets an attribute of an instance to its default value.
resetInstanceAttribute
in interface AmazonEC2
resetInstanceAttributeRequest
- Container for the necessary
parameters to execute the ResetInstanceAttribute service method 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 CreateKeyPairResult createKeyPair(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.
createKeyPair
in interface AmazonEC2
createKeyPairRequest
- Container for the necessary parameters to
execute the CreateKeyPair service method 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 void replaceNetworkAclEntry(ReplaceNetworkAclEntryRequest replaceNetworkAclEntryRequest) throws AmazonServiceException, AmazonClientException
Replaces an entry (i.e., rule) in a network ACL. For more information about network ACLs, go to Network ACLs in the Amazon Virtual Private Cloud User Guide.
replaceNetworkAclEntry
in interface AmazonEC2
replaceNetworkAclEntryRequest
- Container for the necessary
parameters to execute the ReplaceNetworkAclEntry service method 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 DescribeSnapshotsResult describeSnapshots(DescribeSnapshotsRequest describeSnapshotsRequest) throws AmazonServiceException, AmazonClientException
Returns information about the Amazon EBS snapshots available to you. Snapshots available to you include public snapshots available for any AWS account to launch, private snapshots you own, and private snapshots owned by another AWS account but for which you've been given explicit create volume permissions.
describeSnapshots
in interface AmazonEC2
describeSnapshotsRequest
- Container for the necessary parameters
to execute the DescribeSnapshots service method 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 CreateNetworkAclResult createNetworkAcl(CreateNetworkAclRequest createNetworkAclRequest) throws AmazonServiceException, AmazonClientException
Creates a new network ACL in a VPC. Network ACLs provide an optional layer of security (on top of security groups) for the instances in your VPC. For more information about network ACLs, go to Network ACLs in the Amazon Virtual Private Cloud User Guide.
createNetworkAcl
in interface AmazonEC2
createNetworkAclRequest
- Container for the necessary parameters
to execute the CreateNetworkAcl service method 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 RegisterImageResult registerImage(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.
registerImage
in interface AmazonEC2
registerImageRequest
- Container for the necessary parameters to
execute the RegisterImage service method 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 void resetNetworkInterfaceAttribute(ResetNetworkInterfaceAttributeRequest resetNetworkInterfaceAttributeRequest) throws AmazonServiceException, AmazonClientException
resetNetworkInterfaceAttribute
in interface AmazonEC2
resetNetworkInterfaceAttributeRequest
- Container for the
necessary parameters to execute the ResetNetworkInterfaceAttribute
service method 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 DescribeReservedInstancesResult describeReservedInstances() throws AmazonServiceException, AmazonClientException
The DescribeReservedInstances operation describes Reserved Instances that were purchased for use with your account.
describeReservedInstances
in interface 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 DescribeAvailabilityZonesResult describeAvailabilityZones() 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.
describeAvailabilityZones
in interface 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 void deleteSecurityGroup() 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.
deleteSecurityGroup
in interface 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 DescribeSpotPriceHistoryResult describeSpotPriceHistory() 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 .
describeSpotPriceHistory
in interface 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 DescribeNetworkInterfacesResult describeNetworkInterfaces() throws AmazonServiceException, AmazonClientException
describeNetworkInterfaces
in interface 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 DescribeRegionsResult describeRegions() throws AmazonServiceException, AmazonClientException
The DescribeRegions operation describes regions zones that are currently available to the account.
describeRegions
in interface 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 DescribeInternetGatewaysResult describeInternetGateways() throws AmazonServiceException, AmazonClientException
Gives you information about your Internet gateways. You can filter the results to return information only about Internet gateways that match criteria you specify. For example, you could get information only about gateways with particular tags. The Internet gateway must match at least one of the specified values for it to be included in the results.
You can specify multiple filters (e.g., the Internet gateway is attached to a particular VPC and is tagged with a particular value). The result includes information for a particular Internet gateway only if the gateway matches all your filters. If there's no match, no special message is returned; the response is simply empty.
You can use wildcards with the filter values: an asterisk matches
zero or more characters, and ?
matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\
.
describeInternetGateways
in interface 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 ImportVolumeResult importVolume() throws AmazonServiceException, AmazonClientException
importVolume
in interface 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 DescribeSecurityGroupsResult describeSecurityGroups() 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.
describeSecurityGroups
in interface 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 DescribeSpotDatafeedSubscriptionResult describeSpotDatafeedSubscription() 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 .
describeSpotDatafeedSubscription
in interface 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 DescribeLicensesResult describeLicenses() throws AmazonServiceException, AmazonClientException
Provides details of a user's registered licenses. Zero or more IDs may be specified on the call. When one or more license IDs are specified, only data for the specified IDs are returned.
describeLicenses
in interface 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 DescribeVolumeStatusResult describeVolumeStatus() throws AmazonServiceException, AmazonClientException
Describes the status of a volume.
describeVolumeStatus
in interface 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 DescribeVpnConnectionsResult describeVpnConnections() 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.
describeVpnConnections
in interface 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 DescribeVpcsResult describeVpcs() 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.
describeVpcs
in interface 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 DescribeExportTasksResult describeExportTasks() throws AmazonServiceException, AmazonClientException
describeExportTasks
in interface 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 DescribeVolumesResult describeVolumes() throws AmazonServiceException, AmazonClientException
Describes the status of the indicated volume or, in lieu of any specified, all volumes belonging to the caller. Volumes that have been deleted are not described.
describeVolumes
in interface 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 void reportInstanceStatus() throws AmazonServiceException, AmazonClientException
reportInstanceStatus
in interface 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 DescribeRouteTablesResult describeRouteTables() throws AmazonServiceException, AmazonClientException
Gives you information about your route tables. You can filter the results to return information only about tables that match criteria you specify. For example, you could get information only about a table associated with a particular subnet. You can specify multiple values for the filter. The table must match at least one of the specified values for it to be included in the results.
You can specify multiple filters (e.g., the table has a particular route, and is associated with a particular subnet). The result includes information for a particular table only if it matches all your filters. If there's no match, no special message is returned; the response is simply empty.
You can use wildcards with the filter values: an asterisk matches
zero or more characters, and ?
matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\
.
describeRouteTables
in interface 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 DescribeDhcpOptionsResult describeDhcpOptions() 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:
describeDhcpOptions
in interface 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 DescribeNetworkAclsResult describeNetworkAcls() throws AmazonServiceException, AmazonClientException
Gives you information about the network ACLs in your VPC. You can filter the results to return information only about ACLs that match criteria you specify. For example, you could get information only the ACL associated with a particular subnet. The ACL must match at least one of the specified values for it to be included in the results.
You can specify multiple filters (e.g., the ACL is associated with a particular subnet and has an egress entry that denies traffic to a particular port). The result includes information for a particular ACL only if it matches all your filters. If there's no match, no special message is returned; the response is simply empty.
You can use wildcards with the filter values: an asterisk matches
zero or more characters, and ?
matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\
.
describeNetworkAcls
in interface 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 DescribeBundleTasksResult describeBundleTasks() 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.
describeBundleTasks
in interface 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 void revokeSecurityGroupIngress() throws AmazonServiceException, AmazonClientException
The RevokeSecurityGroupIngress operation revokes permissions from a security group. The permissions used to revoke must be specified using the same values used to grant the permissions.
Permissions are specified by IP protocol (TCP, UDP, or ICMP), the source of the request (by IP range or an Amazon EC2 user-group pair), the source and destination port ranges (for TCP and UDP), and the ICMP codes and types (for ICMP).
Permission changes are quickly propagated to instances within the security group. However, depending on the number of instances in the group, a small delay might occur.
revokeSecurityGroupIngress
in interface 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 CreateInternetGatewayResult createInternetGateway() throws AmazonServiceException, AmazonClientException
Creates a new Internet gateway in your AWS account. After creating
the Internet gateway, you then attach it to a VPC using
AttachInternetGateway
. For more information about your
VPC and Internet gateway, go to Amazon Virtual Private Cloud User
Guide.
createInternetGateway
in interface 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 DescribeConversionTasksResult describeConversionTasks() throws AmazonServiceException, AmazonClientException
describeConversionTasks
in interface 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 DescribeSubnetsResult describeSubnets() 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.
describeSubnets
in interface 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 DescribePlacementGroupsResult describePlacementGroups() throws AmazonServiceException, AmazonClientException
Returns information about one or more PlacementGroup instances in a user's account.
describePlacementGroups
in interface 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 DescribeInstancesResult describeInstances() 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.
describeInstances
in interface 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 DescribeImagesResult describeImages() 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.
describeImages
in interface 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 void authorizeSecurityGroupIngress() 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.
authorizeSecurityGroupIngress
in interface 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 DescribeSpotInstanceRequestsResult describeSpotInstanceRequests() throws AmazonServiceException, AmazonClientException
Describes Spot Instance requests. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests. For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide .
You can filter the results to return information only about Spot
Instance requests that match criteria you specify. For example, you
could get information about requests where the Spot Price you
specified is a certain value (you can't use greater than or less than
comparison, but you can use *
and ?
wildcards). You can specify multiple values for a filter. A Spot
Instance request must match at least one of the specified values for
it to be included in the results.
You can specify multiple filters (e.g., the Spot Price is equal to a
particular value, and the instance type is m1.small
).
The result includes information for a particular request only if it
matches all your filters. If there's no match, no special message is
returned; the response is simply empty.
You can use wildcards with the filter values: an asterisk matches
zero or more characters, and ?
matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\
.
describeSpotInstanceRequests
in interface 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 DescribeCustomerGatewaysResult describeCustomerGateways() 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.
describeCustomerGateways
in interface 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 DescribeTagsResult describeTags() throws AmazonServiceException, AmazonClientException
Describes the tags for the specified resources.
describeTags
in interface 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 void deleteSpotDatafeedSubscription() 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 .
deleteSpotDatafeedSubscription
in interface 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 DescribeAddressesResult describeAddresses() throws AmazonServiceException, AmazonClientException
The DescribeAddresses operation lists elastic IP addresses assigned to your account.
describeAddresses
in interface 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 DescribeKeyPairsResult describeKeyPairs() 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.
describeKeyPairs
in interface 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 DescribeInstanceStatusResult describeInstanceStatus() throws AmazonServiceException, AmazonClientException
Describes the status of an Amazon Elastic Compute Cloud (Amazon EC2) instance. Instance status provides information about two types of scheduled events for an instance that may require your attention:
system-reboot
or instance-reboot
.
System reboot commonly occurs if certain maintenance or upgrade
operations require a reboot of the underlying host that supports an
instance. Instance reboot commonly occurs if the instance must be
rebooted, rather than the underlying host. Rebooting events include a
scheduled start and end time. instance-retirement
. Retirement commonly
occurs when the underlying host is degraded and must be replaced.
Retirement events include a scheduled start and end time. You're also
notified by email if one of your instances is set to retiring. The
email message indicates when your instance will be permanently
retired.
If your instance is permanently retired, it will not be restarted.
You can avoid retirement by manually restarting your instance when its
event code is instance-retirement
. This ensures that
your instance is started on a healthy host.
DescribeInstanceStatus
returns information only for
instances in the running state.
You can filter the results to return information only about instances that match criteria you specify. For example, you could get information about instances in a specific Availability Zone. You can specify multiple values for a filter (e.g., more than one Availability Zone). An instance must match at least one of the specified values for it to be included in the results.
You can specify multiple filters. An instance must match all the filters for it to be included in the results. If there's no match, no special message is returned; the response is simply empty.
You can use wildcards with the filter values: *
matches
zero or more characters, and ?
matches exactly one
character. You can escape special characters using a backslash before
the character. For example, a value of \*amazon\?\\
searches for the literal string *amazon?\
.
The following filters are available:
availability-zone
- Filter on an instance's
availability zone. instance-state-name
- Filter on the intended state
of the instance, e.g., running. instance-state-code
- Filter on the intended state
code of the instance, e.g., 16.
describeInstanceStatus
in interface 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 DescribeVpnGatewaysResult describeVpnGateways() 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.
describeVpnGateways
in interface 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 DescribeReservedInstancesOfferingsResult describeReservedInstancesOfferings() 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.
describeReservedInstancesOfferings
in interface 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 AllocateAddressResult allocateAddress() throws AmazonServiceException, AmazonClientException
The AllocateAddress operation acquires an elastic IP address for use with your account.
allocateAddress
in interface 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 void releaseAddress() 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.
releaseAddress
in interface 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 DescribeSnapshotsResult describeSnapshots() throws AmazonServiceException, AmazonClientException
Returns information about the Amazon EBS snapshots available to you. Snapshots available to you include public snapshots available for any AWS account to launch, private snapshots you own, and private snapshots owned by another AWS account but for which you've been given explicit create volume permissions.
describeSnapshots
in interface 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 RegisterImageResult registerImage() 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.
registerImage
in interface 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 ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.
getCachedResponseMetadata
in interface AmazonEC2
request
- The originally executed request
|
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |