Unlimited customers can create multiple API keys and assign as many as they would like to different instance(s).
It's often helpful to have multiple API keys for different purposes, such as for development/staging/production or for different applications.
Unlimited customers can create as many API keys as desired. All traffic will route through their dedicate instance(s).
Multiple API keys can be associated with a single instance.
Unlimited customers with at least two instances have access to what we call Instance Pools, which allow you to group dedicated instances together.
Each pool can have one or more API keys associated. All API requests using an API key associated with a pool will automatically be routed evenly across all instances in that pool.
This means you can have a variety of relationships between API keys and instances:
By default, Geocodio will add any additional instances to a single pool (Pool A), and automatically load-balance your traffic between all of your dedicated instances.
However, if you have several dedicated instances, you might want to create multiple pools to separate out different use cases.
For example, let's say you have two instances that are shared by four applications. You can have an API key for each application, and choose how the instances are allocated: two API keys to each instance, three API keys for one instance and the second instance with one API key, and so forth.
This way, you can ensure that the available resources are appropriately allocated to each application so that one application's heavy traffic volume will not affect another application.
When you have multiple pools, you can choose which pool to use for spreadsheet processing.
This can be useful when, for example, you have instances being used in production with live API integrations and want separate resources for your non-technical internal users to upload spreadsheets.
Other API keys can be associated with this pool as well. For example, you might have two instances dedicated to your production API key, and one instance dedicated to development, staging, and spreadsheet processing, with development and staging each having their own API keys.
If you are a team admin of an Unlimited account, you can create a new pool via the Instance section of the dashboard (Standard or Enterprise). (Only administrators of Unlimited accounts can access the page.)
If you have any questions about setting up instance pools, please reach out and we'll be happy to help.