本文へ
ドキュメントAPI リファレンスプライベートネットワーク一覧を取得
GETBearer トークン

プライベートネットワーク一覧を取得

/api/v1/networks

現在の組織が所有するローカルネットワークのスナップショットを ID 順で最大 100 件取得します。空のページは供給元での不在を証明しません。

呼び出す前に

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

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

リクエスト例

cURL
curl "https://tovahub.com/api/v1/networks" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

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

レスポンス例
JSON
{
  "networks": [],
  "nextCursor": null,
  "source": "local",
  "verification": "unknown",
  "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."
  }
}

パラメーター

afterクエリ · 任意

string

任意の 24 桁の 16 進カーソルです。一覧の nextCursor または詳細の portsNextCursor を使用します。カーソルより大きい ID を最大 100 件返し、null は次ページがないことを示します。

レスポンス

HTTP ステータス 200

現在の組織が所有するローカルネットワークのスナップショットを ID 順で最大 100 件取得します。空のページは供給元での不在を証明しません。

networksobject[]

現在の組織が所有するローカルネットワークのスナップショットを ID 順で最大 100 件取得します。空のページは供給元での不在を証明しません。

networks[].idstring

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

networks[].providerstring

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

networks[].namestring

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

networks[].regionstring

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

networks[].dataCenterstring | null

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

networks[].cidrstring | null

記録済みのプライベートネットワークCIDR。未観測の場合はnullです。

networks[].boundServersinteger | null

現在の組織が所有する物理サーバーへの有効な接続数。不整合の場合はnullです。

networks[].occupiedPortsinteger | null

予約中と取り外し中を含むローカルの有効な占有数。不整合の場合はnullです。

networks[].capacityinteger

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

networks[].statestring

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

networks[].versioninteger

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

networks[].monthlyPricestring

米ドルではなくセント単位の整数文字列。表示価格は支払いを有効にしません。

networks[].serviceFromstring (ISO 8601) | null

購入完了の確認後にサービスを開始します。不明な場合は null です。

networks[].serviceUntilstring (ISO 8601) | null

プラットフォーム上の支払い済みサービス期限。供給元の支払い済み期限とは独立し、不明なら null です。

networks[].autoRenewboolean

更新の希望のみを示し、支払いや期間延長の完了を証明しません。

networks[].accessStatestring

保存されたローカルのネットワーク接続状態:active、stopping、stopped、restoring、unknown。提供元の現在の接続を検証した結果ではありません。

networks[].currency"USD"

固定通貨 USD、価格単位 cent、請求期間がある場合は month です。

networks[].priceUnit"cent"

固定通貨 USD、価格単位 cent、請求期間がある場合は month です。

networks[].checkedAtstring | null

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

networks[].testOnlyboolean

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

networks[].source"local"

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

networks[].verification"unknown" | "snapshot"

checkedAt がある場合は snapshot、それ以外は unknown。いずれも現在の供給元状態を検証しません。

networks[].capabilitiesobject

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

nextCursorstring | null

任意の 24 桁の 16 進カーソルです。一覧の nextCursor または詳細の portsNextCursor を使用します。カーソルより大きい ID を最大 100 件返し、null は次ページがないことを示します。

source"local"

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

verification"unknown"

常に unknown。空のローカル結果は供給元での不在を証明しません。

capabilitiesobject

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