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
}