本文へジャンプします。

ニフクラ ユーザーガイド

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
値: 10 | 20 | 30 | 40 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | 1000 | 1100 | 1200 | 1300 | 1400 | 1500 | 1600 | 1700 | 1800 | 1900 | 2000
Default: 空 (更新なし)
AccountingTypeUpdate integer 利用料金タイプ
値: 1 (月額課金) | 2 (従量課金)
Default: 空 (更新なし)
LoadBalancerNameUpdate string ロードバランサー名の更新値
Default: 空 (更新なし)

応答フィールド

フィールド (項目) 説明
UpdateLoadBalancerResponse UpdateLoadBalancerResponse UpdateLoadBalancer レスポンス
Ancestor: なし
Children: ResponseMetadata
ResponseMetadata ResponseMetadata リクエスト情報
Ancestor: UpdateLoadBalancerResponse
Children: RequestId
RequestId string リクエスト識別子
Ancestor: ResponseMetadata
Children: なし

リクエストサンプル

    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メニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ

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