プライベートネットワーク一覧を取得
/api/v1/networks
現在の組織が所有するローカルネットワークのスナップショットを ID 順で最大 100 件取得します。空のページは供給元での不在を証明しません。
呼び出す前に
ローカルデータの読み取り専用です。供給元への要求、課金、書き込みは行いません。すべての capabilities は false です。地域や供給元の一致は互換性や安全な接続を保証しません。
API のフィールド名、型、コードはすべての言語で共通です。
リクエスト例
curl "https://tovahub.com/api/v1/networks" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"表示のみ。このページから API リクエストは送信されません。
レスポンス例
{
"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[].testOnlybooleantrue はテストの文脈のみを示し、購入済みの実サーバーも含み得ます。シミュレーションの証明でも、課金や安全確認の回避でもありません。
networks[].source"local"常に local。供給元へのリアルタイム要求は行いません。
networks[].verification"unknown" | "snapshot"checkedAt がある場合は snapshot、それ以外は unknown。いずれも現在の供給元状態を検証しません。
networks[].capabilitiesobjectpurchase、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。空のローカル結果は供給元での不在を証明しません。
capabilitiesobjectpurchase、attach、disconnect、remove、reconnect、cancelAddon、renew、resize、delete の9項目はすべて false です。供給元の機能は未検証で、検証前は課金しません。スナップショットは互換性や安全な接続を証明しません。