CreateLoadBalancerListeners

Description

ロードバランサーに、指定されたポートのリスナーを作成します。

指定されたLoadBalancerPortのリスナーがすでに存在する場合、InstancePort, InstanceProtocol, SSLCertificateIdはすでに存在するリスナーと一致していなくてはなりません。

InstancePort, InstanceProtocolを変更したい場合、ロードバランサーを再作成してください。

複数リスナーを指定する場合に、InstancePortとInstanceProtocolを複数リスナーで合わせる必要があります。

InstancePortとInstanceProtocolの組み合わせが異なる場合、ロードバランサーをその組み合わせ毎に作成してください。

Request Parameters

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

• Listeners.member.N

  LoadBalancerPort, InstancePort, Protocol, SSLCertificateIdを含むリスナーのリスト。

  • Type: Listener list
  • Required: Yes
• LoadBalancerName

  ロードバランサーの名前。

  • Type: String
  • Required: Yes

Response

以下のステータスコードを返却します。

• Normal response code

  本動作は正常に受け付けられました。

  • HTTP Status Code: 200

Response Elements

なし。

Errors

すべての動作に共通のエラー情報に関しては、「Common Errors」を参照してください。

• AccessPointNotFound

  指定したロードバランサーが見つかりませんでした。

  • HTTP Status Code: 400
• CertificateNotFound

  指定したSSL IDが、鍵管理サービスの有効なSSL証明書を参照していません。

  • HTTP Status Code: 400
• DuplicateListener

  特定のLoadBalancerNameおよびLoadBalancerPortに対してリスナーが存在するが、InstancePortまたはProtocolあるいはSSLCertificateIdが異なる。

  • HTTP Status Code: 400
• InvalidConfigurationRequest

  要求された構成変更は不正です。

  • HTTP Status Code: 409

Examples

Sample Request

この例では、ロードバランサー名がMyLB01のロードバランサーに対して、フロントエンド接続のポート番号/プロトコルが443/httpsで、バックエンド接続のポート番号/プロトコルが80/httpのリスナーを作成します。

https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/?Listeners.member.1.Protocol=https
&Listeners.member.1.LoadBalancerPort=443
&Listeners.member.1.InstancePort=80
&Listeners.member.1.InstanceProtocol=http
&Listeners.member.1.SSLCertificateId=1232d7bf-8f28-4cc7-a63d-44e218853c6d
&LoadBalancerName=MyLB01
&Version=2014-11-01
&Action=CreateLoadBalancerListeners     
     

Sample Response (XML)

<CreateLoadBalancerListenersResponse xmlns=" http://docs.cloudcommunity.global.fujitsu.com/loadbalancing/api/v1.0">
  <CreateLoadBalancerListenersResult/>
  <ResponseMetadata>
    <RequestId>1549581b-12b7-11e3-895e-1334aEXAMPLE</RequestId>
  </ResponseMetadata>
</CreateLoadBalancerListenersResponse>    
     

Sample Response (JSON)

{
  "CreateLoadBalancerListenersResponse": {
    "CreateLoadBalancerListenersResult": {
    },
    "ResponseMetadata": {
      "RequestId": "1549581b-12b7-11e3-895e-1334aEXAMPLE"
    }
  }
}