VPS.org API

Документация REST API

API местоположений

Retrieve information about available datacenter locations for VPS deployment.

Конечные точки 1 endpoint
Базовый путь /api/v1/locations
ПОЛУЧАТЬ /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

По требованиям соблюдения

Эффективность сети

Самый низкий уровень представленности на основных рынках
  • Северная Америка: Нью-Йорк (2 мс на восток США), Сан-Франциско (2 мс на запад США)
  • Европа: Франкфурт (3 мс), Лондон (5 мс)
  • Азия: Сингапур (5 мс), Токио (8 мс)
  • Океания: Сидней (только вариант)
< < Лучшая для глобального распределения > >
  1. Начальное: Нью-Йорк или Сан-Франциско (самая широкая база пользователей)
  2. Средняя школа: Лондон или Франкфурт (европейский охват)
  3. Высшее образование: Сингапур или Токио (азиатский охват)
Про Тип: Что касается важнейших для миссий прикладных программ, то они должны быть развернуты во многих местах с автоматической отставкой на максимальный срок работы и с учетом географической избыточности.

Инфраструктура центра данных

Стандартные характеристики (все места)

  • ✓ Уровень III или более высокие центры данных
  • ✓ 100 процентов от общего числа военнослужащих ОАС, работающих в нерабочем режиме
  • ✓ Мощность разбавителя (N+1 или 2N)
  • ✓ Охлаждение с избытком
  • ✓ 24/7 Физическая безопасность
  • ✓ Контроль за биометрической доступностью
  • ✓ Защита DDOS (до 10 ТТС)
  • ✓ Поддержка IPv4 и IPv6
  • ✓ Частные сети (VLAN)
  • ✓ 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 в другое место с помощью снимков:

  1. Создать снимок вашего существующего VPS
  2. Создать новый VPS в целевом месте
  3. Восстановить снимок на новый VPS
  4. Обновление записей DNS для указания на новый IP
  5. Удалить старый VPS после проверки миграции
Замечание: Перемещение в новое место приведет к созданию нового IP-адреса.

Развертывание с учетом нескольких потребностей

Для обеспечения высокой доступности и глобального охвата рассмотреть возможность развертывания во многих местах:

Примеры использования
  • Предоставление глобального контента
  • Географическое балансирование нагрузки
  • Послеаварийное восстановление
  • Соблюдение законов о местожительстве
  • Сокращение запоздалости для международных пользователей
Осуществление
  • Баланс нагрузки на основе DNS (GeoDNS)
  • Интеграция CDN (Cloudflare и т.д.)
  • Воспроизведение базы данных по регионам
  • Совместные решения в области хранения
  • Неисправность прикладных программ
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.