How do I resolve the "InsufficientInstanceCapacity" error in OpenSearch Service?

Resolution

The "InsufficientInstanceCapacity" error occurs when AWS doesn't have enough available Amazon Elastic Compute Cloud (Amazon EC2) On-Demand Instance capacity in the specified Availability Zone. To troubleshoot this issue, take the following actions.

Retry after a short wait

Capacity availability in AWS frequently changes. Wait a few minutes, and then resubmit your request. If the capacity becomes available, then your request succeeds.

Reduce the number of instances in your request

The "InsufficientInstanceCapacity" error occurs when the requested instance type isn't immediately available in the requested Availability Zone. To prevent this issue, it's a best practice to launch new data nodes in smaller batches instead of as one large request.

For example, if you're adding 15 data nodes to your cluster, then split the request into multiple smaller launches. You can also perform a test first to validate instance availability before you apply the changes.

Important: To upgrade the instance type of existing nodes or add Amazon Elastic Block Store (Amazon EBS) volumes, you can't batch requests. For these configuration changes, you must update all the nodes at the same time.

Don't specify an Availability Zone

Remove the Availability Zone in requests that include one. Then, retry the request so that AWS can place the instance in an Availability Zone with available capacity.

Use a different instance type

If possible, then select a different instance type to check whether the new type is available. You can resize your instances after you change the configuration.

Reserve capacity for critical workloads

In production or time-sensitive environments, it's a best practice to use Reserved Instances or Amazon EC2 On-Demand Capacity Reservations to proactively reserve instance capacity. This configurations helps you avoid deployment failures when there's a capacity shortage.