You can call the CreateVServerGroup API to create a VServer group.


Click here to perform a debug operation in OpenAPI Explorer and automatically generate an SDK code example.

Request parameters

Name Type Required? Example value Description
Action String Yes CreateVServerGroup

The action to perform. Valid value: CreateVServerGroup

LoadBalancerId String Yes lb-bp1qjwo61pqz3ahltv0mw

The ID of the SLB instance

RegionId String Yes cn-hangzhou

The ID of the region to which the SLB instance belongs

BackendServers String No [{'ServerId':'vm-233','Port':'80','Weight':'100'},{'ServerId':'vm-232','Port':'90','Weight':'100'},{'ServerId':'vm-231','Port':'70','Weight':'100'}]

The list of backend servers to be added.

It is a JSON string with the JsonList structure. For each request, the list can contain up to 20 elements. The structure of each element is shown in the following table.

  • ServerId: the backend server name ID, which is the ECS instance ID. It is a required parameter of string type.
  • Port: the port used by the backend server. It is a required parameter of integer type with valid values of 1–65535.
  • Weight: the weight of the backend server. It is a required parameter of integer type with valid values of 0–100.
VServerGroupName String No Group1

The name of the VServer group

Response parameters

Name Type Example value Description
VServerGroupId String rsp-cige6j5e7p

The ID of the VServer group


A list of backend servers

  └ServerId String vm-231

The ECS instance ID or ENI ID

  └Port Integer 70

The port used by the backend server

  └Weight Integer 100

The weight of the backend server

  └Description String VServer group

A description of the VServer group

  └Type String Type

The backend server type. Valid values:

  • ecs: ECS instance (default)
  • eni: Elastic Network Interface (ENI)
RequestId String 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C

The ID of the request


Request example

http(s)://[Endpoint]/? Action=CreateVServerGroup

Normal response examples

XML format


JSON format


Error codes

Click here to view the error codes.