本文へジャンプします。

ニフクラ ユーザーガイド

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

ListLoadBalancers

処理概要

ロードバランサーの情報一覧を取得します。 1回のリクエストで、複数のロードバランサー情報を取得できます。

リクエストURL

GET /v1/loadBalancers

指定するパラメーター

なし

応答フィールド

フィールド (項目) 説明
loadBalancers[] object[]
accountingType integer 当月の利用料金タイプ
availabilityZones string[] ゾーン情報
clusters[] object[]
name string クラスター名
nodePools[] object[]
name string ノードプール名
nodeCount integer ノードプール内の現在のノード数
nodes[] object[]
availabilityZone string ノードが存在しているゾーン名
healthCheckState string ヘルスチェックの状態
値:
  • IN_SERVICE (稼動中)
  • OUT_OF_SERVICE (非稼動中)
name string ノード名
publicIpAddress string グローバルIPアドレス
createdTime string 作成日時
description string メモ
dnsName string グローバルIPアドレス
filter object
filterType string 指定したアクセス元IPアドレスへの対処
ipAddresses string フィルター対象のアクセス元IPアドレスの情報セット
healthCheck object
unhealthyThreshold integer ヘルスチェック回数の閾値
interval integer ヘルスチェック間隔
target string PINGプロトコル:ポート(宛先)
timeout integer タイムアウト
healthyThreshold integer ヘルスチェックの復旧判断
listenerDescriptions[] object[]
listener object
protocol string プロトコル
loadBalancerPort string 待ち受けポート
instancePort string 宛先ポート
balancingType string ロードバランス方式
sslCertificateId string SSL証明書の発行識別子
loadBalancerName string ロードバランサー名
networkVolume string 最大ネットワーク流量
nextMonthAccountingType integer 次月からの利用料金タイプ
option object
sessionStickinessPolicy object
enabled boolean オプション利用フラグ
expirationPeriod integer セッション保持時間
sorryPage object
enabled boolean オプション利用フラグ
statusCode integer Sorry ページオプション情報
policyType string 暗号化タイプ

リクエストサンプル

    curl https://jp-east-1.hatoba.api.nifcloud.com/v1/loadBalancers
  -H "X-Amz-Date: 20210511T124324Z"
  -H "Authorization: AWS4-HMAC-SHA256 ..."

  

応答サンプル

    {
  "loadBalancers": [
      {
          "accountingType": 2,
          "availabilityZones": [
              "west-11"
          ],
          "clusters": [
              {
                  "name": "cluster01",
                  "nodePools": [
                      {
                          "name": "nodepool01",
                          "nodeCount": 2,
                          "nodes": [
                              {
                                  "availabilityZone": "east-11",
                                  "healthCheckState": "IN_SERVICE",
                                  "name": "nodepool01-swiaj",
                                  "publicIpAddress": "x.x.x.x"
                              },
                              {
                                  "availabilityZone": "east-11",
                                  "healthCheckState": "IN_SERVICE",
                                  "name": "nodepool01-taqmb",
                                  "publicIpAddress": "x.x.x.x"
                              }
                          ]
                      }
                  ]
              }
          ],
          "createdTime": "2021-05-11T21:40:15+09:00",
          "description": "",
          "dnsName": "x.x.x.x",
          "filter": {
              "filterType": 1,
              "ipAddresses": [
                  {
                      "ipAddress": "*.*.*.*"
                  }
              ]
          },
          "healthCheck": {
              "healthyThreshold": 1,
              "interval": 30,
              "target": "TCP:30550",
              "timeout": 90,
              "unhealthyThreshold": 1
          },
          "listenerDescriptions": [
              {
                  "listener": {
                      "balancingType": 1,
                      "instancePort": 30550,
                      "loadBalancerPort": 80,
                      "protocol": "HTTP",
                      "sslCertificateId": 0
                  }
              }
          ],
          "loadBalancerName": "nginx",
          "networkVolume": "10",
          "nextMonthAccountingType": 2,
          "option": {
              "sessionStickinessPolicy": {
                  "enabled": false,
                  "expirationPeriod": 0
              },
              "sorryPage": {
                  "enabled": false,
                  "statusCode": 0
              }
          },
          "policyType": "standard"
      },
      {
          "accountingType": 2,
          "availabilityZones": [
              "east-11"
          ],
          "clusters": [
              {
                  "name": "cluster01",
                  "nodePools": [
                      {
                          "name": "nodepool01",
                          "nodeCount": 2,
                          "nodes": [
                              {
                                  "availabilityZone": "east-11",
                                  "healthCheckState": "IN_SERVICE",
                                  "name": "nodepool01-swiaj",
                                  "publicIpAddress": "x.x.x.x"
                              },
                              {
                                  "availabilityZone": "east-11",
                                  "healthCheckState": "IN_SERVICE",
                                  "name": "nodepool01-taqmb",
                                  "publicIpAddress": "x.x.x.x"
                              }
                          ]
                      }
                  ]
              }
          ],
          "createdTime": "2021-05-11T21:43:17+09:00",
          "description": "",
          "dnsName": "x.x.x.x",
          "filter": {
              "filterType": 1,
              "ipAddresses": [
                  {
                      "ipAddress": "*.*.*.*"
                  }
              ]
          },
          "healthCheck": {
              "healthyThreshold": 1,
              "interval": 30,
              "target": "TCP:30084",
              "timeout": 90,
              "unhealthyThreshold": 1
          },
          "listenerDescriptions": [
              {
                  "listener": {
                      "balancingType": 1,
                      "instancePort": 30084,
                      "loadBalancerPort": 443,
                      "protocol": "HTTPS",
                      "sslCertificateId": 0
                  }
              }
          ],
          "loadBalancerName": "nginx",
          "networkVolume": "10",
          "nextMonthAccountingType": 2,
          "option": {
              "sessionStickinessPolicy": {
                  "enabled": false,
                  "expirationPeriod": 0
              },
              "sorryPage": {
                  "enabled": false,
                  "statusCode": 0
              }
          },
          "policyType": "standard"
      }
  ]
}

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

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