GETBearer トークン

新規サーバーのプライベートネットワークを確認

/api/v1/networks/:id/order-check

組織のネットワークとローカルの Contabo プランを比較し、有効なローカル枠を数えます。ネットワークまたはプランがない場合は404を返します。見積もり、予約、互換性の保証ではありません。

呼び出す前に

ローカルデータの読み取り専用です。供給元への要求、課金、書き込みは行いません。すべての capabilities は false です。地域や供給元の一致は互換性や安全な接続を保証しません。

API のフィールド名、型、コードはすべての言語で共通です。

リクエスト例

cURL

curl "https://tovahub.com/api/v1/networks/507f1f77bcf86cd799439012/order-check?planId=V153&region=EU" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

表示のみ。このページから API リクエストは送信されません。

レスポンス例

JSON

{
  "networkId": "507f1f77bcf86cd799439011",
  "source": "local",
  "regionMatch": true,
  "providerMatch": true,
  "eligible": false,
  "testOnly": true,
  "capabilities": {
    "purchase": false,
    "attach": false,
    "disconnect": false,
    "remove": false,
    "reconnect": false,
    "cancelAddon": false,
    "renew": false,
    "resize": false,
    "delete": false,
    "blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment."
  },
  "blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment.",
  "planId": "V153",
  "region": "EU",
  "networkState": "ready",
  "verification": "unknown",
  "capacity": {
    "total": 5,
    "localOccupied": 2,
    "localRemaining": 3,
    "networkVersion": 1,
    "verification": "snapshot"
  },
  "compatibility": "unknown",
  "supplierCost": "unknown",
  "reserved": false
}

パラメーター

idパス · 必須

string

リソース ID。24 桁の16進数文字列です。対応する一覧エンドポイントが返すプラットフォーム ID を使用し、プロバイダーのインスタンス ID は使用しないでください。

planIdクエリ · 必須

string

ローカルの Contabo プラン ID：英字、数字、アンダースコア、ハイフンの1–100文字。プロバイダーのカタログには問い合わせません。

regionクエリ · 必須

string

ローカルプランの地域：英字、数字、アンダースコア、ハイフンの2–40文字。プロバイダー、プラン、地域の完全一致する組み合わせがローカルに必要です。

レスポンス

HTTP ステータス 200

networkIdstring

供給元ではなくプラットフォームの識別子です。

planIdstring

ローカルの Contabo プラン ID：英字、数字、アンダースコア、ハイフンの1–100文字。プロバイダーのカタログには問い合わせません。

regionstring

source"local"

常に local。供給元へのリアルタイム要求は行いません。

regionMatchboolean

ローカル比較のみです。true は互換性や安全な接続を保証しません。

providerMatchboolean

ローカル比較のみです。true は互換性や安全な接続を保証しません。

networkStatestring

保存されたローカルスナップショット値であり、検証済みの供給元の現在状態ではありません。

verification"unknown"

常に unknown。製品とデータセンターの互換性、プロバイダー容量、追加サービスの要否と費用は未確認です。

capacityobject

ローカル容量のみ：total は既知のカタログサイズまたは null です。件数には切断済みを含む、すべての有効な reserved、assigned、releasing 枠が含まれます。データ破損、容量超過、ネットワークのバージョン変更時は両件数が null になります。スナップショットは枠を予約せず、プロバイダー容量も証明しません。

capacity.totalinteger | null

capacity.localOccupiedinteger | null

capacity.localRemaininginteger | null

capacity.networkVersioninteger | null

capacity.verification"snapshot" | "unknown"

compatibility"unknown"

常に unknown。製品とデータセンターの互換性、プロバイダー容量、追加サービスの要否と費用は未確認です。

supplierCost"unknown"

常に unknown。製品とデータセンターの互換性、プロバイダー容量、追加サービスの要否と費用は未確認です。

eligiblefalse

reservedfalse

testOnlyboolean

true はテストの文脈のみを示し、購入済みの実サーバーも含み得ます。シミュレーションの証明でも、課金や安全確認の回避でもありません。

capabilitiesobject

purchase、attach、disconnect、remove、reconnect、cancelAddon、renew、resize、delete の9項目はすべて false です。供給元の機能は未検証で、検証前は課金しません。スナップショットは互換性や安全な接続を証明しません。

blockedReasonstring

リクエストとエラー認証 MCP · check_network_order

新規サーバーのプライベートネットワークを確認

リクエスト例

パラメーター#

レスポンス#

関連#

パラメーター

レスポンス

関連