バックエンドサーバーの追加

注 2 つ以上の同じ ECS インスタンスがリクエストに追加された場合、最初の ECS インスタンスのみが追加されます。

デバッグ

OpenAPI Explorer を使って、デバッグ操作を実行し、SDK コード例を生成します。

リクエストパラメータ

パラメータ データ型 必須/省略可能 値の例 説明
Action String 必須 AddBackendServers

この操作の名前です。 値：AddBackendServers

BackendServers String 必須 [{"ServerId":"i-2zej4lxhjoq1icue6kup","Weight":"100"},{"ServerId":"i-2ze1u9ywulp5pbvvc7hv","Weight":"100"}]

追加されるバックエンドサーバーのリストです。

リストには以下のパラメーターを含む必要があります。

  • ServerId：ECS インスタンスの ID です。
  • バックエンドサーバーの重みです。 値の範囲： 0 ～ 100 デフォルト値 ：100 バックエンドサーバーの重み値が 0 の場合、リクエストはこのサーバーに配信されません。
  • バックエンドサーバーのタイプです。 有効値：
    • ecs：ECS インスタンス (デフォルト)
    • eni：Elastic Network Interface (ENI)
注 実行状態にあるバックエンドサーバー (ECSインスタンス) のみを追加できます。 一度に最大 20 のバックエンドサーバーを追加できます。
LoadBalancerId String 必須 lb-2ze7o5h52g02kkzze7lru

SLB インスタンスの ID です。
RegionId String 必須 cn-beijing

SLB インスタンスが属するリージョンの ID です。

リージョン ID を照会するにはDescribeRegions API を呼び出します。

OwnerAccount String 省略可能 OwnerAccount

任意。 アカウントです。

レスポンスパラメータ

パラメータ データ型 値の例 説明
LoadBalancerId String lb-2ze7o5h52g02kkzze7lru

SLB インスタンスの ID です。
BackendServers

バックエンドサーバーのリストです。
└ServerId String i-2zej4lxhjoq1icue6kup

ECS インスタンス ID または ENI インスタンス ID です。
└Weight String 100

バックエンドサーバーの重みです。

値の範囲： 0〜100

デフォルト値：100。 値が 0 の場合、バックエンドサーバーにリクエストは転送されません。

└Description String バックエンドサーバー

バックエンドサーバーの説明です。
└Type String ecs

バックエンドサーバーのタイプです。

  • ecs：ECS インスタンス (デフォルト)
  • eni：Elastic Network Interface (ENI)
RequestId String 34B82C81-F13B-4EEB-99F6-A048C67CC830

リクエストの ID です。

例

リクエストの例


http(s)://[Endpoint]/? Action=AddBackendServers
&LoadBalancerId=lb-2ze7o5h52g02kkzze7lru 
&<CommonParameters>

レスポンスの例

XML 形式 

<AddBackendServersResponse> 
  <BackendServers> 
    <BackendServer> 
      <ServerId>i-2zej4lxhjoq1icue6kup</ServerId> 
      <Weight>100</Weight> 
      <Type>ecs</Type> 
    </BackendServer> 
    <BackendServer> 
      <ServerId>i-2ze1u9ywulp5pbvvc7hv</ServerId> 
      <Weight>100</Weight> 
      <Type>ecs</Type> 
    </BackendServer> 
  </BackendServers> 
  <RequestId>34B82C81-F13B-4EEB-99F6-A048C67CC830</RequestId> 
  <LoadBalancerId>lb-2ze7o5h52g02kkzze7lru</LoadBalancerId> 
</AddBackendServersResponse>

JSON 形式 

{
	"BackendServers":{
		"BackendServer":[
			{
				"ServerId":"i-2zej4lxhjoq1icue6kup",
				"Weight":100,
				"Type":"ecs"
			},
			{
				"ServerId":"i-2ze1u9ywulp5pbvvc7hv",
				"Weight":100,
				"Type":"ecs"
			}
		]
	},
	"RequestId":"34B82C81-F13B-4EEB-99F6-A048C67CC830",
	"LoadBalancerId":"lb-2ze7o5h52g02kkzze7lru"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 InvalidParameter 指定されたロードバランサーは、ECS インスタンスのネットワークタイプをサポートしていません。 SLB インスタンスは、このネットワークタイプの ECS インスタンスをサポートしません。 ECS ネットワークタイプを変更してもう一度やり直してください。

一般的なエラーコードをご参照ください。