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. 第三次: シンガポールまたは東京(アジア圏)
プロのヒント: 任務に関するアプリケーションのために,最大の稼働時間と地理的冗長性を確保するために,自動的なフェイルオーバを伴う複数の場所に展開する。

データセンターインフラストラクチャー

標準機能 (すべての場所)

  • ✓ 第三次元以上のデータセンター
  • ✓ 100%アップタイムSLA
  • ✓ 冗長電力(N+1または2N)
  • ✓ 冗長冷却
  • ✓ 24時間体制の物理的な警備
  • ✓ 生体認証アクセス制御
  • ✓ DDoS防御(最大10Tbpsの防御)
  • ✓ IPv4とIPv6のサポート
  • ✓ プライベートネットワーク
  • ✓ 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.