本文へ
ドキュメントAPI リファレンスサーバー詳細を取得
GETBearer トークン

サーバー詳細を取得

/api/v1/servers/:id

ログイン認証情報を除くサーバーの詳細を取得します。instanceId はプロバイダー側の ID であり、API パスに指定するプラットフォーム ID とは異なります。

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

リクエスト例

cURL
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012" \
  -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

現在のプラットフォーム側の詳細取得処理では設定されません。

firewallsnull

ファイアウォールの適用状況は get_server_resources で取得してください。