API vị trí

LẤY /api/v1/locations/

Liệt kê tất cả các địa điểm

Lấy danh sách tất cả các vị trí trung tâm dữ liệu sẵn có nơi bạn có thể triển khai máy chủ VPS.

Tham số truy vấn

Tham số	Kiểu	Yêu cầu	Mô tả
`region`	string	Không	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Không	Show only locations currently accepting new servers

Ví dụ về yêu cầu

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

Ví dụ về câu trả lời

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

Các trường phản hồi

Địa điểm	Kiểu	Mô tả
`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

Mã trạng thái phản hồi

200	Đã truy xuất thành công danh sách địa điểm
401	Không được phép - Mã xác thực không hợp lệ hoặc bị thiếu.

Choosing the Right Location

Theo đối tượng mục tiêu

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

Theo yêu cầu tuân thủ

Bảo vệ dữ liệu London, Frankfurt
Dữ liệu Mỹ: New York, San Francisco
Dữ liệu liên quan tới Canadinae tại Wikispecies Toronto
Dữ liệu APAC: Singapore, Tokyo, Sydney

Hiệu suất mạngName

Tốc độ chậm nhất đến các thị trường chính

Bắc Mỹ: New York (2ms về phía đông Mỹ), San Francisco (2ms về phía tây Mỹ)
Châu Âu: Frankfurt (3ms), London (5ms)
Châu Á: Singapore (5ms), Tokyo (8ms)
Châu Đại Dương: Sydney (chỉ có tùy chọn)

Tốt nhất cho phân phối toàn cầu

Thủy: New York hoặc San Francisco (cơ sở người dùng lớn nhất)
Thứ hai: London hay Frankfurt (phát sóng châu Âu)
Thứ ba: Singapore hay Tokyo (phát sóng châu Á)

Gợi ý: Đối với các ứng dụng quan trọng, triển khai đến nhiều địa điểm với tự động failover cho thời gian hoạt động tối đa và dư địa lý.

Hệ thống dữ liệu

Tính năng chuẩn (tất cả vị trí)

✓ Trung tâm dữ liệu cấp III hoặc cao hơn
✓ SLA 100% thời gian hoạt động
✓ Điện năng dư thừa (N+1 hoặc 2N)
✓ Điều hòa dư thừa
✓ An ninh 24/7.
✓ Kiểm soát truy cập bằng sinh trắc học

✓ Bảo vệ DDoS (tăng lên 10 Tbps giảm thiểu)
✓ Hỗ trợ IPv4 và IPv6
✓ Mạng riêng (VLAN)
✓ 10 Gbps+ mạng trụ
✓ Nhiều nhà cung cấp
✓ BGP peering với các mạng chính

Nhà cung cấp mạng

Vị trí	Nhà cung cấp	Thú	Ghi chú
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

Di chuyển giữa các vị trí

Bạn có thể di chuyển VPS của mình đến một vị trí khác bằng cách sử dụng ảnh chụp:

Tạo một bức ảnh chụp của VPS hiện tại
Tạo một VPS mới ở vị trí mục tiêu
Phục hồi ảnh chụp lên máy chủ VPS mới
Cập nhật ghi chú DNS để chỉ IP mới
Xoá VPS cũ khi xác nhận di chuyển

Ghi chú: Di chuyển đến một vị trí mới sẽ tạo ra một địa chỉ IP mới. Kế hoạch thời gian lan truyền DNS (thường là 24- 48 giờ cho sự lan truyền toàn cầu).

Phát triển đa vị trí

Để có thể sử dụng cao và tầm ảnh hưởng toàn cầu, hãy xem xét triển khai ở nhiều vị trí:

Tình huống sử dụng

Giao tiếp nội dung toàn cầu
Cân bằng tải địa lý
Phục hồi sau thảm họa
Tuân thủ luật định cư dữ liệu
Giảm thời gian đợi cho người dùng quốc tế

Thực hiện

Cân bằng tải dựa trên DNS (GeoDNS)
Tổng hợp CDN (Cloudflare, vv.)
Bản sao cơ sở dữ liệu trên các khu vực
Các giải pháp lưu trữ chia sẻ
Tắt ngắt cấp ứng dụng

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

VPS.org API