Restrictions
Available through: CLI, Python SDK, Rust SDK, API
This document describes how to set restrictions on providers or regions used by the Seaplane Global Coordination Services (Coordination APIs) including the Metadata Key-Value Store (Metadata KVS) and Locks.
By default, the Coordination APIs store data globally, across providers, for the best end-user performance. With the restriction API, you can override the default behavior and restrict the use of locations or providers. For the best performance, we recommended using restrictions only when absolutely necessary for regulatory purposes (GDPR compliance, for example).
Note that having too many restrictions can impact performance. For example:
- Data restricted to a single country could increase latency for users across the globe.
- Data restricted to a single cloud provider could become unavailable when that provider suffers an outage.
Restrictions are applied to a directory and are specific to an API. For example, restrictions set to a directory called /prod/ in the Metadata KVS do not affect any directory within the Locks service.
Restrictions can exist without the affected directory existing i.e., you can set
up restrictions before creating your directories. For example, you can create a
restriction on the eu directory to limit the geographic location of the data
in eu to the European Union. Creating the directory and adding a key
automatically applies the predefined restrictions. Similarly, deleting a
directory does not remove a restriction.
For more information and code examples, see the restrictions API docs.
Restriction State​
The restriction state indicates if a restriction is pending or enforced.
Introducing a new restriction takes some time as the data moves to comply with
the new rule. During this time, the restriction is pending. Once completed,
the restriction state is enforced.
Supported Regions​
| 2-letter code | Full Name |
|---|---|
| AE | United Arab Emirates |
| AU | Australia |
| BE | Belgium |
| BH | Bahrain |
| BR | Brazil |
| CA | Canada |
| CH | Switzerland |
| CL | Chile |
| DE | Germany |
| ES | Spain |
| FI | Finland |
| FR | France |
| GB | United Kingdom of Great Britain and Northern Ireland |
| HK | Hong Kong |
| ID | Indonesia |
| IE | Republic of Ireland |
| IN | India |
| IT | Italy |
| JP | Japan |
| KR | Korea, Republic of |
| NL | Netherlands |
| PL | Poland |
| RO | Romania |
| SE | Sweden |
| SG | Singapore |
| TW | Taiwan |
| US | United States of America |
| ZA | South Africa |
| In addtion to countries the following grouped geo-regions are available | |
| XA | Asia |
| XC | People's Republic of China |
| XE | Europe |
| XF | Africa |
| XN | North America |
| XO | Oceania |
| XQ | Antartica |
| XS | South America |
| XU | The UK |
Supported Providers​
| Full Name | Alias |
|---|---|
| Amazon Web Services | aws |
| Microsoft Azure | azure |
| Digtial Ocean | digitalocean |
| Equinix | equinix |
| Google Cloud Platform | gcp |