Regions and clusters
The DeepAffex Cloud API is a connected mesh of distributed AWS clusters, each of which is hosted within a specific geographic region of the globe.
Clusters
Each distinct DeepAffex cluster provides coverage across a designated region. This regional partitioning of service operates according to defined continent-based geolocation rules that use AWS's DNS Traffic Policy Lookup to manage all IP routing of the originating connection to the destination DeepAffex endpoint. The table below summarizes the rules.
Geographic location and associated routing rules
Rule name | Cluster name | Cluster location | Used by region | Comment |
---|---|---|---|---|
Default | na-east | North America (Northern Virginia, USA) | North America, Africa, Australia, Antarctica | The default rule applied when none of the others apply |
Europe | eu-central | Europe (Frankfurt, Germany) | Europe, Saudi Arabia | For Saudi Arabia, overrides Asia rule |
South America | sa-east | South America (Sao Paulo, Brazil) | South America | |
Asia | as-east | Asia (Tokyo, Japan) | Asia | Except Saudi Arabia |
Routing Options
Two routing options are available to NuraLogix integration partners who have licensed access to the DeepAffex API.
The details of both these options follow.
Option #1: Default Routing (no region locking)
With this option, you would use the global URL:
https://api.deepaffex.ai
for all network calls to the DeepAffex Cloud API.
Network traffic from each edge device will be routed to the cluster determined
using the routing rules described
in the table above.
-
Data processing: Data will be processed by the cluster determined by the routing rules.
-
Results storage: If your DeepAffex ORG is configured to store results, they will be stored in the cluster-name encoded in the active Device Token. This is the cluster that was used to obtain the token, either by registering a license or by renewing a token.
Note: The purpose of the default routing rules is to manage regional requirements for data localization and processing of customer traffic with the DeepAffex Cloud. It's important to recognize that these requirements are often contradictory, imprecise and lack consistency between customers so these routing rules may not satisfy all use-cases. If this default behaviour isn't desirable, please see the Region Locking alternative below.
URLs Where Routing Rules Are Applied
Service | Routing URL |
---|---|
DeepAffex API | https://api.deepaffex.ai |
DeepAffex Dashboard | https://dashboard.deepaffex.ai |
Anura Web Consumer | https://aw.nuralogix.ai |
Anura Web Enterprise / Web Measurement Service | https://awe.nuralogix.ai |
Checking Which Rules Apply To You
It's possible to check in advance which region your device will be routed to by calling the following endpoint:
curl https://api.deepaffex.ai/status
You may also visit https://api.deepaffex.ai/status in a browser from the region you want to check.
The response, will contain the "Region"
field:
{ ..., "Region":"na-east" }
If you want to check a different location, you may need to use a VPN.
Examples
Some examples of operating territories and the clusters they resolve to:
Operating territory | Resolves to cluster | Rule applied |
---|---|---|
Australia | na-east (Virginia, USA) | Default |
Canada | na-east (Virginia, USA) | Default |
Colombia | na-east (Virginia, USA) | South America |
India | as-east (Tokyo, Asia) | Asia |
Japan | as-east (Tokyo, Asia) | Asia |
New Zealand | na-east (Virginia, USA) | Default |
Saudi Arabia | eu-central (Frankfurt, Germany) | Europe |
South Africa | na-east (Virginia, USA) | Default |
Spain | eu-central (Frankfurt, Germany) | Europe |
UAE | as-east (Tokyo, Asia) | Asia |
Option #2: Region Locking
With this option, you use a specific DeepAffex cluster URL for all network calls to the DeepAffex Cloud. In this scenario, the integrator can entirely bypass our routing rules and instead lock access to a specific DeepAffex cluster.
-
Data processing: Data will be processed by the specific DeepAffex cluster used.
-
Results storage: If your DeepAffex ORG is configured to store measurement results, then results will be stored by the specific DeepAffex cluster used.
If region locking is a requirement for you, then please use the direct regional URLs shown below. For these URLs, data is processed (and results stored if configured) on the DeepAffex cluster corresponding to the specified URL.
Direct regional URLs
Region | URL |
---|---|
North America (N. Virginia, USA) Short code: na-east | https://api.na-east.deepaffex.ai https://dashboard.na-east.deepaffex.ai https://aw.na-east.nuralogix.ai https://awe.na-east.nuralogix.ai |
Europe (Frankfurt, Germany) Short code: eu-central | https://api.eu-central.deepaffex.ai https://dashboard.eu-central.deepaffex.ai https://aw.eu-central.nuralogix.ai https://awe.eu-central.nuralogix.ai |
South America (Sao Paulo, Brazil) Short code: sa-east | https://api.sa-east.deepaffex.ai https://dashboard.sa-east.deepaffex.ai https://aw.sa-east.nuralogix.ai https://awe.sa-east.nuralogix.ai |
Asia (Tokyo, Japan) Short code: as-east | https://api.as-east.deepaffex.ai https://dashboard.as-east.deepaffex.ai https://aw.as-east.nuralogix.ai https://awe.as-east.nuralogix.ai |
Asia Pacific (Hong Kong, HK) Short code: as-hk | https://api.as-hk.deepaffex.ai https://dashboard.as-hk.deepaffex.ai https://aw.as-hk.nuralogix.ai https://awe.as-hk.nuralogix.ai |