2.3.11 UpdateLServerConfiguration (サーバの性能を変更)

仮想サーバの性能を変更します。

物理サーバに対しては実行できません。

以下のうち、どれか1つは必ず指定が必要です。

cpuPerf
numOfCpu
cpuReserve
cpuShare
memorySize
memoryReserve
memoryShare
serverType
priority

対象のL-Platform内にSolarisコンテナのサーバが存在する、かつ、BladeLogicが存在しない場合、本APIは実行できません。

リクエストパラメーター

パラメーター名	項目	項目説明
Version	説明	L-Platform APIのバージョンID
	型	string ASCII
	設定内容	固定。"2.0"を指定してください。
Locale	説明	L-Platform APIと通信するための言語。ISO 639で規定されている言語コードを指定します。
	型	string ASCII
	設定内容	以下から選択します。・"ja": 日本語・"en": 英語
Action	説明	実行するL-Platform APIの名称
	型	string ASCII
	設定内容	固定。"UpdateLServerConfiguration"を指定してください。
userId	説明	L-Platform APIを実行するユーザーID
	型	string ASCII
	設定内容	31文字以内
orgId	説明	L-Platform APIを実行するユーザーのテナント名
	型	string ASCII
	設定内容	32文字以内
lplatformId	説明	L-Platform ID
	型	string ASCII
	設定内容	32文字以内
lserverId	説明	サーバID
	型	string ASCII
	設定内容	32文字以内
[cpuPerf]	説明	CPU性能。GHz単位で小数点第一位まで指定します。0.1以上、イメージで指定した最大値(指定していない場合は99999.9)までの値を指定してください。
	型	decimal
	設定内容	0.1～99999.9
[numOfCpu]	説明	CPU数
	型	int
	設定内容	1以上。最大値はイメージごとに指定された値(指定していない場合はINTの最大値)です。
[cpuReserve]	説明	CPU予約性能。0.0以上、cpuPerfまたはイメージで指定した最大値(指定していない場合は99999.9)までの値を指定してください。
	型	decimal
	設定内容	0.0～99999.9
[cpuShare]	説明	[VM種別がVMwareの場合] CPU配分比 [VM種別がHyper-Vの場合] CPU割り当て優先度
	型	int
	設定内容	[VM種別がVMwareの場合]1～1000000 [VM種別がHyper-Vの場合]1～10000
[memorySize]	説明	メモリ量。GByte単位で小数点第一位まで指定します。0.1以上、イメージで指定した最大値(指定していない場合は99999.9)までの値を指定してください。
	型	decimal
	設定内容	0.1～99999.9
[memoryReserve]	説明	[VM種別がVMwareの場合] メモリ予約容量。0.0以上、memorySizeまたはイメージで指定した最大値のどちらか小さい方(指定していない場合は99999.9)までの値を指定してください。 [VM種別がHyper-Vの場合] 起動メモリ容量。0.1以上、memorySizeまたはイメージで指定した最大値のどちらか小さい方(指定していない場合は99999.9)までの値を指定してください
	型	decimal
	設定内容	[VM種別がVMwareの場合] 0.0～99999.9 [VM種別がHyper-Vの場合] 0.1～99999.9
[memoryShare]	説明	[VM種別がVMwareの場合] メモリシェア [VM種別がHyper-Vの場合] メモリ割当優先度
	型	int
	設定内容	[VM種別がVMwareの場合]0～1000000 [VM種別がHyper-Vの場合]0～10000
[serverType]	説明	サーバタイプ。指定したサーバタイプのデフォルトの性能値が設定されます。本パラメーターとCPU、メモリ性能を同時に指定した場合、CPU、メモリ性能の値が優先されます。
	型	string ASCII
	設定内容	32文字以内
[priority]	説明	一括電源制御時の起動優先度。この値が小さなサーバから起動されます。0を指定した場合、そのサーバは一括電源操作の対象外となります。
	型	int
	設定内容	0～256

レスポンス

《ステータスコード》

正常に終了した場合に"200 OK"を返します。

《XML》

<?xml version="1.0" encoding="UTF-8"?>
<UpdateLServerConfigurationResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>[メッセージ]</responseMessage>
  <responseStatus>[ステータス]</responseStatus>
</UpdateLServerConfigurationResponse>

《要素》

要素名	項目	項目説明
UpdateLServerConfigurationResponse	説明	レスポンスの情報を持つ要素
	型	なし
	出現回数	1
responseMessage	説明	メッセージ。リクエストが正しく処理されたかどうかを表します。メッセージの詳細については、「メッセージ集」の「第16章 PAPIで始まるメッセージ」を参照してください。
	型	string UTF-8
	出現回数	1
responseStatus	説明	ステータス。リクエストが正常に処理されたかどうかを表します。正常に処理された場合は "SUCCESS" が返却されます。それ以外の場合はエラーコードが返却されます。エラーコードの詳細については、「付録A レスポンスステータス・エラーコード一覧（L-Platform API）」を参照してください。
	型	string ASCII
	出現回数	1

サンプルレスポンス

<?xml version="1.0" encoding="UTF-8"?>
<UpdateLServerConfigurationResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
</UpdateLServerConfigurationResponse>