API Lleoliadau

CAEL /api/v1/locations/

Rhestru Pob Lleoliad

Nôl rhestr o'r holl leoliadau canolfannau data sydd ar gael lle gallwch osod gweinyddion VPS.

Paramedrau'r Ymholiad

Paramedrau	Math	Angenrheidiol	Disgrifiad
`region`	string	& # 160; Na	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	& # 160; Na	Show only locations currently accepting new servers

Cais Enghraifft

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

Ymateb Enghraifft

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

Meysydd Ymateb

Maes	Math	Disgrifiad
`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

Codau Statws Ymateb

200	Adalwyd rhestr lleoliadau yn llwyddiannus
401	Heb awdurdod - Tocyn dilysu annilys neu ar goll

Choosing the Right Location

Yn ôl Targed

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

Yn ôl Anghenion Cyflawni

GDPR (Protected Data yr UE): London, Frankfurt
Lleoliad Data UDA: New York, San Francisco
Canada Toronto
Lleoliad Data APAC: Singapore, Tokyo, Sydney

Perfformiad RhwydwaithName

Latency Lowest to Major Markets

Gogledd America New York (2ms i Dde America), San Francisco (2ms i Orllewin America)
Ewrop: Frankfurt (3ms), Llundain (5ms)
Asia: Singapore (5ms), Tokyo (8ms)
Oceania/ Nauru Sydney (dewisiad yn unig)

Gorau ar gyfer Dosbarthiad Eang

Prif: New York neu San Francisco (y sylfaen defnyddwyr fwyaf)
Eilaidd: Llundain neu Frankfurt (cofio Ewrop)
Trydydd: Singapore neu Tokyo (cofio Asia)

Awgrym: Ar gyfer rhaglenni sydd yn hanfodol i'r dasg, gosod i nifer o leoliadau gydag ailosod awtomatig ar gyfer amser gweithredu uchaf a gormod o leoedd.

Cronfa Ddata

Nodweddion Safonol (Pob Lleoliad)

✓ Canolfannau data Lefel III neu uwch
✓ 100% SLA amser gweithredu
✓ Pŵer gormodol (N+1 neu 2N)
✓ Oedi rhewi
✓ Diogelwch corfforol 24/7
✓ Rheoli cyrchu biomecanyddol

✓ Diogelu DDoS (hyd at 10 Tbps o leihau)
✓ Cynhaliaeth IPv4 ac IPv6
✓ Rhwydwaith Preifat (VLAN)
✓ 10 Gbps+ rhwydwaith cefn
✓ Amryw ddarparwyr uwch
✓ Cyd-gyflawni BGP gyda rhwydweithiau mawr

Darparwyr Rhwydwaith

Lleoliad	Darparwr	o Fawrth	Nodiadau
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

Symud rhwng Lleoliadau

Gallwch symud eich VPS i leoliad gwahanol gan ddefnyddio delweddau cyflym:

Creu ciplun o'ch VPS cyfredol
Creu VPS newydd yn y lleoliad cyrchfan
Adfer y llun i'r VPS newydd
Diweddaru cofnodion DNS i bwyntio at IP newydd
Dileu hen VPS ar ôl gwirio'r symudiad

Nodyn: Bydd symud i leoliad newydd yn arwain at gyfeiriad IP newydd. Rhaglenwch amser lledaenu DNS (24-48 awr ar gyfer lledaenu eang llawn fel arfer).

Amryw Lleoliad

Am gael mynediad uchel a chyrraedd yn eang, ystyried gosod mewn nifer o leoliadau:

Casgliadau

Cyflenwi cynnwys eang
Cydbwyso llwyth daearyddol
Adfer o ddigwyddiad
Cyflawni â pholisïau preswylfa data
Goramser llai ar gyfer defnyddwyr rhyngwladol

Gweithredu

Cydbwyso llwyth yn seiliedig ar DNS (GeoDNS)
Cyfuno CDN (Cloudflare, ac ati)
Adfer cronfa ddata
Cynlluniau storio wedi'u rhannu
Difrodi lefel y cymhwysiad

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

VPS.org API