2.5.4　システムプロファイルの更新

指定したシステムプロファイルの更新を行います。

権限

Admin, Modify

APIのバージョン

リクエスト形式

PUT http[s]://host:port/Analytics/version/objects/SystemThresholdProfiles/{id}

リクエストボディー

リクエストボディーの構造とオブジェクトの属性を次に示します。

SystemThresholdProfile

{
        "profileName":"...",
        "description":"...",
        "resourceType":"...",
        "profileType":"...",
        "thresholdValues":[{
            "monitoring":"...",
            "metricType":"...",
            "displayName":"...",
            "unit":"...",
            "proportion":"...",
            "thresholdValueOfWarning":"...",
            "thresholdValueOfError":"...",
            "stepSize":"...",
            "max":"...",
            "min":"..."
        },
        :
        ]
}

SystemThresholdProfile (Type: SystemThresholdProfile)

属性	データ型	説明
profileName	string	システムプロファイルの名称。128文字以下の文字列を指定します。
description	string	システムプロファイルの説明。256文字以下の文字列を指定します。
resourceType	string	システムプロファイルが適用できるリソース種別。・ESX:ESXサーバ・HYPERV:Hyper-Vサーバ・IPSWITCH:IPスイッチ・FCSWITCH:FCスイッチ
profileType	string	システムプロファイルの変更種別・User:ユーザーが作成したプロファイル・Default:デフォルトで登録されているプロファイル・Preset:初期値が設定されたプロファイル
thresholdValues	SystemThresholdValue[]	システムプロファイルに設定されているしきい値の内容。

thresholdValues (Type: SystemThresholdValue)

属性	データ型	説明
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	しきい値がとりえる最小値。

レスポンスボディー

レスポンスボディーの構造とオブジェクトの属性を次に示します。

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	更新権限がない
404	Not Found	リソースが存在しない
409	Conflict	nameが一致するリソースが存在する
412	Precondition Failed	サーバーが起動していない
500	Internal Server Error	サーバーサイドエラー

使用例

[Request Header]
PUT /Analytics/v1/objects/SystemThresholdProfiles/64 HTTP/1.1
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: curl/7.33.0
Host: localhost:22015
Accept: application/json
Content-Type: application/json
Accept-Language: ja
Content-Length: 6861


[Request Body]
{
  "instanceID" : 64,
  "profileName" : "Default Profile for Hyper-V",
  "description" : "Default Profile for Hyper-V",
  "resourceType" : "HYPERV",
  "profileType" : "User",
  "thresholdValues" : [ {
    "instanceID" : 807,
    "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
}

[Response Header]
HTTP/1.1 200 OK
Date: Fri, 27 Nov 2015 08:42:46 GMT
Server: Cosminexus HTTP Server
Cache-Control: no-cache
WWW-Authenticate: HSSO ef29b28697744f4dbd5de75038b9fb5aea9f502_WVlGcHsLfg5ffg0I_V0810
X-Frame-Options: SAMEORIGIN
Transfer-Encoding: chunked
Content-Type: application/json


[Response Body]
{
  "instanceID" : 64,
  "profileName" : "Default Profile for Hyper-V",
  "description" : "Default Profile for Hyper-V",
  "resourceType" : "HYPERV",
  "profileType" : "User",
  "thresholdValues" : [ {
    "instanceID" : 807,
    "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
}

2.5.4 システムプロファイルの更新

2.5.4　システムプロファイルの更新