ニフクラAPI (コンピューティング: UpdateLoadBalancer)

UpdateLoadBalancer

処理概要

指定したロードバランサーの定義を変更します。

ポート定義を更新する場合は、ポート番号もあわせて指定します。

ListenerUpdate.Listener.Protocolは、指定したListenerUpdate.Listener.LoadBalancerPortの値によって、設定値と異なる場合があります。

• (※1) Protocol・LoadBalancerPortの関連性は、以下を参考にしてください。

• 変更前のロードバランサーの設定が、Protocol=HTTP,LoadBalancerPort=80,InstancePort=80 となっている場合について記載しております。

  Protocol	LoadBalancerPort	InstancePort		Protocol	LoadBalancerPort	InstancePort
  HTTP	指定なし	指定なし	->	変更なし	変更なし	変更なし
  指定なし	443	指定なし	->	HTTPS	443	変更なし
  指定なし	指定なし	70	->	変更なし	変更なし	70
  HTTP	443	指定なし	->	HTTPS	443	変更なし
  HTTPS	指定なし	443	->	HTTPS	443	443
  指定なし	80	443	->	変更なし	変更なし	443

指定するパラメーター

パラメーター	型	説明	必須
LoadBalancerName	string	変更対象のロードバランサー名	○
ListenerUpdate.LoadBalancerPort	integer	変更対象の待ち受けポート	○ (ポート定義・ロードバランス方式を変更する場合)
ListenerUpdate.InstancePort	integer	変更対象の宛先ポート	○ (ポート定義・ロードバランス方式を変更する場合)
ListenerUpdate.Listener.Protocol	string	プロトコルの更新値 LoadBalancerPortの値によって設定値と異なる場合があります（※1） 値: HTTP HTTPS FTP custom (カスタム) Default: 空 (更新なし)
ListenerUpdate.Listener.LoadBalancerPort	integer	待ち受けポートの更新値 Default: 空 (更新なし)
ListenerUpdate.Listener.InstancePort	integer	宛先ポートの更新値 Default: 空 (更新なし)
ListenerUpdate.Listener.BalancingType	integer	ロードバランス方式の更新値 値: 1 (Round-Robin) 2 (Least-Connection) Default: 空 (更新なし)
NetworkVolumeUpdate	integer	最大ネットワーク流量の更新値 単位: Mbps Default: 空 (更新なし) 使用可能文字: 10, 20, 30, 40, 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000, 1100, 1200, 1300, 1400, 1500, 1600, 1700, 1800, 1900, 2000
AccountingTypeUpdate	integer	利用料金タイプ 値: 1 (月額課金) 2 (従量課金) Default: 空 (更新なし)
LoadBalancerNameUpdate	string	ロードバランサー名の更新値 Default: 空 (更新なし)

応答フィールド

フィールド (項目)	型	説明
UpdateLoadBalancerResponse	-	UpdateLoadBalancer レスポンス
␣ResponseMetadata	-	リクエスト情報
␣␣RequestId	string	リクエスト識別子

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/?
  Action=UpdateLoadBalancer
  &LoadBalancerName=lb0001
  &ListenerUpdate.LoadBalancerPort=80
  &ListenerUpdate.InstancePort=80
  &ListenerUpdate.Listener.BalancingType=2
  &NetworkVolumeUpdate=20
  &AccountingTypeUpdate=1
  &LoadBalancerNameUpdate=lb0002
  &CommonParams

  

応答サンプル

    <UpdateLoadBalancerResponse xmlns="https://computing.api.nifcloud.com/api/">
  <ResponseMetadata>
    <RequestId>f6dd8353-eb6b-6b4fd32e4f05</RequestId>
  </ResponseMetadata>
</UpdateLoadBalancerResponse>