All Products
Search
Document Center

Server Load Balancer:AssociateAclsWithListener

Last Updated:Jun 10, 2026

Mengaitkan daftar kontrol akses (ACL) dengan pendengar.

Deskripsi operasi

DeleteDhcpOptionsSet is an asynchronous operation. After a request is sent, the system returns a request ID and runs the task in the background. You can call the ListAclRelations operation to query the status of the task.

  • If an ACL is in the Associating state, the ACL is being associated with a listener.

  • If an ACL is in the Associated state, the ACL is associated with a listener.

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

alb:AssociateAclsWithListener

create

*Acl

acs:alb:{#regionId}:{#accountId}:acl/{#aclId}

*LoadBalancer

acs:alb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

AclIds

array

Yes

ID ACL. Anda dapat menentukan hingga tiga ID dalam setiap panggilan.

string

No

The ID of the ACL.

nacl-hp34s2h0xx1ht4nwo****

ListenerId

string

Yes

ID pendengar.

lsr-bp1bpn0kn908w4nbw****

AclType

string

Yes

Tipe ACL. Nilai valid:

  • White: daftar putih. Hanya permintaan dari alamat IP atau blok CIDR dalam ACL yang diteruskan. Daftar putih berlaku untuk skenario di mana Anda hanya ingin mengizinkan alamat IP tertentu mengakses aplikasi. Layanan Anda dapat terpengaruh secara negatif jika daftar putih tidak dikonfigurasi dengan benar. Jika daftar putih dikonfigurasi untuk pendengar, hanya permintaan dari alamat IP yang ditambahkan ke daftar putih yang diteruskan oleh pendengar. Jika Anda mengaktifkan daftar putih tetapi tidak menambahkan alamat IP ke daftar putih, pendengar akan meneruskan semua permintaan.

  • Black: blacklist. Semua permintaan dari alamat IP atau blok CIDR dalam ACL diblokir. Blacklist berlaku untuk skenario di mana Anda ingin memblokir akses dari alamat IP tertentu ke aplikasi. Jika blacklist dikonfigurasi untuk pendengar tetapi tidak ada alamat IP yang ditambahkan ke blacklist, pendengar akan meneruskan semua permintaan.

White

DryRun

boolean

No

Apakah akan menjalankan dry run saja, tanpa menjalankan permintaan aktual. Nilai valid:

  • true: Hanya menjalankan dry run. Sistem memeriksa permintaan untuk potensi masalah, termasuk nilai parameter yang hilang, sintaks permintaan yang salah, dan batas layanan. Jika permintaan gagal dalam dry run, Paket kesalahan dikembalikan. Jika permintaan berhasil dalam dry run, kode kesalahan DryRunOperation dikembalikan.

  • false (default): Menjalankan dry run dan menjalankan permintaan aktual. Jika permintaan berhasil dalam dry run, kode status HTTP 2xx dikembalikan dan operasi dijalankan.

true

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII.

Catatan

Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan ID permintaan sebagai token klien. ID permintaan mungkin berbeda untuk setiap permintaan.

5A2CFF0E-5718-45B5-9D4D-70B3FF3898

Elemen respons

Element

Type

Description

Example

object

The operation to associate ACLs with a listener.

JobId

string

The synchronous task ID.

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

RequestId

string

The request ID.

CEF72CEB-54B6-4AE8-B225-F876FF7BA984

Contoh

Respons sukses

JSONformat

{
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 QuotaExceeded.AclsNum The quota of %s is exceeded, usage %s/%s. The quota of %s is exceeded, usage %s/%s.
400 IncorrectStatus.Acl The status of %s [%s] is incorrect.
400 ResourceQuotaExceeded.ListenerAclEntriesNum The quota of %s is exceeded for resource %s, usage %s/%s. The quota of %s is exceeded for resource %s, usage %s/%s.
400 OperationDenied.AclNotSupport The operation is not allowed because of %s.
400 ResourceAlreadyExist.AclEntry The specified resource %s already exists.
400 ResourceInUse.Acl The specified resource %s is in use. The specified resource %s is in use.
400 OperationDenied.LoadBalancerJoinedSecurityGroupNotSupportAcl The operation is not allowed because of loadbalancer joined security group not support acl. The operation is not supported because SLB instances in security groups cannot be added to ACLs.
404 ResourceNotFound.Acl The specified resource %s is not found.
404 ResourceNotFound.Listener The specified resource %s is not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.