本文へジャンプします。

ニフクラ ユーザーガイド

本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/cp/api/UpdateLoadBalancer.htmへ移行しました。 今後は新ページをご参照ください。

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>

  

ニフクラ サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

推奨画面サイズ 1024×768 以上