本文へジャンプします。

ニフクラ ユーザーガイド

ConfigureHealthCheck

処理概要

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

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

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

指定するパラメーター

パラメーター 説明 必須
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 サーバーが復旧した際のヘルスチェックの復旧判断回数(連続してこの値を超えた回数のチェックに成功した場合は、復旧したものと判断し、該当サーバーをロードバランサーに接続する)
値: 1
Default: 1

応答フィールド

フィールド (項目) 説明
ConfigureHealthCheckResponse - ConfigureHealthCheckレスポンス
Ancestor: なし
Children: ConfigureHealthCheckResult | ResponseMetadata
ConfigureHealthCheckResult - ヘルスチェック設定の情報セット
Ancestor: ConfigureHealthCheckResponse
Children: HealthCheck
HealthCheck - ヘルスチェック設定の情報
Ancestor: ConfigureHealthCheckResult
Children: Target | Interval | UnhealthyThreshold | HealthyThreshold
Target string ヘルスチェック プロトコル
Ancestor: HealthCheck
Children: なし
Interval integer ヘルスチェック間隔
Ancestor: HealthCheck
Children: なし
UnhealthyThreshold integer ヘルスチェック回数の閾値
Ancestor: HealthCheck
Children: なし
HealthyThreshold integer ヘルスチェックの復旧判断
Ancestor: HealthCheck
Children: なし
ResponseMetadata - リクエスト情報
Ancestor: ConfigureHealthCheckResponse
Children: RequestId
RequestId string リクエスト識別子
Ancestor: ResponseMetadata
Children: なし

リクエストサンプル

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

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

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