GETBearer トークン

プライベートネットワーク接続を確認

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

所有ネットワークと現在の組織に属する未削除サーバーのローカル地域・供給元情報を比較します。存在しない、または所有していないリソースは 404 を返します。この確認は接続を許可しません。

呼び出す前に

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

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

リクエスト例

cURL

curl "https://tovahub.com/api/v1/networks/507f1f77bcf86cd799439012/attach-check?serverId=507f1f77bcf86cd799439013" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

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

レスポンス例

JSON

{
  "networkId": "507f1f77bcf86cd799439011",
  "serverId": "507f1f77bcf86cd799439013",
  "source": "local",
  "regionMatch": true,
  "providerMatch": true,
  "eligible": false,
  "requiresRestart": "unknown",
  "requiresReinstall": "unknown",
  "ipChange": "unknown",
  "addon": {
    "state": "unknown",
    "checkedAt": null,
    "cancelEffectiveAt": null,
    "verification": "unknown"
  },
  "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."
}

パラメーター

idパス · 必須

string

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

serverIdクエリ · 必須

string

現在の組織のサーバー ID（24 桁の 16 進文字）。削除済みまたは移管済みサーバーにはアクセスできません。

レスポンス

HTTP ステータス 200

networkIdstring

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

serverIdstring

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

source"local"

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

regionMatchboolean

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

providerMatchboolean

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

eligiblefalse

requiresRestart"unknown"

常に unknown。再起動、再インストール、IP 変更の影響は未検証です。

requiresReinstall"unknown"

常に unknown。再起動、再インストール、IP 変更の影響は未検証です。

ipChange"unknown"

常に unknown。再起動、再インストール、IP 変更の影響は未検証です。

addonobject

サーバー所有権確認後のローカル追加サービスのスナップショットです。有効な checkedAt がなければ state は unknown、両時刻は null、verification は unknown。確認済みスナップショットの verification は snapshot。cancel_pending は取消完了や次回請求免除を証明しません。

addon.statestring

addon.checkedAtstring | null

スナップショット確認時刻（ISO 8601）。不明な場合は null。時刻があっても現在の検証ではありません。

addon.cancelEffectiveAtstring | null

addon.verification"unknown" | "snapshot"

testOnlyboolean

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

capabilitiesobject

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

blockedReasonstring

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

プライベートネットワーク接続を確認

リクエスト例

パラメーター#

レスポンス#

関連#

パラメーター

レスポンス

関連