All Products
Search
Document Center

Server Load Balancer:AddBackendServers

Last Updated:Mar 04, 2026

Tambahkan server backend.

Deskripsi operasi

Catatan

Jika Anda menambahkan beberapa instans ECS identik dalam satu permintaan, sistem hanya memproses instans pertama dan mengabaikan instans identik berikutnya. Anda tidak dapat menambahkan server backend baru yang menduplikasi server yang sudah ada di bawah Pendengar (listener) yang sama karena akan menyebabkan error.

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:AddBackendServers

update

*LoadBalancer

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

*Instance

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

No

ID wilayah tempat instans Server Load Balancer (SLB) berada.

Panggil DescribeRegions untuk menanyakan ID wilayah.

cn-beijing

LoadBalancerId

string

Yes

ID instans Classic Load Balancer (CLB).

lb-2ze7o5h52g02kkzz******

BackendServers

string

No

Daftar server backend yang akan ditambahkan. Parameter ini mencakup parameter berikut:

  • ServerId: Tipe string, wajib diisi. ID instans server backend. Dapat berupa ID instans ECS, ID instans ENI, atau ID instans ECI. Jika parameter ServerId berupa ID instans ENI atau ID instans ECI, parameter Type wajib diisi.

  • Weight: Bobot server backend. Nilai yang valid: 0 hingga 100. Nilai default: 100.

Jika nilainya 0, sistem tidak meneruskan permintaan ke server backend tersebut.

  • Description: Tipe string, opsional. Deskripsi server backend. Deskripsi dapat berisi 1 hingga 80 karakter. Mendukung karakter Tionghoa, huruf, angka, tanda hubung (-), garis miring (/), titik (.), dan garis bawah (_).

  • Type: Jenis server backend. Nilai yang valid:

    • ecs: Instans ECS (default).

    • eni: Instans Elastic Network Interface (ENI).

    • eci: Elastic Container Instance (ECI).

Catatan

Hanya instans dengan performa terjamin yang mendukung penambahan server backend berupa ENI dan ECI.

  • ServerIp: Alamat IP instans ENI atau ECI.

  • Port: Port backend yang menerima permintaan.

Contoh:

  • Menyambungkan instans ECS:

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

  • Menyambungkan ENI:

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

  • Menyambungkan beberapa alamat IP ENI:

[{ "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" }]

  • Menyambungkan ECI:

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

Catatan

Hanya server backend yang sedang Berjalan (running) yang dapat ditambahkan ke instans Server Load Balancer (SLB). Setiap panggilan dapat menambahkan maksimal 20 server backend.

[{ "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

LoadBalancerId

string

ID instans Server Load Balancer (SLB).

lb-2ze7o5h52g02kkzz****

RequestId

string

ID permintaan.

34B82C81-F13B-4EEB-99F6-A048C67CC830

BackendServers

object

BackendServer

array<object>

Daftar server backend.

object

Type

string

Jenis server backend. Nilai yang valid:

  • ecs: Instans ECS (default).

  • eni: Instans Elastic Network Interface (ENI).

  • eci: Elastic Container Instance (ECI).

ecs

Weight

string

Bobot server backend.

Nilai yang valid: 0 hingga 100. Nilai default: 100.

Jika nilainya 0, sistem tidak meneruskan permintaan ke server backend tersebut.

100

Description

string

Deskripsi server backend.

Catatan

Jika Anda tidak mengatur Description, parameter ini tidak dikembalikan.

The description of the backend server.

ServerId

string

ID instans ECS, ENI, atau ECI.

i-2zej4lxhjoq1icu*****

Contoh

Respons sukses

JSONformat

{
  "LoadBalancerId": "lb-2ze7o5h52g02kkzz****",
  "RequestId": "34B82C81-F13B-4EEB-99F6-A048C67CC830",
  "BackendServers": {
    "BackendServer": [
      {
        "Type": "ecs",
        "Weight": "100",
        "Description": "The description of the backend server.",
        "ServerId": "i-2zej4lxhjoq1icu*****"
      }
    ]
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidParameter The specified load balancer does not support the network type of the ECS instance.
400 Mismatched.ZoneId The zone of the server is not matched with the cloud box loadbalancer.
400 BackendServerProcessing Backend Server is adding, please try again later.
400 InvalidBackendServers.ServerIpConflict %s.
400 OperationUnsupported.AddBackendServers This type of backend server is not allowed to attached to singleTunnel or anyTunnel lb.
400 IncorrectStatus.RSByPassToas %s.
400 OperationFailed.ActionNotSupport The loadbalancer does not support such action.
400 NetworkConflict %s.
400 SystemBusy The system is busy.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.