How to Get the Public DNS of an Amazon EC2 Instance from the JAVA API

In the realm of cloud computing, developers commonly use Amazon Elastic Compute Cloud (EC2) instances. These virtual servers in Amazon’s cloud provide secure, resizable compute capacity. It’s a fundamental part of any software engineer’s or data scientist’s toolkit when working with AWS.

By Saturn Cloud | Tuesday, August 08, 2023 | Miscellaneous

How to Get the Public DNS of an Amazon EC2 Instance from the JAVA API

This post aims to guide you through the process of obtaining the Public Domain Name System (DNS) of an EC2 instance using the Amazon Web Services (AWS) Java API. A Public DNS is a string representation that resolves to the public IP address of your EC2 instance and is necessary for remote access and management of the instance.

Prerequisites

Before we jump into the code, ensure you’ve set up the following:

An AWS account with appropriate permissions to access EC2 instances.
AWS SDK for Java. You can add it to your project using Maven or Gradle.
Valid AWS Access Key and Secret Key.
An existing EC2 instance.

Establishing Connection with AWS

The initial step is to connect to AWS. We’ll use BasicAWSCredentials to authenticate our application, and AmazonEC2ClientBuilder to create an Amazon EC2 client.

import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.services.ec2.AmazonEC2;
import com.amazonaws.services.ec2.AmazonEC2ClientBuilder;

BasicAWSCredentials awsCreds = new BasicAWSCredentials("access_key", "secret_key");
AmazonEC2 ec2Client = AmazonEC2ClientBuilder.standard()
                            .withCredentials(new AWSStaticCredentialsProvider(awsCreds))
                            .withRegion(Regions.US_EAST_1) // Specify your region
                            .build();

Fetching Public DNS of EC2 Instance

To fetch the Public DNS, we’ll use DescribeInstancesRequest and DescribeInstancesResult classes. Replace 'Instance-ID' with the ID of your EC2 instance.

import com.amazonaws.services.ec2.model.DescribeInstancesRequest;
import com.amazonaws.services.ec2.model.DescribeInstancesResult;
import com.amazonaws.services.ec2.model.Reservation;

DescribeInstancesRequest request = new DescribeInstancesRequest().withInstanceIds("Instance-ID");
DescribeInstancesResult response = ec2Client.describeInstances(request);
List<Reservation> reservations = response.getReservations();

Each Reservation instance corresponds to a call to the run-instances command, and they contain one or more instances. To get the Public DNS, we need to traverse through these instances.

import com.amazonaws.services.ec2.model.Instance;

for (Reservation reservation : reservations) {
    for (Instance instance : reservation.getInstances()) {
        String publicDns = instance.getPublicDnsName();
        System.out.println("Public DNS: " + publicDns);
    }
}

Conclusion

Congratulations, you’ve successfully retrieved the Public DNS of an Amazon EC2 instance using the AWS Java API. This is an essential skill for managing EC2 instances programmatically, which can significantly boost your productivity when dealing with a large number of instances.

Remember to replace 'access_key', 'secret_key', and 'Instance-ID' with your actual AWS credentials and EC2 instance ID. Also, don’t forget to handle potential exceptions that may occur during the process – the AWS SDK for Java documentation is a great resource for this.

Understanding how to interact with AWS services programmatically is crucial for data scientists and software engineers alike. I hope this guide has been helpful, and as always, happy coding!

Keywords: AWS, Amazon EC2, Public DNS, AWS Java API, data scientist, software engineer, cloud computing.

About Saturn Cloud

Saturn Cloud is your all-in-one solution for data science & ML development, deployment, and data pipelines in the cloud. Spin up a notebook with 4TB of RAM, add a GPU, connect to a distributed cluster of workers, and more. Join today and get 150 hours of free compute per month.

Try Saturn Cloud Now