CreateLoadBalancerListeners

Description

Creates one or more listeners for the port specified in the load balancer.

If a listener for the specified LoadBalancerPort exists, InstancePort, InstanceProtocol and SSLCertificateId values must match the existing listener's.

To change the InstancePort and/or Protocol for an existing listener, re-create the load balancer.

In the case specifying multiple listeners, it is necessary to match their InstanceProtocol and InstancePort values.

If combinations of InstancePort and InstanceProtocol are different, it is necessary to create a load balancer for each combination.

Request parameters

Refer to "Common Parameters" for details on standard parameter information used by all actions.

• Listeners.member.N

  List of listeners, including LoadBalancerPort, InstancePort, Protocol, and SSLCertificateId.

  • Type: Listener list
  • Required: Yes
• LoadBalancerName

  Name of the load balancer.

  • Type: String
  • Required: Yes

Response

The following status code is returned.

• Normal response code

  This operation was accepted normally.

  • HTTP Status Code: 200

Response Elements

None.

Errors

Refer to "Common Errors" for details on error information common to all operations.

• AccessPointNotFound

  The specified load balancer could not be found.

  • HTTP Status Code: 400
• CertificateNotFound

  The specified SSL ID does not refer to a valid SSL certificate in the Key Management Service.

  • HTTP Status Code: 400
• DuplicateListener

  A listener already exists for the given LoadBalancerName and LoadBalancerPort, but with a different InstancePort, Protocol, or SSLCertificateId.

  • HTTP Status Code: 400
• InvalidConfigurationRequest

  Requested configuration change is invalid.

  • HTTP Status Code: 409

Examples

Sample Request

The example below creates a listener for the 443/https port/protocol for the front-end connection and 80/http port/protocol for the back-end connection for the load balancer named MyLB01.

https://loadbalancing.(regionName).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"
    }
  }
}