Docs Menu
Docs Home
/
Atlas
/
Query Federated Data
/
Administration

Update a Federated Database Instance Region

You can change the cloud provider region through which your federated database instance requests are routed. By default, Data Federation requests are routed through the region that is closest to your client application. The region that is closest to your application may be different from the regions that house your data stores.

Note

If you change the cloud provider region through which your federated database instance requests are routed, you must update your federated database instance connection string with the new hostname. This change ensures that your requests are routed through the new region.

Required Access

To update your federated database instance region, you must have Project Owner access to the project. Users with Organization Owner access must add themselves as a Project Owner to the project before setting up a private endpoint.

Procedure

To change the AWS region through which your federated database instance requests are routed, do the following in the Atlas CLI or Atlas UI:

To modify the details of the specified Data Federation database for your project using the Atlas CLI, run the following command:

atlas dataFederation update <name> [options]

To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas dataFederation update.

1

Select Data Federation from the left-hand navigation.

2

Click Ellipses (...) for your federated database instance.

3

Select Update Region from the dropdown to display the Update Region modal.

4

Choose the region through which to route your federated database instance requests:

  • The closest available region to allow Atlas to automatically choose the Data Federation region closest to you.

  • A specific region to specify the region through which your federated database instance requests must be routed.

5

Click Save for the changes to take effect.

The federated database hostname in your current federated database instance connection string will continue to work. However, to use the region you selected, you must update the federated database hostname in your federated database instance connection string. To utilize the new region, click the Connect button for your federated database instance and follow the steps in Connect to Your Federated Database Instance.