本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>API> コンピューティング> NiftyDescribeElasticLoadBalancers
本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/cp/api/NiftyDescribeElasticLoadBalancers.htmへ移行しました。 今後は新ページをご参照ください。

NiftyDescribeElasticLoadBalancers

処理概要

指定したマルチロードバランサーの情報を取得します。
マルチロードバランサーを指定するためには、マルチロードバランサー名または、マルチロードバランサーユニークID・プロトコル・待ち受けポート番号・宛先ポート番号が必要です。マルチロードバランサーを指定しない場合は、取得可能なすべてのマルチロードバランサー情報を取得します。

指定するパラメーター

パラメーター 説明 必須
ElasticLoadBalancers.ElasticLoadBalancerId.n string 対象のマルチロードバランサーユニークID
ElasticLoadBalancers.ElasticLoadBalancerName.n string 対象のマルチロードバランサー名
使用可能文字: 半角英数字(15文字)
ElasticLoadBalancers.Protocol.n string プロトコル
値:
  • TCP
  • UDP
  • HTTP
  • HTTPS
ElasticLoadBalancers.ElasticLoadBalancerPort.n integer 待ち受けポート
使用可能文字: 1〜65535の数値
ElasticLoadBalancers.InstancePort.n integer 宛先ポート
使用可能文字: 1〜65535の数値
Filter.n.Name string 絞り込み条件の項目名
値:
  • availability-zone (ゾーン)
  • state (マルチロードバランサーステータス)
  • elastic-loadbalancer-id (マルチロードバランサーユニークID)
  • elastic-loadbalancer-name (マルチロードバランサー名)
  • description (マルチロードバランサーメモ)
  • accounting-type (マルチロードバランサー利用料金タイプ)
  • ip-address (マルチロードバランサーのIP アドレス)
  • version (マルチロードバランサーのversion 情報)
Default: なし
Filter.n.Value.m string 絞り込み条件の値
Default: なし

応答フィールド

フィールド (項目) 説明
NiftyDescribeElasticLoadBalancersResponse - NiftyDescribeElasticLoadBalancersレスポンス
NiftyDescribeElasticLoadBalancersResult - マルチロードバランサーの情報セット
ElasticLoadBalancerDescriptions - マルチロードバランサーの情報
member - マルチロードバランサーの情報
ElasticLoadBalancerId string マルチロードバランサーユニークID
ElasticLoadBalancerName string マルチロードバランサー名
DNSName string VIPネットワーク IPアドレス
NetworkVolume string 最大ネットワーク流量
備考: 返却値 10,20,30,40,100,200,300,400,500
State string マルチロードバランサーのステータス
値:
  • pending (作成中・処理中・削除中)
  • available ( pending 以外 )
AccountingType string 当月の利用料金タイプ
値:
  • 1 (月額課金)
  • 2 (従量課金)
NextMonthAccountingType string 次月からの利用料金タイプ
値:
  • 1 (月額課金)
  • 2 (従量課金)
ElasticLoadBalancerListenerDescriptions - マルチロードバランサーのポート設定情報
member - マルチロードバランサーのポート設定情報
Listener - マルチロードバランサーのポート設定情報
Protocol string プロトコル
値:
  • TCP
  • UDP
  • HTTP
  • HTTPS
ElasticLoadBalancerPort integer 待ち受けポート
備考: 返却値 1~65535の数値
InstancePort integer 宛先ポート
備考: 返却値 1~65535の数値
BalancingType integer ロードバランス方式
備考: 返却値 1 (Round-Robin),2 (Least-Connection)
Description string マルチロードバランサーのメモ情報(CDATA付)
SSLCertificateId string SSL証明書の発行識別子
SessionStickinessPolicy - セッション固定情報
Enabled boolean セッション固定利用フラグ
Method integer セッション固定方法
備考: 返却値 1 (ソースIPアドレス),2 (Cookie)
ExpirationPeriod integer セッション保持時間
単位: 分
備考: 返却値 3~60の数値
SorryPage - Sorryページ情報
Enabled boolean Sorryページ利用フラグ
RedirectUrl string Sorryページリダイレクト先URL(CDATA付)
Instances - 設定されているサーバー情報セット
member - 設定されているサーバー情報
InstanceUniqueId string サーバーユニークID
InstanceId string サーバー名
HealthCheck - ヘルスチェック情報
Target string ヘルスチェック プロトコル
Interval integer ヘルスチェック間隔(秒)
UnhealthyThreshold integer ヘルスチェック回数閾値
InstanceStates - 該当のサーバー情報セット
member - 該当のサーバー情報
InstanceUniqueId string サーバーユニークID
InstanceId string サーバー名
State string ヘルスステータス
ReasonCode string ※空を返却
Description string ※空を返却
Path string ヘルスチェックパス(CDATA付)
Expectation - ヘルスチェック期待値セット
member - ヘルスチェック期待値情報
HttpCode string ヘルスチェック期待値
AvailabilityZones - ゾーン情報
member string ゾーン名
NetworkInterfaces - ネットワークインターフェース情報セット
member - ネットワークインターフェース情報
NetworkId string ネットワークのユニークID
NetworkName string ネットワークの名前
DeviceIndex string デバイス番号
IpAddress string IPアドレス
SystemIpAddresses - システムIPアドレス情報セット
member - システムIPアドレス情報
SystemIpAddress string システムIPアドレス
IsVipNetwork boolean VIPネットワークフラグ(待ち受けポートが設定されるネットワーク)
Description string ネットワークのメモ情報
RouteTableId string ルートテーブルID
RouteTableAssociationId string ルートテーブル適用ID
VersionInformation - マルチロードバランサーのversion情報
IsLatest boolean マルチロードバランサーのversion最新状態
値:
  • true (最新)
  • false (最新以外)
