Regions and datacenters

A region is a geographic area with its own installation of a service (such as iran-1). A datacenter is where your server actually runs (Concepts). The panel and the APIs read the datacenter list from live data: a new datacenter appears without a release, and a datacenter that is full is closed to orders for a while. So this page only shows the stable structure; get today's list from the addresses given for each product.

Products and regions

Product	Where it is offered	How to pick the location
Arianet Cloud	Arianet Cloud datacenters (live list below)	datacenter field or parameter (datacenter code)
VPS	Many datacenters in Iran, Europe, Turkey, the USA and Australia	datacenter_id
Regional VPS	Region iran-1, Tehran datacenter (thr-1)	Arianet-Region header and datacenter field
Hosting	Region iran-1, Tehran datacenter (thr)	Arianet-Region header and datacenter field
Dedicated servers	Datacenters in North America (Canada), Europe, Asia and Australia	datacenter field in the order
SMS	Region iran-1 only	not needed
Domains	not tied to a region	-

Live lists

Product	Datacenters	Plans and prices	Images
Cloud	GET /cloud/v1/datacenters	GET /cloud/v1/plans?datacenter=..., and without a token: GET /cloud/v1/public/pricing	GET /cloud/v1/datacenters/{code}/images
VPS (/api/v1)	GET /api/v1/regions	GET /api/v1/plans/datacenter/{datacenter_id}	GET /api/v1/os/datacenter/{datacenter_id}
Regional VPS	GET /vps/v1/datacenters	GET /vps/v1/plans?datacenter=...	GET /vps/v1/images?datacenter=...
Hosting	GET /hosting/v1/datacenters	GET /hosting/v1/plans?datacenter=...	-
Dedicated servers	GET /baremetal/v1/plans/{catalog}/{plan}/options (each model's datacenters)	GET /baremetal/v1/plans	each server's OS list is on that server's page

All of these are on https://api.ariaservice.net and need an API token, except the cloud's public price list. In the panel, the live list appears in the first step of buying each product (choosing a region or datacenter).

Choosing a region in the API

Regional VPS and hosting have a separate installation per region. Pick the region with the Arianet-Region header; without it, the request goes to the product's default region (iran-1 today). An unknown region gets 404 region_not_found, and a region that is temporarily unreachable gets 503 region_unavailable. A hosting account or regional VPS is visible only in the region it was created in. Details are in API conventions.

The cloud, VPS (/api/v1) and dedicated servers have one installation; you choose the location by datacenter only.

How datacenters differ

Datacenters do not all have the same features and rules. Read a datacenter's details in the panel before buying:

• Features: IPv6, private networks, floating and elastic IPs, firewalls, SSH keys, backups, IP change and unlimited traffic exist only in some datacenters. In VPS (/api/v1), the supports field in GET /regions says whether firewalls and SSH keys are supported. Creating a resource a datacenter does not offer is refused with 422.
• Datacenter rules: each datacenter has its own terms (such as minimum usage, IP change rules and usage restrictions) that you accept before creating a server.
• Closed datacenter or sold-out plan: a datacenter temporarily closed to orders stays in the list but cannot be ordered (in the cloud, 422 datacenter_closed). A plan whose capacity is full is refused with plan_sold_out; pick another datacenter or plan.
• Iranian IPs: servers with an Iranian IP must be registered in the Shahkar system (Shahkar registration).
• Price: a plan's price can differ between datacenters. The cloud price list gives each plan's price per location.

Images (operating systems)

• The image list is separate for each datacenter. Before creating or reinstalling a server, take the image from that datacenter's list (see Live lists).
• The cloud and regional VPS take an image by its short name (such as ubuntu-24.04); VPS (/api/v1) takes a numeric os_id.
• Common families: Ubuntu, Debian, AlmaLinux, Rocky Linux, CentOS Stream and Fedora. Some datacenters also have Windows, MikroTik or ready-made apps.
• ARM plans are not on sale.
• In the cloud you can also build a server from another server's snapshot or backup. A backup can only be restored onto a server in its own datacenter.