API Tauwāhi

TIKINA /api/v1/locations/

Rārangihia ngā Wāhi Katoa

Ka whiwhi rātau i tētahi rārangi o ngā tauwāhi pūtahi raraunga e wātea ana e taea ai e koe te whakawaenga i ngā pūnaha VPS.

Ngā Tawhā Uiui

Parameter	Momo	E hiahiatia ana	Whakamāramatanga
`region`	string	Kāore	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Kāore	Show only locations currently accepting new servers

Tauira Tono

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

Tauira Whakautu

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

Ngā Āpure Whakautu

Taiwhanga	Momo	Whakamāramatanga
`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

Ngā Waehere Tūnga Urupare

200	Kua whiwhi angitu i te rārangi wāhi
401	Kāore i Whakamanahia - Tohu manatoko kore mana, ngaro rānei

Choosing the Right Location

E te hunga whainga

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

Mā ngā Rerekētanga Whakarite

GDPR (EU Pāroitanga raraunga): London, Frankfurt
Ko te kāinga o te raraunga o US: New York, San Francisco
Ko te mana raraunga a Kānata: Toronto
Ko te APAC Data Residence: Singapore, Tokyo, Sydney

Whakaputanga Rāwhitiwhiti

Ko te tūpāpaku iti rawa ki ngā mākete matua

Amerika ki te Raki: New York (2ms ki te Rāwhiti US), San Francisco (2ms ki te Uru US)
Europe: Frankfurt (3ms), London (5ms)
Āhia: Singapore (5ms), Tokyo (8ms)
Oceania: Sydney (whakahaere noa iho)

Ko te pai rawa mo te tuaritanga o te ao whānui

Tuatahi: New York, San Francisco rānei (te pūtake kaimahi nui rawa)
Tuatahi: London, Frankfurt rānei (te whakawhāititanga o Ūropi)
Tuatoru: Singapore, Tokyo rānei (Āhia te taupoki)

Whakapānga: Mō ngā taupānga hira-mihini, ka whakawāteatia ki ngā tauwāhi maha me te whakawāteatanga ā-waha mō te wā whakawātea me te āhua o te papawhenua.

Kaupapatanga Datacenter

Āhuahira paerewa (Ko ngā tauwāhi katoa)

✓ Tier III, ki ngā pūtahi raraunga teitei ake rānei
✓ 100% SLA wā whakarewa
✓ Ka taea te whakapūtā (N+1, 2N rānei)
✓ He mārō te whakamāmā
✓ 24/7 te haumarutanga ōkiko
✓ Biometric access controls

✓ Ka parea te DDoS (ki te 10 Tbps whakaiti)
✓ Whakatauanga IPv4 me IPv6
✓ Rāwhiti ā-whāiti (VLAN)
✓ 10 Gbps+ tīkau tīpako
✓ He maha nga kaiwhiwhi pūtake
✓ BGP peering me ngā whatunga matua

Ka taea te whakawātea i te rārangi

Taone	Kaihoahoa	Karaka	Whakawa
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

Ka neke atu i waenganui i ngā tauwāhi

Ka taea e koe te neke atu i tōtou VPS ki tētahi atu tauwāhi mā te whakamahi i ngā tātuhi:

Ka waihanga tētahi whakaahua o tōna VPS tīariari
Ka waihanga tētahi VPS hou i te tauwāhi ūnga
Whakahōu te whakaahua i te VPS hou
Whakahou i ngā pūkete DNS hei tohu ki te IP hou
Ka tangohia te VPS tahito ina whakamātauria te hekenga

Whakapapa: Ka puta te neke ki tētahi tauwāhi hōu ki tētahi tuakiri IP hōu. Ka whakaritea he wā whakawhānuitanga DNS (i te nuinga o te wā 24–48 ngā wā mō te whakawhānuitanga katoa o te ao whānui).

Whakapapa-maha-wāhi

Mō te wāteatanga tiketike me te āheitanga o te ao whānui, whakaaro ki te whakawhānui i ngā tauwāhi maha:

Ka whakamahia ngā take

Ka tukuna ngā ihirangi katoa
Te tauritetanga o te tauwāhi ā-wāhi
Ka whakaorangia te mate
E whakaae ana ki ngā ture noho raraunga
Kua whakaitihia te ātetetanga mō ngā kaiwhakaari aowhānui

Whakatinana

DNS-āhua i te taurite taumaha (GeoDNS)
Ko te whakaurutanga CDN (Cloudflare, ērā atu mea)
Ko te tāruatanga o te pūtake i roto i ngā rohe
He rongoā tatauranga tiritiri
Whakarewa-waeine taupānga

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

VPS.org API