Modifying the Port of CVM on Forwarding Rules of Application Layer-7 Listener

Last updated: 2020-08-28 15:24:28

    API Description

    This API (ModifyForwardSeventhBackendsPort) is used to modify the port number of a CVM bound to some rules.

    Domain name for API access: lb.api.qcloud.com

    Request Parameters

    The following request parameter list only provides the API request parameters. Common request parameters are required when the API is called. For more information, please see Common Request Parameters page. The Action field for this API is ModifyForwardSeventhBackendsPort.

    Parameter Name Required Type Description
    loadBalancerId Yes String ID of load balancer instance. It can be queried by entering 1 or -1 in input parameter "forward" field through the API DescribeLoadBalancers.
    listenerId Yes String ID of application-based load balancer listener, which can be queried via the API DescribeForwardLBListeners.
    locationIds.n No String ID of forwarding rule.
    domain No String Domain of forwarding rule.
    url No String Path of forwarding rule.
    backends.n.instanceId Yes String Unique ID of the CVM, which can be obtained from "unInstanceId" in the returned fields of API DescribeInstances.
    This API allows entering instance IDs of multiple CVMs at a time. For example, if you want to enter two CVMs, enter: backends.1.instanceId&backends.2.instanceId.
    backends.n.port Yes Int Listening port of backend CVM of load balancer listener. Value range: 1-65535.
    backends.n.newPort Yes Int Listening port of backend CVM of load balancer listener. Value range: 1-65535.
    backends.n.weight No Int Weight of newly bound port.

    Response Parameters

    Parameter Name Type Description
    code Int Common error code. 0: Successful; other values: Failed. For more information, please see Common Error Codes on the Error Codes page.
    message String Module error message description depending on API.
    codeDesc String Error code. For a successful operation, "Success" is returned. For a failed operation, a message describing the failure is returned.
    requestId Int Request task ID. The operation status can be queried via the API DescribeLoadBalancersTaskResult.

    Example

    Request

    https://lb.api.qcloud.com/v2/index.php?Action=ModifyForwardSeventhBackendsPort
    &<Common request parameters>
    &loadBalancerId=lb-abcdefgh
    &listenerId=lbl-20cxbf40
    &locationIds.0=loc-l3fd1xt2
    &backends.0.instanceId=ins-6789test
    &backends.0.port=80
    &backends.0.newPort=8080

    Response

    
    {
      "code" : 0,
      "message" : "",
      "codeDesc": "Success",
      "requestId" : 1234
    }
    

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help