Expected EC2 DescribeInstances Response when instance has been terminated

Question

I am trying to programmatically determine whether an EC2 instance with a given instance id has been terminated. Every instanceId I am using belonged to an instance that I owned at one point, but may have been terminated at some point in history.

I am using the Java AWS SDK, version 2.22.10, though we try to keep up with the latest version.

This is the SDK method I am using: https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#describeInstances(software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest)

and I am constructing the request like this:
```
DescribeInstancesRequest request = DescribeInstancesRequest.builder()
    .instanceIds(instanceId)
    .build();
```

I'm noticing something odd. If the instance has been terminated, there are at least two different ways the SDK/API will respond:
1. It will return a successful response with an empty list of instances.
2. It will throw a `software.amazon.awssdk.services.ec2.model.Ec2Exception` with a 400 status code and a message indicating that the instance does not exist.

My question is:
What is the difference between these two responses? Under what conditions will describing a terminated instance cause it to be omitted from the response vs return a 400?

Answer

As you may know, an instance sticks around for a bit after being terminated (you can even view it in the console). Unless you have a log that stated it was terminated it can be hard to know for certain. For example the API may respond as if the instance never existed, or what if its just an outage preventing you from getting the correct information back.

Pardon my unsolicited suggestion. When you get a 400, you catch the 400 and check CloudTrail (via API) to see if there is a log. However there is a limit to how long cloud train keeps that information, so you could also write it to an S3 bucket and query there if the instance was terminated.

See this SO answer for hints too https://stackoverflow.com/a/35054667/419097

Expected EC2 DescribeInstances Response when instance has been terminated

Relevant content