Kokapenen APIa

LORTU /api/v1/locations/

Kokapen guztiak zerrendatu

VPS zerbitzariak hedatu ditzakezun datu-zentro erabilgarrien kokaleku guztien zerrenda eskuratu.

Kontsulta-parametroak

Parametroak	Mota	Beharrezkoa	Azalpena
`region`	string	Ez	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Ez	Show only locations currently accepting new servers

Eskaera adibidea

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

Adibide Erantzuna

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

Erantzun Eremuak

Eremua	Mota	Azalpena
`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

Erantzun Egoera Kodeak

200	Kokapenen zerrenda behar bezala berreskuratu da
401	Baimenik gabea - Autentifikazio-token baliogabea edo falta da

Choosing the Right Location

Helburuko publikoaren arabera

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

Konformitate-baldintzen arabera

GDPR (EBko datuen babesa): London, Frankfurt
AEBetako datuen egoitza: New York, San Francisco
Kanadako datuen soberania: Toronto
APAC datuen egoitza: Singapore, Tokyo, Sydney

Sarearen errendimendua

Merkatu nagusietara ateratzeko latentziarik txikiena

Ipar Amerika: New York (2ms AEB ekialdera), San Frantzisko (2ms AEB mendebaldera)
Europa: Frankfurt (3ms), Londres (5ms)
Asia: Singapur (5ms), Tokio (8ms)
Ozeania: Sydney (aukera bakarra)

Banaketa globalerako onena

Lehen mailakoa: New York edo San Francisco (erabiltzaile-base handiena)
Bigarren mailakoa: Londres edo Frankfurt (Europa estaltzen du)
Hirugarren mailakoa: Singapur edo Tokio (Asiako estaldura)

Pro aholkua: Misio-kritikoa den aplikazioetarako, kokaleku anitzetan hedatu, eta automatikoki egin atzera, funtzionamendu-denbora maximoa eta erredondantzia geografikoa lortzeko.

Datu-zentroaren azpiegitura

Ezarpen estandarrak (kokaleku guztiak)

✓ III. maila edo goragoko datu-zentroak
✓ % 100eko SLA
✓ Potentzia erredondantea (N+1 edo 2N)
✓ Hozte erredundantea
✓ 24/7 segurtasun fisikoa
✓ Sarbide-kontrol biometrikoak

✓ DDoS babesa (10 Tbps-eko murrizketa arte)
✓ IPv4 eta IPv6 euskarria
✓ Sare pribatua (VLAN)
✓ 10 Gbps+ sare-zorroa
✓ Goi-hornitzaile anitzak
✓ BGP parekatzea sare nagusiekin

Sare hornitzaileak

Kokalekua	Hornitzailea	Tier	Oharra
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

Kokalekuen artean mugitzea

Zure VPS beste kokaleku batera migra dezakezu, snapshotak erabiliz:

Sortu lehendik dagoen VPSaren argazki bat
Sortu VPS berria helburuko kokalekuan
Leheneratu argazkia VPS berrian
Eguneratu DNS erregistroak IP berria adierazteko
Ezabatu VPS zaharra migrazioa egiaztatu ondoren

Oharra: Kokaleku berri batera migratzeak IP helbidea berri bat emango du. Planifikatu DNS hedapenaren denbora (normalean 24-48 ordu hedapen global osoa lortzeko).

Kokaleku anitzeko hedapena

Erabilgarritasun handia eta irismena globala izateko, pentsatu kokaleku anitzetan hedatzea:

Erabilera-kasuak

Edukiaren banaketa globala
Karga-balantze geografikoa
Hondamendiaren berreskurapena
Datuen bizileku legeak betetzea
Atzerapen txikiagoa nazioarteko erabiltzaileentzat

Inplementazioa

DNSn oinarritutako karga-balantzea (GeoDNS)
CDN integrazioa (Cloudflare, etab.)
Datu-basearen erreplikazioa eskualdeen artean
Biltegi partekatuaren soluzioak
Aplikazio-mailako hutsegitea

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

VPS.org API