DeregisterInstancesFromLoadBalancer
Description
ロードバランサーから指定した分散先インスタンスを削除します。
分散先インスタンスを削除すると、ロードバランサの対象外になります。
本APIは、ロードバランサーを作成したときのアカウントと同一のプロジェクトに属するアカウントで操作してください。
ロードバランサーから分散先インスタンスが削除されたかどうかはDescribeLoadBalancersで確認できます。
Request Parameters
すべての動作で使用する一般的なパラメタの情報に関しては、「Common Parameters」を参照してください。
- Instances.member.N
削除対象の分散先インスタンスIDのリスト。
- Type: Instance list
- Required: Yes
- LoadBalancerName
ロードバランサーの名前。
- Type: String
- Required: Yes
Response
以下のステータスコードを返却します。
- Normal response code
本動作は正常に受け付けられました。
- HTTP Status Code: 200
Response Elements
DeregisterInstancesFromLoadBalancerResultという構造体で、以下の要素を返却します。
- Instances
更新後のロードバランサーに登録されている分散先インスタンスのリスト。
- Type: [InstanceDescription] list
Errors
すべての動作に共通のエラー情報に関しては、「Common Errors」を参照してください。
- AccessPointNotFound
指定したロードバランサーが見つかりませんでした。
- HTTP Status Code: 400
- InvalidEndPoint
指定したエンドポイントは無効です。
- HTTP Status Code: 400
Examples
Sample Request
この例では、ロードバランサー名がMyLB01のロードバランサーから、インスタンスIDがi-e3677ad7の分散先インスタンスを削除します。
https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/?Instances.member.1.InstanceId=i-e3677ad7
&LoadBalancerName=MyLB01
&Version=2014-11-01
&Action=DeregisterInstancesFromLoadBalancer
Sample Response (XML)
<DeregisterInstancesFromLoadBalancerResponse xmlns=" http://docs.cloudcommunity.global.fujitsu.com/loadbalancing/api/v1.0">
<DeregisterInstancesFromLoadBalancerResult>
<Instances>
<member>
<InstanceId>i-6ec63d59</InstanceId>
<PortId>p-6ec63d59</PortId>
</member>
<member>
<InstanceId>i-34cde612</InstanceId>
</member>
</Instances>
</DeregisterInstancesFromLoadBalancerResult>
<ResponseMetadata>
<RequestId>83c88b9d-12b7-11e3-8b82-87b12EXAMPLE</RequestId>
</ResponseMetadata>
</DeregisterInstancesFromLoadBalancerResponse>
Sample Response (JSON)
{
"DeregisterInstancesFromLoadBalancerResponse": {
"DeregisterInstancesFromLoadBalancerResult": {
"Instances": {
"member": [
{
"InstanceId": "i-6ec63d59"
"PortId": "p-6ec63d59"
},
{
"InstanceId": "i-34cde612"
}
]
}
},
"ResponseMetadata": {
"RequestId": "83c88b9d-12b7-11e3-8b82-87b12EXAMPLE"
}
}
}