本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>API> コンピューティング> NiftyDescribeElasticLoadBalancers

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 integer ヘルスチェック期待値
␣␣␣␣AvailabilityZones - ゾーン情報
␣␣␣␣␣member string ゾーン名
␣␣␣␣NetworkInterfaces - ネットワークインターフェース情報セット
␣␣␣␣␣member - ネットワークインターフェース情報
␣␣␣␣␣␣NetworkId string ネットワークのユニークID
␣␣␣␣␣␣NetworkName string ネットワークの名前
␣␣␣␣␣␣DeviceIndex string デバイス番号
␣␣␣␣␣␣IpAddress 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.0.2.0</DNSName>
        <NetworkVolume>20</NetworkVolume>
        <State>available</State>
        <AccountingType>1</AccountingType>
        <NextMonthAccountingType>2</NextMonthAccountingType>
        <ElasticLoadBalancerListenerDescriptions>
          <member>
            <Listener>
              <Protocol>TCP</Protocol>
              <ElasticLoadBalancerPort>80</ElasticLoadBalancerPort>
              <InstancePort>80</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>200</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>
            <IsVipNetwork>true</IsVipNetwork>
            <Description/>
          </member>
        </NetworkInterfaces>
        <RouteTableAssociationId>rtbassoc-22ax487d</RouteTableAssociationId>
        <RouteTableId>rtb-13ad487a</RouteTableId>
        <VersionInformation>
          <IsLatest>true</IsLatest>
          <Version>v1.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メニュー

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

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

ページの先頭へ