Description

サーバーのCPU使用時間を取得します。

一秒間に 「1 CPU が占有された時間 × Core 数」を nano second 単位で出力します。

1Core の場合、最大で 1,000,000,000 nsec
2Core の場合、最大で 2,000,000,000 nsec

なお、該当データは収容ホスト側からの概算となり、実際にサーバー内の状況と差異が生じますため、目安としてご利用ください。

Request URL

Compute API

GET /v2.1/servers/{serverid}/rrd/cpu

Request Json

This operation does not accept a request body.

Request Parameters

Parameter Value Style Description
X-Auth-Token トークン header トークンの情報を指定します。
トークンの発行方法は、トークン発行 にてご確認ください。
serverid サーバーID path サーバーIDを指定します。
サーバーIDの確認方法は、サーバー一覧取得 を実行の上、レスポンス結果から対象VPSのサーバーIDをご確認ください。
start_date_raw
(Optional)
データ取得開始時間 query データの取得開始時間を指定します。
デフォルトは、「一日前」になります。なお、
タイムゾーンはUTCです。
end_date_raw
(Optional)
データ取得終了時間 query データの取得終了時間を指定します。
デフォルトは、「現時点まで」になります。なお、
タイムゾーンはUTCです。
mode
(Optional)
average
max
min
query データの統合方法を指定します。
デフォルトは、「average」になります。

Response Code

Success

200

Example

Request

curl -X GET \
-H "Accept: application/json" \
-H "X-Auth-Token: トークン" \
https://compute.c3j1.conoha.io/v2.1/servers/サーバーID/rrd/cpu

Response

{
	"cpu": {
		"schema": [
			"unixtime",
			"value"
		],
		"data": [
			[
				1700833820,
				233285714.29
			],
			[
				1700833890,
				238028571.43
			]
		]
	}
}

ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。