Sijainti-API

SAADA /api/v1/locations/

Listaa kaikki sijainnit

Hae lista kaikista käytettävissä olevista datakeskuspaikoista, joissa voit ottaa käyttöön VPS-palvelimia.

Kyselyparametrit

Muuttuja	Tyyppi	Pakollinen	Tavaran kuvaus
`region`	string	Ei tarvitse.	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Ei tarvitse.	Show only locations currently accepting new servers

Esimerkkipyyntö

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

Esimerkkivastaus

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

Vastauskentät

Kenttä	Tyyppi	Tavaran kuvaus
`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

Vastauksen tilakoodit

200	Sijaintiluettelo noudettu onnistuneesti
401	Luvaton - Virheellinen tai puuttuva todennustunnus

Choosing the Right Location

Kohdeyleisön toimesta

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

Vaatimustenmukaisuusvaatimuksilla

GDPR (EU:n tietosuoja): London, Frankfurt
Yhdysvaltain dataresidenssi: New York, San Francisco
Kanadan tiedon suvereniteetti: Toronto
APAC-tietojen residenssi: Singapore, Tokyo, Sydney

Verkon suorituskyky

Alin latenssi suurmarkkinoilla

Pohjois-Amerikka: New York (2 ms Yhdysvaltain itäosaan), San Francisco (2 ms Yhdysvaltain länsiosaan)
Eurooppa: Frankfurt (3 ms), Lontoo (5 ms)
Aasia: Singapore (5 ms), Tokio (8 ms)
Oseania: Sydney (vain vaihtoehto)

Paras maailmanlaajuiselle jakelulle

Ensisijainen: New York tai San Francisco (suurin käyttäjäkunta)
Toissijainen: Lontoo tai Frankfurt (Eurooppa-kattavuus)
Korkea-arvoisuus: Singapore tai Tokio (Asian uutisointi)

Pro vinkki: Operaatiokriittisissä sovelluksissa on otettava käyttöön useita paikkoja, joissa automaattinen reputus tapahtuu maksimaalista käyttöaikaa ja maantieteellistä irtisanomista varten.

Datakeskusinfrastruktuuri

Standardiominaisuudet (Kaikki sijainnit)

✓ Taso III tai korkeammat datakeskukset
✓ 100 % käyttöajan SLA
✓ Lunastava teho (N+1 tai 2N)
✓ Jäähdytysaine
✓ Vuorokautinen fyysinen turvallisuus
✓ Biometriset kulunvalvontalaitteet

✓ DDoS-suojaus (enintään 10 Tbps:n lieventäminen)
✓ IPv4- ja IPv6-tuki
✓ Yksityinen verkostoituminen (VLAN)
✓ 10 Gbps+-verkon selkäranka
✓ Useita tuotantoketjun alkupään tarjoajia
✓ BGP:n vertaileminen suuriin verkkoihin

Verkkojen tarjoajat

Sijainti	Palveluntarjoaja	Määrittämistaso	Huomautukset
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

Paikkojen välillä liikkuminen

Voit siirtää VPS:n toiseen paikkaan kuvakaappauksilla:

Luo kuva olemassa olevasta VPS:stä
Luo uusi VPS kohdepaikkaan
Palauta tilannekuva uudelle VPS:lle
Päivitä DNS-tallenteet uuteen IP-osoitteeseen
Poista vanha VPS, kun muutto on varmistettu

Huomaa: Muutto uuteen paikkaan johtaa uuteen IP-osoitteeseen. DNS:n lisäysajan suunnitelma (tyypillisesti 24–48 tuntia täydelliseen maailmanlaajuiseen leviämiseen).

Monipaikkaisuus

Korkean käytettävyyden ja maailmanlaajuisen ulottuvuuden varmistamiseksi on harkittava käyttöönottoa useassa paikassa:

Käytä tapauksia

Maailmanlaajuinen sisältötoimitus
Maantieteellinen kuormituksen tasapainotus
Katastrofien toipuminen
Tietojen oleskelua koskevien lakien noudattaminen
Vähentynyt latenssi kansainvälisille käyttäjille

Täytäntöönpano

DNS-pohjainen kuormituksen tasapainotus (GeoDNS)
CDN-integraatio (Cloudflare jne.)
Tietokannan replikointi eri alueilla
Jaetut säilytysratkaisut
Sovellustason reputus

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

VPS.org API