DeregisterInstancesFromLoadBalancer

Description

ロードバランサーから指定した分散先インスタンスを削除します。

分散先インスタンスを削除すると、ロードバランサの対象外になります。

本APIは、ロードバランサーを作成したときのアカウントと同一のプロジェクトに属するアカウントで操作してください。

ロードバランサーから分散先インスタンスが削除されたかどうかはDescribeLoadBalancersで確認できます。

Request Parameters

すべての動作で使用する一般的なパラメタの情報に関しては、「Common Parameters」を参照してください。

  • Instances.member.N

    削除対象の分散先インスタンスIDのリスト。

  • 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"
    }
  }
}