ニフクラAPI (コンピューティング: RegisterInstancesWithLoadBalancer)

RegisterInstancesWithLoadBalancer

処理概要

指定したロードバランサーにサーバーを追加します。

ロードバランサーを指定するためには、ロードバランサー名・ポート番号が必要です。自分が所有していないロードバランサーを指定する場合は、「ニフクラID.ロードバランサー名」の形式で指定する必要があります。

またサーバーを指定するためには、サーバー名が必要です。IPアドレスを固定化しているサーバーを指定できます。

指定するパラメーター

パラメーター	型	説明	必須
LoadBalancerName	string	対象のロードバランサー名	○
LoadBalancerPort	integer	対象の待ち受けポート	○
InstancePort	integer	対象の宛先ポート	○
Instances.member.n.InstanceId	string	サーバー名	○

応答フィールド

フィールド (項目)	型	説明
RegisterInstancesWithLoadBalancerResponse	-	RegisterInstancesWithLoadBalancerレスポンス
␣RegisterInstancesWithLoadBalancerResult	-	処理結果の情報セット
␣␣Instances	-	追加に成功したサーバーの情報セット
␣␣␣member	-	追加に成功したサーバーの情報
␣␣␣␣InstanceId	string	サーバー名
␣␣␣␣InstanceUniqueId	string	サーバーユニークID
␣ResponseMetadata	-	リクエスト情報
␣␣RequestId	string	リクエスト識別子

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action=RegisterInstancesWithLoadBalancer
  &LoadBalancerName=lb0001
  &LoadBalancerPort=80
  &InstancePort=80
  &Instances.member.1.InstanceId=server02
  &CommonParams

  

応答サンプル

    <RegisterInstancesWithLoadBalancerResponse xmlns="https://computing.api.nifcloud.com/api/">
  <RegisterInstancesWithLoadBalancerResult>
    <Instances>
      <member>
        <InstanceId>server02</InstanceId>
        <InstanceUniqueId>i-asda1234</InstanceUniqueId>
      </member>
    </Instances>
  </RegisterInstancesWithLoadBalancerResult>
  <ResponseMetadata>
    <RequestId>ac501097-4c8d-475b-b06b-a90048ec181c</RequestId>
  </ResponseMetadata>
</RegisterInstancesWithLoadBalancerResponse>