edit-icon download-icon

RemoveBackendServers

Last Updated: Apr 04, 2018

Description

Remove one or more ECS instances from the backend server pool.

Note: No error will be returned if an ECS instance to be removed does not exist in the backend server pool.

Request parameter

Name Type Required Description
Action String Yes

The action to perform.

Valid value: RemoveBackendServers

RegionId String Yes The ID of the region where the SLB instance is located.
LoadBalancerId String Yes The ID of the SLB instance.
BackendServers JSON String Yes

A list of backend servers.

Up to 20 backend servers can be contained in one request. The backend servers must be added in the following format:

[{"ServerId":"XXX","Weight":"XXX"},{"ServerId":"XXX","Weight":"XXX"}]

  • ServerId is the ID of the ECS instance.
  • Weight is the weight of the ECS instance in the range of 1-100, the default value is 100. The ECS instance with higher weight receives more requests.

Response parameter

Name Type Description
RequestId String The ID of the request.
LoadBalancerId String The ID of the SLB instance.
BackendServers JSON String The list of the backend servers of the SLB instance, containing the following:
  • ServerId is the ID of the ECS instance.
  • Weight is the weight of the ECS instance in the range of 1-100, the default value is 100. The ECS instance with higher weight receives more requests.

Example

Request example

  1. https://slb.aliyuncs.com/?Action=RemoveBackendServers
  2. &LoadBalancerId=139a00604ad-cn-east-hangzhou-01
  3. &BackendServers=[" vm-233"," vm-234"]
  4. &<CommonParameter>

Response example

  • XML format

    1. <?xml version="1.0" encoding="UTF-8"?>
    2. <RemoveBackendServersResponse>
    3. <RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
    4. <LoadBalancerId>139a00604ad-cn-east-hangzhou-01</LoadBalancerId>
    5. <BackendServers>
    6. <BackendServer>
    7. <ServerId>vm-231</ServerId>
    8. <Weight>100</Weight>
    9. </BackendServer>
    10. <BackendServer>
    11. <ServerId>vm-232</ServerId>
    12. <Weight>100</Weight>
    13. </BackendServer>
    14. </BackendServers>
    15. </RemoveBackendServersResponse>
  • JSON format

    1. {
    2. "RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710",
    3. "LoadBalancerId":"139a00604ad-cn-east-hangzhou-01",
    4. "BackendServers":{
    5. "BackendServer": [
    6. {"ServerId":"vm-231",
    7. "Weight":100},
    8. {"ServerId":"vm-232",
    9. "Weight":100}
    10. ]
    11. }
    12. }
Thank you! We've received your feedback.