Log Exception while retrieving instance list from AWS API: – How To Solve Related Issues

Log Exception while retrieving instance list from AWS API: – How To Solve Related Issues

Opster Team

Jan-20, Version: 1.7-8.0


Before you begin reading this guide, we recommend you try running the Elasticsearch Error Check-Up  which can resolve issues causing many log errors (free and no installation required)


This guide will help you check for common problems that cause the log “Exception while retrieving instance list from AWS API:” to appear. It’s important to understand the issues related to the log, so to get started, read the general overview on common issues and tips related to the Elasticsearch concepts: cloud-aws, discovery, discovery-ec2, hosts, plugins.

Advanced users might want to skip right to the common problems section in each concept or try running the Check-Up which analyses ES to discover the cause of many errors and provides suitable actionable recommendations. 

Log Context

Log”Exception while retrieving instance list from AWS API: {}” classname is AwsEc2UnicastHostsProvider.java
We extracted the following from Elasticsearch source code for those seeking an in-depth context :

             // NOTE: we don't filter by security group during the describe instances request for two reasons:
            // 1. differences in VPCs require different parameters during query (ID vs Name)
            // 2. We want to use two different strategies: (all security groups vs. any security groups)
            descInstances = SocketAccess.doPrivileged(() -> clientReference.client().describeInstances(buildDescribeInstancesRequest()));
        } catch (final AmazonClientException e) {
            logger.info("Exception while retrieving instance list from AWS API: {}"; e.getMessage());
            logger.debug("Full exception:"; e);
            return dynamicHosts;

        logger.trace("building dynamic unicast discovery nodes...");


Related issues to this log

We have gathered selected Q&A from the community and issues from Github, that can help fix related issues please review the following for further information :

1 Elasticsearch EC2 discovery fails with “invalid credentials” -views 2.11 K ,score 4

AWS IAM role not working with Elasticsearch 5.0.0-alpha2, but works with 2.3 version -views   0.18 K,score 1


About Opster

Opster line of products and support services detects, prevents, optimizes and automates everything needed to manage mission-critical Elasticsearch.

Find Configuration Errors

Analyze Now