2.5.1 システムプロファイルの一覧の取得
システムプロファイルの一覧を取得します。
権限
Admin, Modify
APIのバージョン
v1
リクエスト形式
GET http[s]://host:port/Analytics/version/objects/SystemThresholdProfiles
リクエストボディー
リクエストボディーには何も設定しません。
レスポンスボディー
レスポンスボディーの構造とオブジェクトの属性を次に示します。Collections
{ "data":["...", ...], "pagination":{ "page":"...", "pageSize":"...", "numPages":"...", "totalCount":"..." }, "count":"..." }
Collections (Type: Collections)
属性 |
データ型 |
説明 |
---|---|---|
data |
anyType[] |
SystemThresholdProfile のコレクション。 SystemThresholdProfile の詳細は以下の表を参照ください。 |
pagination |
Pagination |
ページ情報。リソースが存在しない場合、このパラメータは表示されません。 |
count |
int |
条件に合致したデータの個数 |
pagination (Type: Pagination)
属性 |
データ型 |
説明 |
---|---|---|
page |
integer |
ページ |
pageSize |
integer |
ページサイズ |
numPages |
integer |
ページの数 |
totalCount |
integer |
オブジェクトの数 |
SystemThresholdProfile
{ "instanceID":"...", "profileName":"...", "description":"...", "resourceType":"...", "profileType":"...", "thresholdValues":[{ "instanceID":"...", "monitoring":"...", "metricType":"...", "displayName":"...", "unit":"...", "proportion":"...", "thresholdValueOfWarning":"...", "thresholdValueOfError":"...", "stepSize":"...", "max":"...", "min":"..." }, : ], "numOfResources":"..." }
SystemThresholdProfile (Type: SystemThresholdProfile)
属性 |
データ型 |
説明 |
---|---|---|
instanceID |
long |
インスタンスを特定するID |
profileName |
string |
システムプロファイルの名称。128文字以下の文字列を指定します。 |
description |
string |
システムプロファイルの説明。256文字以下の文字列を指定します。 |
resourceType |
string |
システムプロファイルが適用できるリソース種別。 ・ESX:ESXサーバ ・HYPERV:Hyper-Vサーバ ・IPSWITCH:IPスイッチ ・FCSWITCH:FCスイッチ |
profileType |
string |
システムプロファイルの変更種別 ・User:ユーザーが作成したプロファイル ・Default:デフォルトで登録されているプロファイル ・Preset:初期値が設定されたプロファイル |
thresholdValues |
SystemThresholdValue[] |
システムプロファイルに設定されているしきい値の内容。 |
numOfResources |
int |
システムプロファイルが割り当たっているリソースの数 |
thresholdValues (Type: SystemThresholdValue)
属性 |
データ型 |
説明 |
---|---|---|
instanceID |
long |
インスタンスを特定するID |
monitoring |
boolean |
監視しているしきい値かどうか。 ・true:監視している。 ・false:監視していない。 省略時はfalseが設定されます。 |
metricType |
string |
しきい値の識別子。未サポートのメンバーです。 |
displayName |
string |
しきい値の表示名。 |
unit |
string |
しきい値の単位を表す文字列。 |
proportion |
boolean |
しきい値の方向。 ・true:測定値がしきい値を下回る場合に異常または警告となる。 ・false:測定値がしきい値を上回る場合に異常または警告になる。 |
thresholdValueOfWarning |
float |
警告を表すしきい値。しきい値は以下の条件に合わせて指定する必要があります。 ・stepSizeの倍数 ・max以下 ・min以上 |
thresholdValueOfError |
float |
エラーを表すしきい値。しきい値は以下の条件に合わせて指定する必要があります。 ・stepSizeの倍数 ・max以下 ・min以上 |
stepSize |
float |
しきい値の増加量。 |
max |
double |
しきい値がとりえる最大値。 |
min |
double |
しきい値がとりえる最小値。 |
ステータスコード
HTTPステータスコード |
Reason phrase |
説明 |
---|---|---|
200 |
OK |
正常終了 |
400 |
Bad Request |
クエリパラメータ不正 |
401 |
Unauthorized |
ログイン権限がない |
403 |
Forbidden |
参照権限がない |
412 |
Precondition Failed |
サーバーが起動していない |
500 |
Internal Server Error |
サーバーサイドエラー |
使用例
[Request Header] GET /Analytics/v1/objects/SystemThresholdProfiles HTTP/1.1 Authorization: Basic c3lzdGVtOm1hbmFnZXI= User-Agent: curl/7.33.0 Host: localhost:22015 Accept: application/json Accept-Language: ja [Response Header] HTTP/1.1 200 OK Date: Fri, 27 Nov 2015 05:21:49 GMT Server: Cosminexus HTTP Server Cache-Control: no-cache WWW-Authenticate: HSSO d4ca28827d6fe35b964eeece674e3fbda29b5a11_WVlGcHsLfg5ffg0I_V0810 X-Frame-Options: SAMEORIGIN Transfer-Encoding: chunked Content-Type: application/json [Response Body] { "data" : [ { "instanceID" : 23, "profileName" : "Default Profile for Hyper-V", "description" : "Default Profile for Hyper-V", "resourceType" : "HYPERV", "profileType" : "Default", "thresholdValues" : [ { "instanceID" : 539, "monitoring" : true, "metricType" : "WIN_CPU_LOAD", "displayName" : "CPU Use", "unit" : "%", "proportion" : false, "thresholdValueOfWarning" : 80.0, "thresholdValueOfError" : 90.0, "stepSize" : 1.0, "max" : 100.0, "min" : 0.0 }, { .......... }, .......... ], "numOfResources" : 0 } "count" : 8 }