VPS.org API

REST API 문서화

위치 API

Retrieve information about available datacenter locations for VPS deployment.

엔드포인트 1 endpoint
기본 경로 /api/v1/locations
얻다 /api/v1/locations/

모든 위치 목록

VPS 서버를 배포할 수 있는 모든 사용 가능한 데이터 센터 위치 목록을 검색합니다.

쿼리 매개변수

파라미터 유형 필수의 설명
region string 아니요 Filter by region: north-america, europe, asia, oceania
available boolean 아니요 Show only locations currently accepting new servers

예시 요청

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

예시 답변

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

응답 필드

필드 유형 설명
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

응답 상태 코드

200 위치 목록을 성공적으로 가져왔습니다.
401 권한 없음 - 인증 토큰이 유효하지 않거나 누락되었습니다.

Choosing the Right Location

대상 독자별로

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

규정 준수 요구 사항에 따라

네트워크 성능

주요 시장으로의 최저 지연 시간
  • 북아메리카: 뉴욕(미국 동부로 2ms), 샌프란시스코(미국 서부로 2ms)
  • 유럽: 프랑크푸르트 (3ms), 런던 (5ms)
  • 아시아: 싱가포르 (5ms), 도쿄 (8ms)
  • 오세아니아: 시드니 (유일한 옵션)
글로벌 유통에 최적화
  1. 주: 뉴욕 또는 샌프란시스코 (가장 큰 사용자 기반)
  2. 보조: 런던 또는 프랑크푸르트(유럽 커버리지)
  3. 3차: 싱가포르 또는 도쿄(아시아 지역)
팁: 미션 크리티컬 애플리케이션의 경우 자동 장애 조치를 통해 여러 위치에 배포하여 가동 시간과 지리적 중복성을 극대화할 수 있습니다.

데이터 센터 인프라

표준 기능(모든 위치)

  • ✓ Tier III 이상 데이터 센터
  • ✓ 100% 가동 시간 SLA
  • ✓ 중복 전력(N+1 또는 2N)
  • ✓ 중복 냉각
  • ✓ 24/7 물리적 보안
  • ✓ 생체 인식 액세스 제어
  • ✓ DDoS 보호(최대 10 Tbps 완화)
  • ✓ IPv4 및 IPv6 지원
  • ✓ 사설 네트워킹(VLAN)
  • ✓ 10Gbps+ 네트워크 백본
  • ✓ 여러 업스트림 공급자
  • ✓ 주요 네트워크와의 BGP 피어링

네트워크 공급자

위치 공급자 메모
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

위치 간 이동

스냅샷을 사용하여 VPS를 다른 위치로 마이그레이션할 수 있습니다.

  1. 기존 VPS의 스냅샷 생성
  2. 대상 위치에 새 VPS 만들기
  3. 스냅샷을 새 VPS로 복원
  4. 새로운 IP를 가리키도록 DNS 레코드 업데이트
  5. 마이그레이션이 확인되면 이전 VPS를 삭제합니다.
참고: 새로운 위치로 마이그레이션하면 새로운 IP 주소가 생성됩니다. DNS 전파 시간을 계획하십시오(일반적으로 전체 글로벌 전파를 위해 24-48시간).

다중 위치 배포

고가용성과 전 세계 범위를 위해 다음과 같이 여러 위치에 배포하는 것을 고려하십시오.

사용 사례
  • 글로벌 콘텐츠 전송
  • 지리적 부하 분산
  • 재해 복구
  • 데이터 거주 법률 준수
  • 국제 사용자를 위한 지연 시간 감소
구현
  • DNS 기반 부하 분산(GeoDNS)
  • CDN 통합 (Cloudflare 등)
  • 지역 간 데이터베이스 복제
  • 공유 스토리지 솔루션
  • 애플리케이션 레벨 장애 조치
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.