Skip to content
This repository has been archived by the owner on Jun 15, 2023. It is now read-only.

Latest commit

 

History

History
209 lines (144 loc) · 6.96 KB

examples-ec2-instances.rst

File metadata and controls

209 lines (144 loc) · 6.96 KB
Raw

Managing |EC2| Instances

Creating an Instance

Create a new |EC2| instance by calling the |ec2client|'s :methodname:`runInstances` method, providing it with a :aws-java-class:`RunInstancesRequest <services/ec2/model/RunInstancesRequest>` containing the :ec2-ug:`Amazon Machine Image (AMI) <AMIs>` to use and an :ec2-ug:`instance type <instance-types>`.

Imports

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/CreateInstance.java
   :lines: 16-20
   :language: java

Code

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/CreateInstance.java
   :lines: 44-54
   :dedent: 8
   :language: java

See the :sdk-examples-java-ec2:`complete example <CreateInstance.java>`.

Starting an Instance

To start an |EC2| instance, call the |ec2client|'s :methodname:`startInstances` method, providing it with a :aws-java-class:`StartInstancesRequest <services/ec2/model/StartInstancesRequest>` containing the ID of the instance to start.

Imports

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/StartStopInstance.java
   :lines: 16-17, 20
   :language: java

Code

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/StartStopInstance.java
   :lines: 30-31, 49-52
   :dedent: 8
   :language: java

See the :sdk-examples-java-ec2:`complete example <StartStopInstance.java>`.

Stopping an Instance

To stop an |EC2| instance, call the |ec2client|'s :methodname:`stopInstances` method, providing it with a :aws-java-class:`StopInstancesRequest <services/ec2/model/StopInstancesRequest>` containing the ID of the instance to stop.

Imports

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/StartStopInstance.java
   :lines: 16-17, 21
   :language: java

Code

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/StartStopInstance.java
   :lines: 59-60, 77-80
   :dedent: 8
   :language: java

See the :sdk-examples-java-ec2:`complete example <StartStopInstance.java>`.

Rebooting an Instance

To reboot an |EC2| instance, call the |ec2client|'s :methodname:`rebootInstances` method, providing it with a :aws-java-class:`RebootInstancesRequest <services/ec2/model/RebootInstancesRequest>` containing the ID of the instance to reboot.

Imports

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/RebootInstance.java
   :lines: 16-19
   :language: java

Code

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/RebootInstance.java
   :lines: 39-44
   :dedent: 8
   :language: java

See the :sdk-examples-java-ec2:`complete example <RebootInstance.java>`.

Describing Instances

To list your instances, create a :aws-java-class:`DescribeInstancesRequest <services/ec2/model/DescribeInstancesRequest>` and call the |ec2client|'s :methodname:`describeInstances` method. It will return a :aws-java-class:`DescribeInstancesResult <services/ec2/model/DescribeInstancesResult>` object that you can use to list the |EC2| instances for your account and region.

Instances are grouped by reservation. Each reservation corresponds to the call to :methodname:`startInstances` that launched the instance. To list your instances, you must first call the :classname:`DescribeInstancesResult` class' :methodname:`getReservations' method, and then call :methodname:`getInstances` on each returned :aws-java-class:`Reservation <services/ec2/model/Reservation>` object.

Imports

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/DescribeInstances.java
   :lines: 16-21
   :language: java

Code

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/DescribeInstances.java
   :lines: 30-58
   :dedent: 8
   :language: java

Results are paged; you can get further results by passing the value returned from the result object's :methodname:`getNextToken` method to your original request object's :methodname:`setNextToken` method, then using the same request object in your next call to :methodname:`describeInstances`.

See the :sdk-examples-java-ec2:`complete example <DescribeInstances.java>`.

Monitoring an Instance

You can monitor various aspects of your |EC2| instances, such as CPU and network utilization, available memory, and disk space remaining. To learn more about instance monitoring, see :ec2-ug:`Monitoring Amazon EC2 <monitoring_ec2>` in the |ec2-ug|.

To start monitoring an instance, you must create a :aws-java-class:`MonitorInstancesRequest <services/ec2/model/MonitorInstancesRequest>` with the ID of the instance to monitor, and pass it to the |ec2client|'s :methodname:`monitorInstances` method.

Imports

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/MonitorInstance.java
   :lines: 16-18
   :language: java

Code

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/MonitorInstance.java
   :lines: 30-31, 50-53
   :dedent: 8
   :language: java

See the :sdk-examples-java-ec2:`complete example <MonitorInstance.java>`.

Stopping Instance Monitoring

To stop monitoring an instance, create an :aws-java-class:`UnmonitorInstancesRequest <services/ec2/model/UnmonitorInstancesRequest>` with the ID of the instance to stop monitoring, and pass it to the |ec2client|'s :methodname:`unmonitorInstances` method.

Imports

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/MonitorInstance.java
   :lines: 16-17, 19
   :language: java

Code

.. literalinclude:: example_code/ec2/src/main/java/aws/example/ec2/MonitorInstance.java
   :lines: 62-63, 82-85
   :dedent: 8
   :language: java

See the :sdk-examples-java-ec2:`complete example <MonitorInstance.java>`.

More Information