本文へジャンプします。

ニフクラ APIリファレンス

クラウド トップ>APIのご利用にあたって>ニフクラREST API>NiftyReplaceElasticLoadBalancerLatestVersion

NiftyReplaceElasticLoadBalancerLatestVersion

処理概要

指定したマルチロードバランサーを最新バージョンに入れ替えます。
最新バージョンに入れ替わる対象マルチロードバランサーについては、対象マルチロードバランサーの設定してある全てのプロトコル・待ち受けポート・宛先ポートが対象となります。

マルチロードバランサーを最新バージョンに入れ替える際は、通信断を伴います。また、最新バージョンにしたマルチロードバランサーのロールバックはできませんのでご注意ください。通信断となる時間については、サービス仕様ページをご参照ください。

マルチロードバランサーを指定するためには、マルチロードバランサーユニークIDまたはマルチロードバランサー名が必要です。処理中のマルチロードバランサーを指定した、削除済みのマルチロードバランサーを指定した、管理外のマルチロードバランサーを指定した、すでに最新バージョンのマルチロードバランサーを指定したなど、無効なマルチロードバランサーを指定した場合は、エラーが返されます。

マルチロードバランサーが最新バージョンかどうかは、API「NiftyDescribeElasticLoadBalancers」のレスポンス値「IsLatest」で確認できます。

指定するパラメーター

パラメーター 説明 必須 サンプル値
ElasticLoadBalancerId 対象のマルチロードバランサーユニークID
Type : String

(マルチロードバランサー名といずれか)
elb-8db04f81
ElasticLoadBalancerName 対象のマルチロードバランサー名
Type : String
使用可能文字 : 半角英数字(15文字)

(マルチロードバランサーユニークIDといずれか)
 

応答フィールド

フィールド 説明 サンプル値
NiftyReplaceElasticLoadBalancerLatestVersionResponse NiftyRegisterInstancesWithElasticLoadBalancerレスポンス
Type : NiftyReplaceElasticLoadBalancerLatestVersionResponse
Ancestor :なし
Children : NiftyReplaceElasticLoadBalancerLatestVersionResult, ResponseMetadata
 
NiftyReplaceElasticLoadBalancerLatestVersionResult ※空を返却
Type : NiftyReplaceElasticLoadBalancerLatestVersionResult
Ancestor : NiftyReplaceElasticLoadBalancerLatestVersionResponse
Children : なし
 
ResponseMetadata リクエスト情報
Type : ResponseMetadata
Ancestor : NiftyRegisterInstancesWithElasticLoadBalancerResponse
Children : RequestId
 
RequestId リクエスト識別子
Type : xsd:string
Ancestor :ResponseMetadata
Children : なし
ac501097-4c8d-475b-b06b-a90048ec181c

リクエストサンプル

https://cp.cloud.nifty.com/api/?Action=NiftyReplaceElasticLoadBalancerLatestVersion&ElasticLoadBalancerName=lb0001

応答サンプル

<NiftyReplaceElasticLoadBalancerLatestVersionResponse xmlns="https://cp.cloud.nifty.com/api/">
  <NiftyReplaceElasticLoadBalancerLatestVersionResult />
  <ResponseMetadata>
    <RequestId>ac501097-4c8d-475b-b06b-a90048ec181c</RequestId>
  </ResponseMetadata>
</NiftyReplaceElasticLoadBalancerLatestVersionResponse>

ニフティクラウド サイト内検索

APIメニュー

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

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