Version string マルチロードバランサーのversion情報
CreatedTime timestamp 作成日時
ResponseMetadata - リクエスト情報
RequestId string リクエスト識別子

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/?
  Action=NiftyDescribeElasticLoadBalancers
  &ElasticLoadBalancers.ElasticLoadBalancerName.1=ELB1
  &CommonParams

  

応答サンプル

    <NiftyDescribeElasticLoadBalancersResponse xmlns="https://computing.api.nifcloud.com/api/">
  <NiftyDescribeElasticLoadBalancersResult>
    <ElasticLoadBalancerDescriptions>
      <member>
        <ElasticLoadBalancerId>elb-8db04f81</ElasticLoadBalancerId>
        <ElasticLoadBalancerName>ELB1</ElasticLoadBalancerName>
        <DNSName>192.168.0.100</DNSName>
        <NetworkVolume>20</NetworkVolume>
        <State>available</State>
        <AccountingType>1</AccountingType>
        <NextMonthAccountingType>2</NextMonthAccountingType>
        <ElasticLoadBalancerListenerDescriptions>
          <member>
            <Listener>
              <Protocol>HTTPS</Protocol>
              <ElasticLoadBalancerPort>443</ElasticLoadBalancerPort>
              <InstancePort>443</InstancePort>
              <BalancingType>1</BalancingType>
              <Description><![CDATA[Memo]]></Description>
              <SSLCertificateId>100</SSLCertificateId>
              <SessionStickinessPolicy>
                <Enabled>true</Enabled>
                <Method>1</Method>
                <ExpirationPeriod>10</ExpirationPeriod>
              </SessionStickinessPolicy>
              <SorryPage>
                <Enabled>true</Enabled>
                <RedirectUrl><![CDATA[https://example.com/]]></RedirectUrl>
              </SorryPage>
              <Instances>
                <member>
                  <InstanceUniqueId>i-0nzsfehj</InstanceUniqueId>
                  <InstanceId>server1</InstanceId>
                </member>
              </Instances>
              <HealthCheck>
                <InstanceStates>
                  <member>
                    <InstanceUniqueId>i-0nzsfehj</InstanceUniqueId>
                    <InstanceId>server1</InstanceId>
                    <State/>
                    <ReasonCode/>
                    <Description/>
                  </member>
                </InstanceStates>
                <Interval>10</Interval>
                <Target>TCP:80</Target>
                <UnhealthyThreshold>10</UnhealthyThreshold>
                <Path><![CDATA[/healthcheck.html]]></Path>
                <Expectation>
                  <member>
                    <HttpCode>2xx</HttpCode>
                  </member>
                </Expectation>
              </HealthCheck>
            </Listener>
          </member>
        </ElasticLoadBalancerListenerDescriptions>
        <AvailabilityZones>
          <member>east-11</member>
        </AvailabilityZones>
        <NetworkInterfaces>
          <member>
            <NetworkId>net-COMMON_GLOBAL</NetworkId>
            <NetworkName/>
            <DeviceIndex>1</DeviceIndex>
            <IpAddress>192.168.0.100</IpAddress>
            <SystemIpAddresses>
              <member>
                <SystemIpAddress>192.168.0.101</SystemIpAddress>
              </member>
              <member>
                <SystemIpAddress>192.168.0.102</SystemIpAddress>
              </member>
            </SystemIpAddresses>
            <IsVipNetwork>true</IsVipNetwork>
            <Description/>
          </member>
        </NetworkInterfaces>
        <RouteTableAssociationId>rtbassoc-22ax487d</RouteTableAssociationId>
        <RouteTableId>rtb-13ad487a</RouteTableId>
        <VersionInformation>
          <IsLatest>true</IsLatest>
          <Version>v2.0</Version>
        </VersionInformation>
        <CreatedTime>2016-08-24T15:10:00+09:00</CreatedTime>
      </member>
    </ElasticLoadBalancerDescriptions>
  </NiftyDescribeElasticLoadBalancersResult>
  <ResponseMetadata>
    <RequestId>ac501097-4c8d-475b-b06b-a90048ec181c</RequestId>
  </ResponseMetadata>
</NiftyDescribeElasticLoadBalancersResponse>

  

ニフクラ サイト内検索

APIメニュー

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

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