全部产品
Search

搜索本产品

    Server Load Balancer：CreateServerGroup

    文档中心

    Server Load Balancer：CreateServerGroup

    更新时间：Jan 16, 2026

    Membuat grup server di wilayah yang ditentukan.

    Deskripsi operasi

    Operasi CreateServerGroup bersifat asinkron. Setelah mengirim permintaan, sistem akan mengembalikan ID permintaan. Grup server untuk instans Network Load Balancer (NLB) dibuat di latar belakang. Anda dapat memanggil operasi GetJobStatus untuk mengecek status pembuatan grup server:

    • Jika status tugas adalah Succeeded, grup server telah berhasil dibuat.

    • Jika status tugas adalah Processing, grup server sedang dalam proses pembuatan. Pada kondisi ini, Anda hanya dapat melakukan operasi kueri.

    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

    nlb:CreateServerGroup

    create

    *ServerGroup

    acs:nlb:{#regionId}:{#accountId}:servergroup/*

    *VPC

    acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ServerGroupType

    string

    No

    Tipe grup server. Nilai yang valid:

    • Instance (default): grup server bertipe instans. Tipe grup server ini memungkinkan Anda menambahkan instans Elastic Compute Service (ECS), elastic network interfaces (ENIs), dan elastic container instances (ECIs).

    • Ip: grup server bertipe alamat IP. Tipe grup server ini memungkinkan Anda menambahkan server backend dengan menentukan alamat IP-nya.

    Instance
    ServerGroupName

    string

    Yes

    Nama grup server.

    Nama harus terdiri dari 2 hingga 128 karakter dan dimulai dengan huruf. Nama dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-).

    NLB_ServerGroup
    AddressIPVersion

    string

    No

    Versi IP. Nilai yang valid:

    • ipv4 (default): IPv4.

    • DualStack: dual-stack.

    ipv4
    Protocol

    string

    No

    Kebijakan penjadwalan trafik untuk mode dual-stack. Nilai yang valid:

    • NonAffinity (default): Permintaan diteruskan ke server backend yang sehat berdasarkan algoritma penjadwalan, tanpa mempertimbangkan versi IP sumber.

    • Affinity: Permintaan diteruskan berdasarkan versi IP sumber. Permintaan IPv4 hanya diteruskan ke server backend IPv4. Permintaan IPv6 hanya diteruskan ke server backend IPv6.

    Catatan

    Parameter ini hanya berlaku ketika AddressIPVersion diatur ke DualStack.

    TCP
    VpcId

    string

    Yes

    Protokol untuk meneruskan permintaan ke server backend. Nilai yang valid:

    • TCP (Default)

    • UDP

    • TCP_UDP

    Catatan

    • Jika parameter ini diatur ke UDP, grup server hanya mendukung listener UDP.

    • Jika parameter ini diatur ke TCP dan PreserveClientIpEnabled diatur ke true, grup server hanya mendukung listener TCP.

    • Jika parameter ini diatur ke TCP dan PreserveClientIpEnabled diatur ke false, grup server mendukung listener TCPSSL dan TCP.

    • Jika parameter ini diatur ke TCP_UDP, grup server mendukung listener TCP dan UDP.

    vpc-bp15zckdt37pq72zv****
    AnyPortEnabled

    boolean

    No

    ID VPC tempat grup server berada.

    Catatan

    Jika ServerGroupType diatur ke Instance, hanya server dalam VPC ini yang dapat ditambahkan ke grup server.

    false
    ConnectionDrainEnabled

    boolean

    No

    Menentukan apakah penerusan port semua diaktifkan. Nilai yang valid:

    • true

    • false (default)

    false
    ConnectionDrainTimeout

    integer

    No

    Menentukan apakah pengurasan koneksi diaktifkan. Nilai yang valid:

    • true: Diaktifkan.

    • false (default): Dinonaktifkan.

    10
    Scheduler

    string

    No

    Waktu timeout pengurasan koneksi, dalam satuan detik. Nilai harus berkisar antara 0 hingga 900.

    Wrr
    PreserveClientIpEnabled

    boolean

    No

    Algoritma penjadwalan. Nilai yang valid:

    • Wrr (default): Round-robin berbobot. Server backend dengan bobot lebih tinggi menerima lebih banyak permintaan.

    • Wlc: jumlah koneksi paling sedikit dengan bobot. Algoritma ini mempertimbangkan bobot dan jumlah koneksi aktif pada setiap server backend. Jika bobot server sama, server dengan koneksi paling sedikit akan menerima permintaan berikutnya.

    • rr: round-robin. Permintaan didistribusikan ke server backend secara bergiliran.

    • sch: hash IP sumber. Permintaan dari alamat IP sumber yang sama diarahkan ke server backend yang sama.

    • tch: hash empat-tupel. Ini adalah hash konsisten berdasarkan empat-tupel (alamat IP sumber, alamat IP tujuan, port sumber, dan port tujuan). Permintaan dalam aliran yang sama diarahkan ke server backend yang sama.

    • qch: hash ID QUIC. Permintaan dengan ID QUIC yang sama di-hash ke server backend yang sama.

    Catatan

    Hash ID QUIC hanya didukung ketika protokol backend adalah UDP.

    true
    HealthCheckConfig

    object

    No

    Menentukan apakah persistensi IP klien diaktifkan. Nilai yang valid:

    • true (default): Diaktifkan.

    • false: Dinonaktifkan.

    Catatan

    Jika Protocol diatur ke TCP dan parameter ini diatur ke true, grup server tidak dapat dikaitkan dengan listener TCPSSL.

    HealthCheckEnabled

    boolean

    No

    Menentukan apakah pemeriksaan kesehatan diaktifkan. Nilai yang valid: true (default) false

    true
    HealthCheckType

    string

    No

    Protokol pemeriksaan kesehatan. Nilai yang valid: TCP HTTP UDP

    TCP
    HealthCheckConnectPort

    integer

    No

    Port yang digunakan untuk pemeriksaan kesehatan pada server backend. Nilai yang valid: 0 hingga 65535. Nilai default: 0. Nilai 0 berarti port server backend digunakan untuk pemeriksaan kesehatan.

    0
    HealthyThreshold

    integer

    No

    Jumlah pemeriksaan kesehatan berturut-turut yang berhasil diperlukan untuk mengubah status kesehatan server backend dari gagal menjadi berhasil. Nilai yang valid: 2 hingga 10. Nilai default: 2.

    2
    UnhealthyThreshold

    integer

    No

    Jumlah pemeriksaan kesehatan berturut-turut yang gagal diperlukan untuk mengubah status pemeriksaan kesehatan server backend dari berhasil menjadi gagal. Nilai yang valid: 2 hingga 10. Nilai default: 2.

    2
    HealthCheckConnectTimeout

    integer

    No

    Waktu timeout maksimum respons pemeriksaan kesehatan. Satuan: detik. Nilai yang valid: 1 hingga 300. Nilai default: 5.

    5
    HealthCheckInterval

    integer

    No

    Interval antara dua pemeriksaan kesehatan berturut-turut. Satuan: detik. Nilai default: 5. Jika HealthCheckType diatur ke TCP atau HTTP, nilai harus berada dalam rentang 1 hingga 50. Jika HealthCheckType diatur ke UDP, nilai harus berada dalam rentang 1 hingga 300. Atur interval ke nilai yang lebih besar dari atau sama dengan periode timeout respons. Hal ini mencegah probe UDP ditandai sebagai timeout.

    5
    HealthCheckDomain

    string

    No

    Nama domain yang digunakan untuk pemeriksaan kesehatan. Nilai yang valid: $SERVER_IP: alamat IP pribadi server backend. domain: nama domain tertentu. Nama domain harus terdiri dari 1 hingga 80 karakter, dan dapat berisi huruf, angka, tanda hubung (-), dan titik (.). Parameter ini hanya berlaku ketika HealthCheckType diatur ke HTTP.

    $SERVER_IP
    HealthCheckUrl

    string

    No

    Path yang digunakan untuk pemeriksaan kesehatan. Path harus terdiri dari 1 hingga 80 karakter. Path dapat berisi huruf, angka, dan karakter khusus berikut: -/.%?#&. Path harus dimulai dengan garis miring (/). Parameter ini hanya berlaku ketika HealthCheckType diatur ke HTTP.

    /test/index.html
    HealthCheckHttpCode

    array

    No

    Kode status HTTP yang menunjukkan server backend dalam kondisi sehat. Pisahkan beberapa kode status HTTP dengan koma (,). Nilai yang valid: http_2xx (default), http_3xx, http_4xx, dan http_5xx. Parameter ini hanya berlaku ketika HealthCheckType diatur ke HTTP.

    string

    No

    Kode status HTTP yang menunjukkan server backend dalam kondisi sehat. Pisahkan beberapa kode status HTTP dengan koma (,). Nilai yang valid: http_2xx (default), http_3xx, http_4xx, dan http_5xx. Parameter ini hanya berlaku ketika HealthCheckType diatur ke HTTP.

    http_2xx
    HttpCheckMethod

    string

    No

    Metode HTTP yang digunakan untuk pemeriksaan kesehatan. Nilai yang valid: GET (default) dan HEAD. Parameter ini hanya berlaku ketika HealthCheckType diatur ke HTTP.

    GET
    HealthCheckReq

    string

    No

    String permintaan untuk pemeriksaan kesehatan UDP. String hanya boleh berisi huruf dan angka. Panjang maksimum adalah 512 karakter.

    hello
    HealthCheckExp

    string

    No

    String respons yang diharapkan untuk pemeriksaan kesehatan UDP. String harus berupa alfanumerik dan memiliki panjang maksimum 512 karakter.

    ok
    HealthCheckHttpVersion

    string

    No

    Versi protokol HTTP. Nilai yang valid: HTTP1.0 (default) dan HTTP1.1. Parameter ini hanya berlaku ketika HealthCheckType diatur ke HTTP.

    HTTP1.0
    ResourceGroupId

    string

    No

    Konfigurasi pemeriksaan kesehatan.

    rg-atstuj3rtop****
    DryRun

    boolean

    No

    ID kelompok sumber daya tempat grup server tersebut berada.

    true
    ClientToken

    string

    No

    Menentukan apakah akan melakukan dry run. Nilai yang valid:

    • true: Mengirim permintaan pemeriksaan tanpa membuat grup server. Sistem memeriksa parameter yang diperlukan, format permintaan, dan batas layanan. Jika permintaan gagal dalam pemeriksaan, sistem mengembalikan kesalahan. Jika permintaan lolos pemeriksaan, sistem mengembalikan kode kesalahan DryRunOperation.

    • false (Default): Mengirim permintaan normal. Jika permintaan lolos pemeriksaan, sistem mengembalikan kode status HTTP 2xx dan membuat grup server.

    123e4567-e89b-12d3-a456-426655440000
    RegionId

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Buat nilai dari klien Anda. Pastikan nilai tersebut unik untuk setiap permintaan. Parameter ClientToken hanya mendukung karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId bersifat unik untuk setiap permintaan API.

    cn-hangzhou
    Tag

    array<object>

    No

    ID wilayah tempat instans Network Load Balancer (NLB) ditempatkan.

    Panggil operasi DescribeRegions untuk mendapatkan ID wilayah.

    object

    No

    Tag.

    Key

    string

    No

    Kunci tag. Kunci dapat terdiri dari maksimal 64 karakter. Kunci tidak boleh diawali dengan aliyun atau acs:. Kunci tidak boleh mengandung http:// atau https://. Kunci dapat berisi huruf, angka, garis bawah (_), titik (.), titik dua (:), garis miring (/), tanda sama dengan (=), tanda plus (+), tanda hubung (-), dan tanda at (@). Tambahkan maksimal 20 tag dalam satu panggilan.

    env
    Value

    string

    No

    Nilai tag. Nilai dapat terdiri dari maksimal 128 karakter. Nilai tidak boleh diawali dengan `aliyun` atau `acs:`. Nilai tidak boleh mengandung `http://` atau `https://`. Nilai dapat berisi huruf, angka, garis bawah (_), titik (.), titik dua (:), garis miring (/), tanda sama dengan (=), tanda plus (+), tanda hubung (-), dan tanda at (@). Satu panggilan dapat berisi maksimal 20 tag.

    product
    IpVersionAffinityMode

    string

    No

    Tag.

    Affinity

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Grup server telah dibuat.

    RequestId

    string

    ID permintaan.

    54B48E3D-DF70-471B-AA93-08E683A1B45
    ServerGroupId

    string

    ID grup server.

    sgp-atstuj3rtoptyui****
    JobId

    string

    ID tugas asinkron.

    72dcd26b-f12d-4c27-b3af-18f6aed5****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "ServerGroupId": "sgp-atstuj3rtoptyui****",
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 IllegalParam.AnyPortServerGroupConflictWithHealthCheckConfig The param of AnyPortServerGroupConflictWithHealthCheckConfig is illegal.
    400 IllegalParamFormat.ParseCreateRsPoolRequestFailed The param format of CreateRsPoolRequest is illegal.
    400 IllegalParam.PreserveClientIpSwitch The param of PreserveClientIpSwitch is illegal.
    400 OperationDenied.VpcNotSupportIpv6 The operation is not allowed because of VpcNotSupportIpv6.
    400 IllegalParam.healthCheckDomain The parameter of healthCheckConfig.healthCheckDomain is illegal.
    400 OperationDenied.UidNotAllowQuic29 The operation is not allowed because of uid not allow quic29 version.
    400 IlleagalParam.healthCheckUrl The parameter of healthCheckUrl in healthCheckConfig is illegal.
    400 IllegalParam.ServerGroupName The param of ServerGroupName is illegal.
    400 DryRunOperation Request validation has been passed with DryRun flag set.
    400 MissingParam.%s The parameter of %s is missing.
    400 IllegalParam.ConnectionDrainTimeout The param of ConnectionDrainTimeout is illegal.
    400 IllegalParam The param of %s is illegal.
    400 SystemBusy System is busy, please try again later.
    400 QuotaExceeded.QuotaInsufficient The quota of %s is exceeded, usage %s/%s.
    403 Forbidden.NoPermission Authentication is failed for NoPermission.
    404 ResourceNotFound.Vpc The specified resource of Vpc is not found.
    404 ResourceNotFound.ResourceGroup The param of resourceGroup not existed.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.