Atrašanās vietu API

IEGŪT /api/v1/locations/

Uzskaitīt visas atrašanās vietas

Iegūstiet visu pieejamo datu centru vietu sarakstu, kur varat izvietot VPS serverus.

Vaicājuma parametri

Parametrs	Tips	Obligāti	Apraksts
`region`	string	Nē	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Nē	Show only locations currently accepting new servers

Pieprasījuma piemērs

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

Atbildes piemērs

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

Atbildes lauki

Lauks	Tips	Apraksts
`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

Atbildes statusa kodi

200	Vietu saraksts veiksmīgi izgūts
401	Neautorizēts — nederīgs vai trūkstošs autentifikācijas marķieris

Choosing the Right Location

Pēc mērķauditorijas

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

Ar atbilstības prasībām

GDPR (ES datu aizsardzība): London, Frankfurt
ASV datu rezidence: New York, San Francisco
Kanādas datu suverēnība: Toronto
APAC datu rezidence: Singapore, Tokyo, Sydney

Tīkla veiktspēja

Zemākā atvērtība lielajiem tirgiem

Ziemeļamerika: Ņujorka (2 ms uz ASV austrumiem), Sanfrancisko (2 ms uz ASV rietumiem)
Eiropa: Frankfurte (3ms), Londona (5ms)
Āzija: Singapūra (5 ms), Tokija (8 ms)
Okeānija: Sidneja (tikai iespēja)

Labākais globālajai izplatīšanai

Primārais: Ņujorka vai Sanfrancisko (lielākā lietotāju bāze)
Sekundārā: Londona vai Frankfurte (Eiropas pārklājums)
Terciārs: Singapūra vai Tokija (Asia text)

Pro Padoms: Misijai kritiski svarīgiem lietojumiem izvietojiet vairākās vietās ar automātisku atteici uz maksimālo darbmūžu un ģeogrāfisko atlaišanu.

Datu centru infrastruktūra

Standarta funkcijas (visas atrašanās vietas)

✓ III līmeņa vai augstāki datu centri
✓ 100% uptime SLA
✓ Nominālā jauda (N+1 vai 2N)
✓ Notekūdeņu dzesēšana
✓ 24/7 fiziskā drošība
✓ Biometriskās piekļuves kontroles

✓ DDoS aizsardzība (līdz 10 Tbps mazināšanai)
✓ IPv4 un IPv6 atbalsts
✓ Privātu tīklu veidošana (VLAN)
✓ 10 Gbps+ tīkla pamats
✓ Vairāki augšupējie piegādātāji
✓ BGP līdzāspastāvēšana lielos tīklos

Tīklu nodrošinātāji

Atrašanās vieta	Piegādātājs	Līmeņrādis	Piezīmes
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

Pārvietoties starp vietām

Jūs varat migrēt savu VPS uz citu vietu, izmantojot momentuzņēmumus:

Izveidot jūsu esošo VPS momentuzņēmumu
Izveidot jaunu VPS mērķa vietā
Atjaunot momentuzņēmumu uz jauno VPS
Atjaunināt DNS ierakstus, lai norādītu uz jaunu IP
Kad migrācija ir pārbaudīta, dzēst vecos VPS

Piezīme: Migrējot uz jaunu atrašanās vietu, tiks izveidota jauna IP adrese. DNS pavairošanas laika plāns (parasti 24-48 stundas pilnīgai pavairošanai pasaulē).

Daudzvietīga izvietošana

Lai nodrošinātu augstu pieejamību un globālus rezultātus, jāapsver iespēja tos izmantot vairākās vietās:

Izmantošanas gadījumi

Globāla satura sniegšana
Ģeogrāfiskā slodzes balansēšana
Katastrofu novēršana
Atbilstība datu rezidences tiesību aktiem
Samazināts latentums starptautiskajiem lietotājiem

Īstenošana

Uz DNS balstīta slodzes balansēšana (GeoDNS)
CDN integrācija (Cloudflare, u. c.)
Datubāzes replikācija pa reģioniem
Koplietošanas uzglabāšanas šķīdumi
Neveiksme programmas līmenī

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

VPS.org API