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