CreateListener

Wire call

Converge Cloud is RPC over HTTP. There is one path — / — and the action travels in the X-TC-Action header. The /clb/CreateListener path used in the OpenAPI document is a documentation convenience so each action is addressable; it is not a route on the server.

curl -sS https://clb.api3.convergecloud.com/ \
  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/clb/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \
  -H 'Content-Type: application/json; charset=utf-8' \
  -H 'Host: clb.api3.convergecloud.com' \
  -H 'X-TC-Action: CreateListener' \
  -H 'X-TC-Version: 2018-03-17' \
  -H 'X-TC-Timestamp: <unix-seconds>' \
  -H 'X-TC-Region: luzon' \
  -d '{"LoadBalancerId":"<LoadBalancerId>","Ports":"<Ports>","Protocol":"<Protocol>"}'

Request parameters

Response

Fields are returned inside the Response envelope. Converge Cloud answers HTTP 200 for errors as well as successes, so read Response.Error rather than the status code — and test for the presence of that object, because Code is occasionally the empty string.

{
  "Response": {
    "ListenerIds": …,
    "RequestId": "…"
  }
}

{
  "Response": {
    "Error": { "Code": "…", "Message": "…" },
    "RequestId": "…"
  }
}

Try it

What failure looks like

Example error responses for this action. Match on Code.

{
  "Response": {
    "RequestId": "5bb01994-887a-c603-136d-c707ff7e961b",
    "Error": {
      "Code": "InvalidParameter",
      "Message": "[Type 3002] Certificate: Additional property CertKeyName is not allowed; "
    }
  }
}