Modifies the specification of a Server Load Balancer (SLB) instance.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyLoadBalancerInstanceSpec

The operation that you want to perform.

Set the value to ModifyLoadBalancerInstanceSpec.

LoadBalancerId String Yes lb-bp1b6c719df*********

The ID of the SLB instance.

LoadBalancerSpec String Yes slb.s2.small

The specification of the SLB instance. Valid values:

  • slb.s1.small
  • slb.s2.small
  • slb.s2.medium
  • slb.s3.small
  • slb.s3.medium
  • slb.s3.large

The supported specifications vary by region. For more information about the specifications of high-performance SLB instances, see High-performance SLB instances.

Note When you change a shared-resource SLB instance to a high-performance SLB instance, service disruptions may occur. The SLB instance may stop providing services for 10 to 30 seconds. Therefore, we recommend that you modify the configuration during off-peak hours. In addition, you can use Global Server Load Balancing (GSLB) to switch your workloads to another SLB instance before you modify the configuration.
RegionId String Yes cn-hangzhou

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

You can query region IDs from the Regions and zones list or by calling the DescribeRegions operation.

AutoPay Boolean No true

Specifies whether to enable automatic payment. Valid values:

  • true: enables automatic payment.
  • false: disables automatic payment. You must complete the payment in Order Center.
Note You can enable automatic payment for only subscription SLB instances.

Response parameters

Parameter Type Example Description
OrderId Long 201429619788910

The order ID of the subscription SLB instance.

RequestId String 365F4154-92F6-4AE4-92F8-7FF34B540710

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ModifyLoadBalancerInstanceSpec
&LoadBalancerId=lb-bp1b6c719df*********
&LoadBalancerSpec=slb.s2.small
&<Common request parameters>

Sample success responses

XML format 

<ModifyLoadBalancerInstanceSpecResponse>
     <RequestId>D456A34A-6E40-4379-8DAF-9175760FE215</RequestId>
  </ModifyLoadBalancerInstanceSpecResponse>

JSON format 

{
    "RequestId": "D456A34A-6E40-4379-8DAF-9175760FE215"
}

Error codes

HttpCode Error code Error message Description
400 ModifySpecNotAllowed LoadBalancerSpec not allowed for this instance The error message returned because the specified SLB instance does not support the specification.
400 Operation.NotAllowed Operation Denied. Unfinished purchase exists. The error message returned because a pending order exists.
400 ChangeLbSpecNotAllowed You cannot change the specification for the specified load balancer. The error message returned because you cannot modify the specification of the specified SLB instance.

For a list of error codes, visit the API Error Center.