NiftyReplaceElasticLoadBalancerLatestVersion
処理概要
指定したマルチロードバランサーを最新バージョンに入れ替えます。
最新バージョンに入れ替わる対象マルチロードバランサーについては、対象マルチロードバランサーの設定してある全てのプロトコル・待ち受けポート・宛先ポートが対象となります。
マルチロードバランサーを最新バージョンに入れ替える際は、通信断を伴います。また、最新バージョンにしたマルチロードバランサーのロールバックはできませんのでご注意ください。通信断となる時間については、サービス仕様ページをご参照ください。
マルチロードバランサーを指定するためには、マルチロードバランサーユニークIDまたはマルチロードバランサー名が必要です。処理中のマルチロードバランサーを指定した、削除済みのマルチロードバランサーを指定した、管理外のマルチロードバランサーを指定した、すでに最新バージョンのマルチロードバランサーを指定したなど、無効なマルチロードバランサーを指定した場合は、エラーが返されます。
マルチロードバランサーが最新バージョンかどうかは、API「NiftyDescribeElasticLoadBalancers」のレスポンス値「IsLatest」で確認できます。
指定するパラメーター
| パラメーター | 説明 | 必須 | サンプル値 |
|---|---|---|---|
| ElasticLoadBalancerId | 対象のマルチロードバランサーユニークID Type : String |
○ （マルチロードバランサー名といずれか） |
elb-8db04f81 |
| ElasticLoadBalancerName | 対象のマルチロードバランサー名 Type : String 使用可能文字 : 半角英数字(15文字) |
○ （マルチロードバランサーユニークIDといずれか） |
応答フィールド
| フィールド | 説明 | サンプル値 |
|---|---|---|
| NiftyReplaceElasticLoadBalancerLatestVersionResponse | NiftyReplaceElasticLoadBalancerLatestVersionレスポンス Type : NiftyReplaceElasticLoadBalancerLatestVersionResponse Ancestor :なし Children : NiftyReplaceElasticLoadBalancerLatestVersionResult, ResponseMetadata |
|
| NiftyReplaceElasticLoadBalancerLatestVersionResult | ※空を返却 Type : NiftyReplaceElasticLoadBalancerLatestVersionResult Ancestor : NiftyReplaceElasticLoadBalancerLatestVersionResponse Children : なし |
|
| ResponseMetadata | リクエスト情報 Type : ResponseMetadata Ancestor : NiftyReplaceElasticLoadBalancerLatestVersionResponse Children : RequestId |
|
| RequestId | リクエスト識別子 Type : xsd:string Ancestor :ResponseMetadata Children : なし |
ac501097-4c8d-475b-b06b-a90048ec181c |
リクエストサンプル
https://jp-east-1.computing.api.nifcloud.com/api/?Action=NiftyReplaceElasticLoadBalancerLatestVersion&ElasticLoadBalancerName=lb0001応答サンプル
<NiftyReplaceElasticLoadBalancerLatestVersionResponse xmlns="https://computing.api.nifcloud.com/api/">
<NiftyReplaceElasticLoadBalancerLatestVersionResult />
<ResponseMetadata>
<RequestId>ac501097-4c8d-475b-b06b-a90048ec181c</RequestId>
</ResponseMetadata>
</NiftyReplaceElasticLoadBalancerLatestVersionResponse>
