サーバー詳細を取得
/api/v1/servers/:id
ログイン認証情報を除くサーバーの詳細を取得します。instanceId はプロバイダー側の ID であり、API パスに指定するプラットフォーム ID とは異なります。
API のフィールド名、型、コードはすべての言語で共通です。
リクエスト例
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 で取得してください。