All Products
Search

This Product

    Server Load Balancer:ModifyLoadBalancerInternetSpec

    Document Center

    Server Load Balancer:ModifyLoadBalancerInternetSpec

    Last Updated:Mar 14, 2024

    Modifies the metering method of an Internet-facing Classic Load Balancer (CLB) instance.

    Operation description

    Description

    • If you modify only the maximum bandwidth of a pay-by-bandwidth CLB instance, the new bandwidth immediately takes effect.
    • If you modify the metering method (for example, switch from pay-by-bandwidth to pay-by-data-transfer), the new metering method and the other changes specified in the operation take effect at 00:00:00 the next day.

    Debugging

    OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

    Authorization information

    The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

    • Operation: the value that you can use in the Action element to specify the operation on a resource.
    • Access level: the access level of each operation. The levels are read, write, and list.
    • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
      • The required resource types are displayed in bold characters.
      • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
    • Condition Key: the condition key that is defined by the cloud service.
    • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
    OperationAccess levelResource typeCondition keyAssociated operation
    slb:ModifyLoadBalancerInternetSpecWRITE
    • loadbalancer
      acs:slb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}
    • slb:tag
    		none

    Request parameters

    ParameterTypeRequiredDescriptionExample
    RegionIdstringNo

    The ID of the region where the CLB instance is deployed.

    You can call the DescribeRegions operation to query the most recent region list.

    		cn-hangzhou
    LoadBalancerIdstringYes

    The ID of the CLB instance.

    		lb-bp1b6c719dfa08ex******
    InternetChargeTypestringNo

    The metering method of the Internet-facing CLB instance. Valid values:

    • paybybandwidth: pay-by-bandwidth
    • paybytraffic: pay-by-data-transfer
    		paybytraffic
    BandwidthintegerNo

    The maximum bandwidth of the Internet-facing CLB instance that uses the pay-by-bandwidth metering method. Unit: Mbit/s.

    Valid values: 1 to 5000. The maximum bandwidth varies based on the region where the CLB instance is created.****

    Note You do not need to specify this parameter if you set InternetChargeType to paybytraffic (pay-by-data-transfer).
    		10
    AutoPaybooleanNo

    Specifies whether to automatically pay the subscription fee of the Internet-facing CLB instance. Valid values:

    • true: enables automatic payments. This is the default value.
    • false: disables automatic payment. You must complete the payment in Order Center.
    		false

    Response parameters

    ParameterTypeDescriptionExample
    object
    OrderIdlong

    The order ID of the subscription CLB instance.

    		20142961978****
    RequestIdstring

    The ID of the request.

    		CEF72CEB-54B6-4AE8-B225-F876FF7BA984

    Examples

    Sample success responses

    JSONformat

    {
  "OrderId": 0,
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

    Error codes

    HTTP status codeError codeError messageDescription
    400OperationFailed.UnpaidBillsExistThe account has unpaid bills. Please pay your overdue bill first.-
    400Operation.NotAllowedOperation Denied. Unfinished order exists.-
    400Operation.NotAllowedOperation Denied. Unfinished purchase exists.The specified action is invalid. Your account contains incomplete purchase orders.
    400Operation.NotAllowedOperation Denied. Prepay instance only permitted to modify internet bandwidth.-
    400Operation.NotAllowedOperation Denied. Prepay instance only permitted to increase internet bandwidth.-
    400Operation.NotAllowedOperation Denied. The Purchase status of the instance is not valid.-
    400Instance.ShareSlbNotSupportPay95Illegal parameter. The share instance not support PayBy95 or PayByOld95.-
    400Instance.Pay95RateInvalidIllegal parameter. The rate is illegal.-
    400Instance.Pay95BandwidthIllegalIllegal parameter. The bandwidth is illegal.-
    400Instance.InternetChargeTypeNotAllowedIllegal parameter. The specified InternetChargeType not allowed.-
    400PAYFOR.ACCOUNT_MONEY_VALIDATE_ERRORYour channel partner account does not have sufficient funds, please contact your channel partner to recharge the account.-
    400OperationDenied.PayByCLCUThe operation is not allowed because the instanceChargeType of loadbalancer is PayByCLCU.-

    For a list of error codes, visit the Service error codes.