All Products
Search
Document Center

Server Load Balancer:AddVServerGroupBackendServers

Last Updated:Jun 10, 2026

Menambahkan server backend ke grup vServer.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

slb:AddVServerGroupBackendServers

create

Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#InstanceId}

*LoadBalancer

acs:slb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID region dari instans Server Load Balancer (SLB).

cn-hangzhou

VServerGroupId

string

Yes

ID grup vServer.

rsp-cige6******

BackendServers

string

Yes

Server backend yang ingin Anda tambahkan. Konfigurasi parameter berikut:

  • ServerId: Wajib. ID server backend. Tentukan ID dalam bentuk string. Anda dapat menentukan ID instans Elastic Compute Service (ECS), elastic network interface (ENI), dan instans elastic container. Jika Anda mengatur ServerId ke ID ENI atau instans elastic container, Anda harus mengonfigurasi parameter Type.

  • Weight: bobot server backend. Nilai yang valid: 0 hingga 100. Nilai default: 100. Jika Anda mengatur bobot server backend ke 0, tidak ada permintaan yang diteruskan ke server backend tersebut.

  • Description: Opsional. Deskripsi server backend. Tentukan deskripsi dalam bentuk string. Deskripsi harus memiliki panjang 1 hingga 80 karakter, dan dapat berisi huruf, angka, tanda hubung (-), garis miring (/), titik (.), dan garis bawah (_).

  • Type: jenis server backend. Nilai yang valid:

    • ecs (default): instans ECS

    • eni: ENI

    • eci: instans elastic container

Catatan

Anda hanya dapat menentukan ENI dan instans elastic container sebagai server backend untuk instans SLB performa tinggi.

  • ServerIp: alamat IP dari ENI atau instans elastic container.

  • Port: port backend.

Contoh:

  • Tambahkan instans ECS:

    [{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]

  • Tambahkan ENI:

    [{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" }]

  • Tambahkan ENI dengan beberapa alamat IP:

    [{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-113" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]

  • Tambahkan instans elastic container:

    [{ "ServerId": "eci-xxxxxxxxx", "Weight": "100", "Type": "eci", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-114" }]

Catatan

Anda hanya dapat menambahkan server backend yang sedang berjalan ke instans SLB. Anda dapat menentukan maksimal 20 server backend dalam setiap panggilan.

[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]

Elemen respons

Element

Type

Description

Example

object

VServerGroupId

string

ID grup vServer.

rsp-cige6j******

RequestId

string

ID permintaan.

9DEC9C28-AB05-4DDF-9A78-6B******

BackendServers

object

BackendServer

array<object>

Server backend.

object

Type

string

The type of backend server. Valid values:

  • ecs (default): ECS instance

  • eni: ENI

  • eci: elastic container instance

eni

Weight

integer

The weight of the backend server.

100

Description

string

The description of the vServer group.

The description of the vServer group.

Port

integer

The port that is used by the backend server.

70

ServerId

string

The ID of the ECS instance or ENI.

eni-hhshhs****

Contoh

Respons sukses

JSONformat

{
  "VServerGroupId": "rsp-cige6j******",
  "RequestId": "9DEC9C28-AB05-4DDF-9A78-6B******",
  "BackendServers": {
    "BackendServer": [
      {
        "Type": "eni",
        "Weight": 100,
        "Description": "The description of the vServer group.",
        "Port": 70,
        "ServerId": "eni-hhshhs****"
      }
    ]
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidBackendServers.ServerIpConflict %s.
400 Mismatched.ZoneId The zone of the server is not matched with the cloud box loadbalancer.
400 OperationUnsupported.AddVServerGroupBackendServers This type of backend server is not allowed to attached to singleTunnel or anyTunnel lb.
400 IncorrectStatus.RSByPassToas %s.
400 BackendServer.InvalidType The specified Type is invalid.
400 BackendServer.ServerRegionIdNotEqual The specified ServerRegionId must be equal.
400 OperationFailed.InvalidCen The cen related with this loadbalancer is invalid.
400 IncorrectStatus.CenNotAssociated The action is invalid because the loadbalancer is not associated with cen.
400 InvalidBackendServers.MissingCenBandWidth The bandwidth is missing between loadbalancer and backendServers in cen.
400 InvalidBackendServers.VpcNotInCen The BackendServers is not in the cen associated with the loadbalancer.
400 InvalidServerId.NotExist The specified ServerId is not exist.
400 MissingParameter.ServerRegionId The parameter ServerRegionId is required.
400 MissingParameter.VbrId The parameter VbrId is required.
400 InvalidParameter.ServerRegionId The parameter ServerRegionId is invalid for crossborder.
400 InvalidVbrId.NotInCen The VbrId is not in the cen associated with the loadbalancer.
400 InvalidParameter.ZoneNotSupport The zone does not support the parameter %s.
400 MasterSlaveServerConflict The servers are conflict for MasterSlaveGroup.
400 OperationFailed.ServiceGroupProcessing The specified service group is processing.
400 NetworkConflict %s.
400 SystemBusy The system is busy.
400 SignatureNonceUsed Specified signature nonce was used already.
400 VpcSystemBusy Invoke vpc system busy, please retry later.
400 OperationDeny.LbNotSupportIPv6Server The specified loadbalancer does not support ipv6 server.
400 OperationBusy The operation is busy.
404 ResourceNotFound.vServers The specified enis %s does not exist.
404 ResourceNotFound.Cen The specified resource Cen %s not Exists.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.