本文へジャンプします。

ニフクラ ユーザーガイド

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

ConfigureHealthCheck

処理概要

指定したロードバランサーのヘルスチェックの設定を変更します。

ロードバランサーを指定するためには、ロードバランサー名・ポート番号が必要です。

ヘルスチェックの実行結果は、API「DescribeInstanceHealth」で確認できます。

ヘルスチェックの際のサーバー切り離し時間について
  • サーバーからの応答時間がタイムアウトを超えた場合にサーバーをロードバランサーから切り離します。
  • 設定されるヘルスチェックのタイムアウト時間については、ロードバランサー(L4)のヘルスチェックについてをご確認ください。
  • 設定されたヘルスチェックのタイムアウト時間は、「DescribeLoadBalancers」の Timeout で確認ができます。

指定するパラメーター

パラメーター 説明 必須
LoadBalancerName string 対象のロードバランサー名
LoadBalancerPort integer 対象の待ち受けポート
InstancePort integer 対象の宛先ポート
HealthCheck.Target string ヘルスチェック プロトコル
使用可能文字: TCP:宛先ポート(TCPの場合の宛先ポート)、ICMP
HealthCheck.Interval integer ヘルスチェック間隔
単位: 秒
使用可能文字: 5-300
HealthCheck.Timeout integer ※指定不可
HealthCheck.UnhealthyThreshold integer タイムアウトまでのヘルスチェック回数
※サーバーを切り離すタイムアウト時間の算出で利用。「処理概要」の「ヘルスチェックの際のサーバー切り離し時間について」を参照してください。
使用可能文字: 1-10
HealthCheck.HealthyThreshold integer サーバーが復旧した際のヘルスチェックの復旧判断回数(連続してこの値を超えた回数のチェックに成功した場合は、復旧したものと判断し、該当サーバーをロードバランサーに接続する)
Default: 1
使用可能文字: 1

応答フィールド

フィールド (項目) 説明
ConfigureHealthCheckResponse - ConfigureHealthCheckレスポンス
ConfigureHealthCheckResult - ヘルスチェック設定の情報セット
HealthCheck - ヘルスチェック設定の情報
Target string ヘルスチェック プロトコル
Interval integer ヘルスチェック間隔
UnhealthyThreshold integer タイムアウトまでのヘルスチェック回数
※サーバーを切り離すタイムアウト時間の算出で利用。「処理概要」の「ヘルスチェックの際のサーバー切り離し時間について」を参照してください。
HealthyThreshold integer ヘルスチェックの復旧判断
ResponseMetadata - リクエスト情報
RequestId string リクエスト識別子

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action=ConfigureHealthCheck
  &LoadBalancerName=lb0001
  &LoadBalancerPort=80
  &InstancePort=80
  &HealthCheck.Target=TCP:80
  &HealthCheck.Interval=300
  &HealthCheck.UnhealthyThreshold=3
  &HealthCheck.HealthyThreshold=1
  &CommonParams

  

応答サンプル

    <ConfigureHealthCheckResponse xmlns="https://computing.api.nifcloud.com/api/">
  <ConfigureHealthCheckResult>
    <HealthCheck>
      <Target>TCP:80</Target>
      <Interval>300</Interval>
      <UnhealthyThreshold>3</UnhealthyThreshold>
      <HealthyThreshold>1</HealthyThreshold>
    </HealthCheck>
  </ConfigureHealthCheckResult>
  <ResponseMetadata>
    <RequestId>ac501097-4c8d-475b-b06b-a90048ec181c</RequestId>
  </ResponseMetadata>
</ConfigureHealthCheckResponse>

  

ニフクラ サイト内検索

APIメニュー

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

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