API месцазнаходжанняў

АТРЫМАЦЬ /api/v1/locations/

Спіс усіх месцаў

Атрымаць спіс усіх даступных месцаў цэнтраў дадзеных, дзе можна разгарнуць серверы VPS.

Параметры запыту

Параметры	Тып	Абавязкова	Апісанне
`region`	string	Не	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Не	Show only locations currently accepting new servers

Прыклад запыту

cURL

Python

JavaScript

PHP

curl -X GET "https://admin.vps.org/api/v1/locations/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

url = "https://admin.vps.org/api/v1/locations/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/locations/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const locations = await response.json();
console.log(locations);

$ch = curl_init('https://admin.vps.org/api/v1/locations/');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$locations = json_decode($response, true);
curl_close($ch);

Прыклад адказу

{
  "count": 8,
  "results": [
    {
      "id": 1,
      "name": "New York",
      "slug": "ny-usa",
      "country": "United States",
      "country_code": "US",
      "city": "New York",
      "region": "north-america",
      "continent": "North America",
      "available": true,
      "latitude": 40.7128,
      "longitude": -74.0060,
      "network_provider": "Digital Realty",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to US East Coast"
      ],
      "average_latency_ms": {
        "us-east": 2,
        "us-west": 75,
        "europe": 85,
        "asia": 220
      }
    },
    {
      "id": 2,
      "name": "San Francisco",
      "slug": "sf-usa",
      "country": "United States",
      "country_code": "US",
      "city": "San Francisco",
      "region": "north-america",
      "continent": "North America",
      "available": true,
      "latitude": 37.7749,
      "longitude": -122.4194,
      "network_provider": "Equinix",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to US West Coast & Asia"
      ],
      "average_latency_ms": {
        "us-east": 75,
        "us-west": 2,
        "europe": 150,
        "asia": 120
      }
    },
    {
      "id": 3,
      "name": "London",
      "slug": "lon-uk",
      "country": "United Kingdom",
      "country_code": "GB",
      "city": "London",
      "region": "europe",
      "continent": "Europe",
      "available": true,
      "latitude": 51.5074,
      "longitude": -0.1278,
      "network_provider": "Telehouse",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "GDPR Compliant",
        "Low Latency to Europe"
      ],
      "average_latency_ms": {
        "us-east": 85,
        "us-west": 150,
        "europe": 5,
        "asia": 180
      }
    },
    {
      "id": 4,
      "name": "Frankfurt",
      "slug": "fra-de",
      "country": "Germany",
      "country_code": "DE",
      "city": "Frankfurt",
      "region": "europe",
      "continent": "Europe",
      "available": true,
      "latitude": 50.1109,
      "longitude": 8.6821,
      "network_provider": "Interxion",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "GDPR Compliant",
        "Central European Location"
      ],
      "average_latency_ms": {
        "us-east": 95,
        "us-west": 160,
        "europe": 3,
        "asia": 200
      }
    },
    {
      "id": 5,
      "name": "Singapore",
      "slug": "sgp-sg",
      "country": "Singapore",
      "country_code": "SG",
      "city": "Singapore",
      "region": "asia",
      "continent": "Asia",
      "available": true,
      "latitude": 1.3521,
      "longitude": 103.8198,
      "network_provider": "Equinix",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to Asia Pacific"
      ],
      "average_latency_ms": {
        "us-east": 250,
        "us-west": 180,
        "europe": 170,
        "asia": 5
      }
    },
    {
      "id": 6,
      "name": "Tokyo",
      "slug": "tok-jp",
      "country": "Japan",
      "country_code": "JP",
      "city": "Tokyo",
      "region": "asia",
      "continent": "Asia",
      "available": true,
      "latitude": 35.6762,
      "longitude": 139.6503,
      "network_provider": "Equinix",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to East Asia"
      ],
      "average_latency_ms": {
        "us-east": 180,
        "us-west": 120,
        "europe": 240,
        "asia": 8
      }
    },
    {
      "id": 7,
      "name": "Sydney",
      "slug": "syd-au",
      "country": "Australia",
      "country_code": "AU",
      "city": "Sydney",
      "region": "oceania",
      "continent": "Oceania",
      "available": true,
      "latitude": -33.8688,
      "longitude": 151.2093,
      "network_provider": "NextDC",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to Australia & New Zealand"
      ],
      "average_latency_ms": {
        "us-east": 210,
        "us-west": 140,
        "europe": 280,
        "asia": 120
      }
    },
    {
      "id": 8,
      "name": "Toronto",
      "slug": "tor-ca",
      "country": "Canada",
      "country_code": "CA",
      "city": "Toronto",
      "region": "north-america",
      "continent": "North America",
      "available": true,
      "latitude": 43.6532,
      "longitude": -79.3832,
      "network_provider": "Cologix",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Data Sovereignty (Canada)"
      ],
      "average_latency_ms": {
        "us-east": 20,
        "us-west": 65,
        "europe": 90,
        "asia": 210
      }
    }
  ]
}

Палі адказаў

