Standuert-API

KRITT /api/v1/locations/

All Standuerter opzielen

Et gëtt eng Lëscht vun alle verfügbare Datenzentren, wou Dir VPS-Serveren installéiere kënnt.

Ufroparameteren

Parameter	Typ	Erfuerderlech	Beschreiwung
`region`	string	Nee	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Nee	Show only locations currently accepting new servers

Beispill Ufro

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

Beispill Äntwert

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

Äntwertfelder

Feld	Typ	Beschreiwung
`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

Äntwertstatuscoden

200	Lëscht vun de Standuerter erfollegräich ofgeruff
401	Net autoriséiert - Ongültegen oder fehlenden Authentifikatiounstoken

Choosing the Right Location

No Zilgrupp

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

Compliance-Requirements

D'EU-Dateschutzrichtlinn London, Frankfurt
US-amerikanesch New York, San Francisco
Lëscht vu kanadesche Politiker Toronto
Websäit vun der Gemeng Singapore, Tokyo, Sydney

Netzwierkleistung

Lëscht vun de gréisste Stären

Nordamerika New York (2ms bis US Osten), San Francisco (2ms bis US Westen)
Europa Lëtzebuerg (3), Lëtzebuerg (5)
Asien: Singapur (5ms), Tokio (8ms)
Ozeanien Sydney (nëmme Optioun)

Global Distributioun

Primär: New York oder San Francisco (gréisst Benotzerbasis)
Sekundär: Lëtzebuerg (Lëtzebuerg) Lëtzebuerg (Frankräich)
Tertiär: Singapur oder Tokio (Asien-Decken)

Tipp: D'Applikatioun vun der Funktionalitéit vun der Funktionalitéit an der Funktionalitéit vun der Funktionalitéit an der Funktionalitéit an der Funktionalitéit.

Websäit vun der Gemeng

Standardfeatures (all Plazen)

✓ D'Serie 3000 oder och Série 3000
✓ 100% Uptime SLA
✓ D'Resultat ass d'Resultat vun der 1. an 2.
✓ Lëscht vu Klengstären
✓ 24/7-Sécherheet
✓ Biometrie

✓ DDoS Schutz (bis zu 10 Tbps Mitigatioun)
✓ IPv4 an IPv6-Unterstützung
✓ Privat Netzwierker (VLAN)
✓ Lëscht vun de lëtzebuergesche Gemengen
✓ Multi-Upstream-Provider
✓ Lëscht vun de gréisste Stären

Netzwierkprovider

Plaz	Provider	Tier	Notizen
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

Zwischen den Orten bewegen

Dir kënnt Äre VPS mat Schnappschëss op eng aner Plaz migréieren:

E Schnappschuss vun Ärem VPS erstellen
Erstellen vun engem neie VPS am Zil-Plaz
Den Schnappschuss op den neie VPS zrécksetzen
DNS-Datensätze aktualiséieren fir op nei IP-Adressen ze weisen
Al VPS ewechhuelen nodeems d'Migratioun verifizéiert ass

Notiz: Wann Dir op en neien Standuert migréiert, kritt Dir eng nei IP- Adress. Plangt d' DNS- Verbreedungszäit (gewéinlech 24- 48 Stonnen fir eng vollstänneg global Verbreedung).

Multi-Location Deployment

Fir eng héich Verfügbarkeet an eng global Reichweite, sollt een iwwerleeën, op méi Plazen ze deployéieren:

Use Cases

Globale Inhaltsiwwerdroung
Geographesch Koordinaten
Katastrophenwiederherstellung
Lëscht vun de lëtzebuergesche Gesetzer
Reduzéiert Latenz fir international Benotzer

Implementatioun

D'Geographie vun der Groussregioun (fr)
D'Géigend ass räich un Ueleger (Cypress, etc.).
Websäit vun der Gemeng
Lëscht vun de Verwaltungsgebidder
Failover op Applikatiounsniveau

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

VPS.org API