ovahubサーバーリソースを取得
/api/v1/servers/:id/resources
サーバーの詳細と適用中のファイアウォールを取得します。firewallState はプレビュー、未同期、準備完了を区別します。firewalls が null でも、適用なしと確認されたわけではありません。
API のフィールド名、型、コードはすべての言語で共通です。
リクエスト例
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/resources" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"表示のみ。このページから API リクエストは送信されません。
パラメーター
idパス · 必須string
リソース ID。24 桁の16進数文字列です。対応する一覧エンドポイントが返すプラットフォーム ID を使用し、プロバイダーのインスタンス ID は使用しないでください。
レスポンス
HTTP ステータス 200
プラットフォームに保存されたサーバーの詳細と、現在保存されているファイアウォール適用状態を取得します。
testOnlybooleanこのサーバーが隔離されたテスト用リソースかどうか。
testUntilstring (ISO 8601) | null存在する場合、テスト用リソースの有効期限。
supplierPaidThroughstring (ISO 8601) | nullサーバーに保存された expiresAt の値。従来のフィールド名で返されます。
instanceIdstringプロバイダーのインスタンス識別子。プラットフォームのサーバー ObjectId ではありません。
namestring保存されたホスト名、または空文字列。
statusstring保存されたサーバーの状態。
previewbooleanサーバーが読み取り専用のプレビューかどうか。
regionstringリージョンの表示名。ない場合はコードを使用します。
dataCenterstring現在は長いダッシュのプレースホルダーです。
productstring保存された製品名。ない場合は長いダッシュを表示します。
cpunumber保存された CPU 数、または 0。
memoryMbnumber保存されたメモリ容量（MB）、または 0。
diskMbnumber保存されたディスク容量（MB）、または 0。
operatingSystemstring保存された OS 名または識別子。ない場合は長いダッシュを表示します。
imageIdnull現在のプラットフォーム側の詳細取得処理では設定されません。
ipv4string | null存在する場合、保存された IPv4 アドレス。
ipv6string | null存在する場合、保存された IPv6 アドレス。
macAddressstring保存された MAC アドレス、または空文字列。
createdAtstring (ISO 8601) | null存在する場合、保存された購入作成日時。
additionalIpsnull現在のプラットフォーム側の詳細取得処理では設定されません。
privateNetworksnull現在のプラットフォーム側の詳細取得処理では設定されません。
firewallStatestring ('preview' | 'unsynced' | 'ready')このサーバーのファイアウォールデータが利用可能かどうか。
firewallsarray | nullpreview または unsynced 状態では null。それ以外では対応する適用情報です。
firewalls[].idstringプロバイダーのファイアウォール識別子。プラットフォーム側の識別子とは限りません。
firewalls[].namestringファイアウォールの表示名。
firewalls[].statusstringプロバイダー側のファイアウォール状態。
firewalls[].attachedInstanceCountnumber表示可能な、適用先の組織サーバー数。
firewalls[].rulesarraydisplayName、protocol、destPorts、ipv4、ipv6、action、status を含むルール。