Поле	Тып	Апісанне
`id`	integer	Unique location identifier
`name`	string	Human-readable location name
`slug`	string	URL-friendly location identifier
`country`	string	Country name
`country_code`	string	ISO 3166-1 alpha-2 country code
`city`	string	City name
`region`	string	Geographic region (north-america, europe, asia, oceania)
`continent`	string	Continent name
`available`	boolean	Whether location is accepting new servers
`latitude`	decimal	Geographic latitude
`longitude`	decimal	Geographic longitude
`network_provider`	string	Datacenter/network provider name
`features`	array	List of location-specific features
`average_latency_ms`	object	Average latency in milliseconds to major regions

Коды стану адказу

200	Спіс месцаў паспяхова атрыманы
401	Несанкцыянавана — несапраўдны або адсутнічае токен аўтэнтыфікацыі

Choosing the Right Location

Па мэтавай аўдыторыі

Target Audience	Recommended Locations	Why
US East Coast Users	New York, Toronto	Lowest latency (2-20ms), close proximity
US West Coast Users	San Francisco	Lowest latency (2ms), silicon valley connectivity
European Users	London, Frankfurt	GDPR compliant, low latency (3-5ms) across Europe
Asian Users	Singapore, Tokyo	Best connectivity to Asia Pacific region (5-8ms)
Australian/NZ Users	Sydney	Only Oceania location, lowest latency to Australia
Global Audience	Multiple locations with load balancing	Deploy in 2-3 regions for global coverage

Па патрабаваннях да адпаведнасці

Захаванне дадзеных London, Frankfurt
Злучаныя Штаты Амерыкі New York, San Francisco
Канадскі суверенітэт над дадзенымі: Toronto
Рэзідэнцыя дадзеных APAC: Singapore, Tokyo, Sydney

Хуткасць сеткіName

Найменшая задержка для галоўных рынкаў

Паўночная Амерыка Нью- Ёрк (2 мс на ўсход ад ЗША), Сан- Францыска (2 мс на захад ад ЗША)
Еўропа: Франкфурт (3 мсек), Лондан (5 мсек)
Азія: Сінгапур (5 мс), Токіа (8 мс)
Акіянія/ Аўстралія Сідней (толькі опцыя)

Глабальная дыстрыбуцыя

Асноўны: Нью- Ёрк або Сан- Францыска (найбуйнейшая база карыстальнікаў)
Другі: Лондан або Франкфурт (Еўропа)
Ісці да наступнага элемента Сінгапур або Токіа (Азія)

Падказка: Для крытычных праграм, разгортванне ў некалькіх месцах з аўтаматычным пераключэннем на іншыя для максімальнага часу працы і геаграфічнай рэзервоўкі.

Інфраструктура цэнтра дадзеных

Стандартныя магчымасці (усе месцы)

✓ Цэнтры дадзеных III ці вышэйшага ўзроўню
✓ 100% SLA
✓ Рэзервовая магутнасць (N+1 або 2N)
✓ Рэзервовая сістэма астуджэння
✓ Фізічная абарона 24/7
✓ Біямэтрычныя ўласцівасьці доступу

✓ Захаванне ад DDoS (да 10 Тб/ с)
✓ Падтрымка IPv4 і IPv6
✓ Прыватная сетка (VLAN) Name
✓ Сеткавая сцяна 10 Gbps+
✓ Некалькі пастаўшчыкоў
✓ Партнёрства BGP з асноўнымі сеткамі

Пастаўшчыкі сеткі

Месцазнаходжанне	Пастаўшчык	Стварыць	Заметкі
New York	Digital Realty	Tier III	Major internet exchange point
San Francisco	Equinix	Tier III	Silicon Valley connectivity hub
London	Telehouse	Tier III	LINX (London Internet Exchange)
Frankfurt	Interxion	Tier III	DE-CIX (world's largest IXP)
Singapore	Equinix	Tier III	Asia Pacific connectivity hub
Tokyo	Equinix	Tier III	JPIX and JPNAP peering
Sydney	NextDC	Tier III	Oceania's largest datacenter
Toronto	Cologix	Tier III	Canadian data sovereignty

Location Migration & Multi-Region Deployment

Перамяшчэнне па месцазнаходжанні

Вы можаце перанесці VPS у іншае месца, выкарыстоўваючы здымак экрана:

Стварэньне здымак экрану існуючага VPS
Стварыць новы VPS у мэтавай пазіцыі
Адрабіць здымак экрана на новы VPS
Абнавіць запісы DNS, каб паказваць на новы IP
Выдаліць старыя VPS пасля праверкі міграцыі

Заметка: Міграцыя ў новую пазіцыю прывядзе да новага IP- адрасу. Плануйце час распаўсюджвання DNS (звычайна 24- 48 гадзін для поўнай глабальнай распаўсюджвання).

Некалькі месцаў разгортвання

Для высокай даступнасці і глабальнага дасягнення, разгледзьце разгортванне ў некалькіх месцах:

Выкарыстанне

Глабальная дастаўка змесціва
Геаграфічны баланс загрузкі
Аднаўленне пасля аварыі
Згоднасць з законамі пра месцазнаходжанне дадзеных
Зменшыць зацягванне для замежных карыстальнікаў

Рэалізацыя

Балансаваньне нагрузкі на аснове DNS (GeoDNS)
Інтэграцыя CDN (Cloudflare і інш.)
Рэплікацыя базы дадзеных па рэгіёнах
Name=Спасылка на файл
Адключэнне на ўзроўні праграмы

Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.

VPS.org API