API d'ubicacions

ACONSEGUEIX /api/v1/locations/

Llistar totes les ubicacions

Recupera una llista de totes les ubicacions disponibles del centre de dades a on podeu desplegar els servidors de directors.

Paràmetres de consulta

Paràmetre	Tipus	Obligatori	Descripció
`region`	string	No	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	No	Show only locations currently accepting new servers

Exemple de sol·licitud

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

Exemple de resposta

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

Camps de resposta

Camp	Tipus	Descripció
`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

Codis d'estat de resposta

200	Llista d'ubicacions recuperada correctament
401	No autoritzat: testimoni d'autenticació no vàlid o que falta

Choosing the Right Location

Per objectiu

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

Per Requeriments de composició

PIBR (Protecció de dades de laEU): London, Frankfurt
Consulència de dades dels EUA: New York, San Francisco
Sobiranes de dades canadences: Toronto
Consulència de dades APAC: Singapore, Tokyo, Sydney

Rendiment de la xarxa

La més baixa de les marques de mercat major

Amèrica del Nord: Nova York (ms a l'est dels EUA), San Francisco (2ms a l'oest dels EUA)
Europa: Frankfurt (3ms), Londres (5mms)
Àsia: Singapur (5mm), Tòquio (8mms)
Oceania: Sydney (només opció)

Millor per a la distribució global

Primària: Nova York o San Francisco (base d'usuari més gran)
secundària: Londres o Frankfurt (tra cobertura d'Europa)
Tertiary: Singapur o Tòquio (amb cobertura Asia)

Consell: Per a aplicacions críctiques de missions, es despleguen a múltiples localitzacions amb un fracàs automàtic per a màxima temps i redundància geogràfica.

Estructura d' entrada de dades del centre de dades

Funcionalitats estàndard (totes les localitzacions)

✓ Tier III o d' altres dades superiors
✓ 100% a l' hora SLA
✓ Potència vermella (N+1 o 2N)
✓ Coolant vermellName
✓ A les 24 hores de seguretat física
✓ Controls d' accés Biomètric

✓ Protecció DDoS (per a 10 tbps mitigacions)
✓ Implementació de IPv4 i IPv6
✓ Xarxa privada (VLAN)
✓ 10 Gbps+ xarxa vertebral
✓ Múltiples proveïdors de sortida
✓ EnfocsP i amb xarxes més grans

Proveïdors de xarxaComment

Localització	Proveïdor	TierCity name (optional, probably does not need a translation)	Notes
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

Moure' s entre les localitzacions

Podeu migrar els vostres directors a una ubicació diferent amb instantànies:

Creeu una instantània dels vostres vice-presidents existents
Creeu un nou vicepresident en la ubicació de l'objectiu
Restaura la instantània als nous vice-presidents
Actualitza els registres DNS al punt nou IP
Suprimeix una vegada es verifica la migració dels vice-presidents

Nota: L' enhorabona a una nova localització resultarà en una nova adreça IP. El pla per al temps de propulsió DNS (normalment 2448 hores per a tota la propulsió global).

Dilació multi-Location

Per a l'abast d'alta disponibilitat i global, considereu desplegar- lo en múltiples localitzacions:

Casos d' ús

Entregació global de continguts
Balanç de càrrega geogràfic
Recuperació discradora
Complement amb lleis de residència de dades
He revertit retardenc pels usuaris internacionals

Implementació

Balanç de càrrega basat en DNS (GeoDNS)
Integració amb CDN (Clouudflare, etc.)
Replicació de la base de dades a través de regions
Solucions d' emmagatzematge compartides
Ha fallat el nivell de l' aplicació

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

VPS.org API