API lokalizacji

DOSTAWAĆ /api/v1/locations/

Wyświetl wszystkie lokalizacje

Pobierz listę wszystkich dostępnych lokalizacji centrum danych, w których można uruchomić serwery VPS.

Parametry zapytania

Parametr	Typ	Wymagany	Opis
`region`	string	Nie.	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Nie.	Show only locations currently accepting new servers

Przykładowe żądanie

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);

Przykładowa odpowiedź

{
  "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
      }
    }
  ]
}

Pola odpowiedzi

Pole	Typ	Opis
`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

Kody statusu odpowiedzi

200	Lista lokalizacji została pomyślnie pobrana
401	Nieautoryzowany – nieprawidłowy lub brakujący token uwierzytelniający

Choosing the Right Location

Wg celowej publiczności

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

Zgodnie z wymogami zgodności

GDPR (Ochrona danych UE): London, Frankfurt
Rezydencja danych USA: New York, San Francisco
Kanadyjska suwerenność danych: Toronto
Rezydencja danych APAC: Singapore, Tokyo, Sydney

Efektywność sieci

Najniższa łatelność do głównych rynków

Ameryka Północna: Nowy Jork (2 miliony na wschód USA), San Francisco (2 miliony na zachód USA)
Europa: Frankfurt (3ms), Londyn (5ms)
Azja: Singapur (5ms), Tokio (8ms)
Oceania: Sydney (tylko opcja)

Najlepszy dla globalnego dystrybucji

Podstawowy: Nowy Jork lub San Francisco (największa baza użytkowników)
Drugorzędne: Londyn lub Frankfurt (zakres Europy)
Termiary: Singapur lub Tokio (zakres Azji)

Pro Wskazówka: W przypadku zastosowań krytycznych dla misji, rozmieszczać do wielu miejsc z automatycznym niepowodzeniem dla maksymalnego okresu audycji i zwolnienia geograficznego.

Infrastruktura centrum danych

Standardowe cechy (wszystkie lokalizacje)

✓ Tier III lub wyższe centrum danych
✓ SLA w 100% przerwy w czasie trwania
✓ Siła odzysku (N+1 lub 2N)
✓ Chłodzenie chłodzące
✓ 24/7 bezpieczeństwo fizyczne
✓ Kontrole dostępu biometrycznego

✓ Ochrona DDOS (do 10 Tbps łagodzenia)
✓ Wsparcie IPv4 i IPv6
✓ Sieć prywatna (VLAN)
✓ 10 Gbps+ kręgosłup sieci
✓ Wielokrotne dostawcy z góry
✓ BGP angażuje się w główne sieci

Dostawcy sieci

Lokalizacja	Dostawca	Poziom szczelności	Uwagi
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

Przemieszczanie pomiędzy lokalizacjami

Można przenieść swój VPS na inną lokalizację przy użyciu zdjęć:

Stwórz zdjęcie istniejącego VPS
Utwórz nowy VPS w miejscu docelowym
Przywróć zdjęcie do nowego VPS
Aktualizuj zapisy DNS do nowego IP
Usuń stary VPS po weryfikacji migracji

Uwaga: Migrowanie do nowej lokalizacji spowoduje nowy adres IP. Plan na czas rozmnażania DNS (zazwyczaj 24-48 godzin dla pełnej globalnej rozmnażania).

Wdrożenie wielu miejsc

W celu zapewnienia wysokiej dostępności i globalnego zasięgu rozważyć rozmieszczenie w wielu miejscach:

Przypadki użytkowania

Globalne dostarczanie treści
Balansowanie obciążeń geograficznych
Odzyskiwanie klęsk żywiołowych
Zgodność z przepisami dotyczącymi pobytu danych
Zmniejszone latencje dla międzynarodowych użytkowników

Wdrożenie

Balansowanie obciążeń oparte na DNS (GeoDNS)
Integracja CDN (Cloudflare, itp.)
Replikacja bazy danych w regionach
Rozwiązania dotyczące wspólnego przechowywania
Nieprawidłowość w zakresie stosowania

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

VPS.org API