Tüm Ürünler
Search
Belge Merkezi

:UpdateListenerAttribute

Son Güncelleme:Sep 30, 2026

Bir dinleyicinin adı ve varsayılan eylemi gibi yapılandırma özelliklerini günceller.

Operation description

UpdateListenerAttribute eşzamanlı olmayan bir işlemdir. Bir istek kimliği döndürüldükten sonra, dinleyici yapılandırma güncellemesi arka planda işlenmeye devam eder. Dinleyici yapılandırmasının güncelleme durumunu sorgulamak için GetListenerAttribute çağrısı yapabilirsiniz:\n- Dinleyici Configuring durumundaysa, dinleyici yapılandırması güncelleniyor demektir.\n- Dinleyici Running durumundaysa, dinleyici yapılandırması güncellenmiş demektir.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

alb:UpdateListenerAttribute

update

*LoadBalancer

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

*SecurityPolicy

acs:alb:{#regionId}:{#accountId}:securitypolicy/{#securitypolicyId}

*ServerGroup

acs:alb:{#regionId}:{#accountId}:servergroup/{#servergroupId}

None None

Request parameters

Parameter

Type

Required

Description

Example

ListenerId

string

Yes

Uygulama Yük Dengeleme (ALB) örneğinin dinleyici kimliği.

lsn-o4u54y73wq7b******

ClientToken

string

No

İsteğin yinelenmezliğini sağlamak için kullanılan istemci belirteci.\n\nBelirteci oluşturmak için istemciyi kullanabilirsiniz, ancak belirtecin farklı istekler arasında benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir.\n\n> Bu parametreyi belirtmezseniz, sistem otomatik olarak RequestId değerini ClientToken olarak kullanır. RequestId her API isteği için farklı olabilir.

5A2CFF0E-5718-45B5-9D4D-70B******

DryRun

boolean

No

Gerçek istek gerçekleştirilmeden yalnızca deneme çalıştırması yapılıp yapılmayacağını belirtir. Geçerli değerler:\n\n- true: Yalnızca deneme çalıştırması yapılır. Sistem, eksik parametre değerleri, hatalı istek sözdizimi ve hizmet limitleri dahil olmak üzere istekteki olası sorunları kontrol eder. İstek deneme çalıştırmasından geçemezse bir hata kodu döndürülür. İstek deneme çalıştırmasından geçerse DryRunOperation hata kodu döndürülür.\n\n- false (varsayılan): Deneme çalıştırması yapılır ve gerçek istek gerçekleştirilir. İstek deneme çalıştırmasından geçerse bir HTTP 2xx durum kodu döndürülür ve işlem gerçekleştirilir.

false

ListenerDescription

string

No

Özel dinleyici adı.\n\nAd 2 ila 256 karakter uzunluğunda olmalıdır; harf, rakam, Çince karakter, virgül (,), nokta (.), noktalı virgül (;), eğik çizgi (/), @ işareti, alt çizgi (_) ve tire (-) içerebilir.

HTTP_80

RequestTimeout

integer

No

İstek zaman aşımı süresi. Birim: saniye. Geçerli değerler: 1 ile 600.\n\nZaman aşımı süresi içinde arka uç sunucudan yanıt alınamazsa, yük dengeleyici istemciye bir HTTP 504 hata kodu döndürür.

60

IdleTimeout

integer

No

Boşta bağlantı zaman aşımı süresi. Birim: saniye. Geçerli değerler: 1 ile 600.\n\nZaman aşımı süresi içinde herhangi bir erişim isteği alınmazsa, yük dengeleyici mevcut bağlantıyı geçici olarak keser ve bir sonraki istek geldiğinde bağlantıyı geri yükler.

15

GzipEnabled

boolean

No

Belirli dosya türlerini sıkıştırmak için Gzip sıkıştırmasının etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:\n\n- true: etkin.\n- false: devre dışı.

true

Http2Enabled

boolean

No

HTTP/2'nin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:\n- true: etkin.\n- false: devre dışı.\n\n> Bu parametreyi yalnızca HTTPS dinleyicileri destekler.

true

SecurityPolicyId

string

No

Güvenlik politikası. Sistem güvenlik politikaları ve özel güvenlik politikaları desteklenir.\n\n> Bu parametreyi yalnızca HTTPS dinleyicileri destekler.

tls_cipher_policy_1_0

CaEnabled

boolean

No

Karşılıklı kimlik doğrulamanın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:\n- true: etkin.\n- false: devre dışı.

false

XForwardedForConfig

object

No

XForwardedFor özelliğinin yapılandırması.

XForwardedForClientCertClientVerifyAlias

string

No

Özel üst bilgi alanı adı. Bu parametre yalnızca XForwardedForClientCertClientVerifyEnabled değeri true olarak ayarlandığında geçerli olur.\n\nAd 1 ila 40 karakter uzunluğunda olmalıdır; a'dan z'ye küçük harfler, tire (-), alt çizgi (_) ve rakamlar içerebilir.\n\n> Bu parametreyi yalnızca HTTPS dinleyicileri destekler.

test_client-verify-alias_123456

XForwardedForClientCertClientVerifyEnabled

boolean

No

Yük dengeleme örneğine erişen istemci sertifikasının doğrulama sonucunu almak için X-Forwarded-Clientcert-clientverify üst bilgi alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:\n- true: etkin.\n- false: devre dışı.\n\n> Bu parametreyi yalnızca HTTPS dinleyicileri destekler.

false

XForwardedForClientCertFingerprintAlias

string

No

Özel üst bilgi alanı adı. Bu parametre yalnızca XForwardedForClientCertFingerprintEnabled değeri true olarak ayarlandığında geçerli olur.\n\nAd 1 ila 40 karakter uzunluğunda olmalıdır; a'dan z'ye küçük harfler, tire (-), alt çizgi (_) ve rakamlar içerebilir.\n\n> Bu parametreyi yalnızca HTTPS dinleyicileri destekler.

test_finger-print-alias_123456

XForwardedForClientCertFingerprintEnabled

boolean

No

Yük dengeleme örneğine erişen istemci sertifikasının parmak izini almak için X-Forwarded-Clientcert-fingerprint üst bilgi alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:\n- true: etkin.\n- false: devre dışı.\n\n> Bu parametreyi yalnızca HTTPS dinleyicileri destekler.

false

XForwardedForClientCertIssuerDNAlias

string

No

Özel üst bilgi alanı adı. Bu parametre yalnızca XForwardedForClientCertIssuerDNEnabled değeri true olarak ayarlandığında geçerli olur.\n\nAd 1 ila 40 karakter uzunluğunda olmalıdır; a'dan z'ye küçük harfler, tire (-), alt çizgi (_) ve rakamlar içerebilir.\n\n> Bu parametreyi yalnızca HTTPS dinleyicileri destekler.

test_issue-dn-alias_123456

XForwardedForClientCertIssuerDNEnabled

boolean

No

Yük dengeleme örneğine erişen istemci sertifikasının veren bilgilerini almak için X-Forwarded-Clientcert-issuerdn üst bilgi alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:\n- true: etkin.\n- false: devre dışı.\n\n> Bu parametreyi yalnızca HTTPS dinleyicileri destekler.

false

XForwardedForClientCertSubjectDNAlias

string

No

Özel üst bilgi alanı adı. Bu parametre yalnızca XForwardedForClientCertSubjectDNEnabled değeri true olarak ayarlandığında geçerli olur.\n\nAd 1 ila 40 karakter uzunluğunda olmalıdır; a'dan z'ye küçük harfler, tire (-), alt çizgi (_) ve rakamlar içerebilir.\n\n> Bu parametreyi yalnızca HTTPS dinleyicileri destekler.

test_subject-dn-alias_123456

XForwardedForClientCertSubjectDNEnabled

boolean

No

Yük dengeleme örneğine erişen istemci sertifikasının sahip bilgilerini almak için X-Forwarded-Clientcert-subjectdn üst bilgi alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:\n- true: etkin.\n- false: devre dışı.\n\n> Bu parametreyi yalnızca HTTPS dinleyicileri destekler.

false

XForwardedForClientSrcPortEnabled

boolean

No

Yük dengeleme örneğine erişen istemcinin bağlantı noktasını almak için X-Forwarded-Client-srcport üst bilgi alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:\n- true: etkin.\n- false: devre dışı.\n\n> Bu parametreyi HTTP ve HTTPS dinleyicileri destekler.

false

XForwardedForEnabled

boolean

No

İstemcinin gerçek IP adresını almak için X-Forwarded-For üst bilgi alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:\n- true (varsayılan): etkin.\n- false: devre dışı.\n\n> 1. Bu parametreyi true olarak ayarlarsanız, XForwardedForProcessingMode varsayılan olarak append olur ve remove olarak değiştirilebilir.\n> 2. Bu parametreyi false olarak ayarlarsanız, istek arka uç sunucuya gönderilmeden önce X-Forwarded-For üst bilgi alanı ek bir işlem yapılmadan korunur.\n> 3. Bu parametreyi HTTP ve HTTPS dinleyicileri destekler.

true

XForwardedForProcessingMode

string

No

X-Forwarded-For üst bilgi alanı için işleme modu. Bu parametre yalnızca XForwardedForEnabled değeri true olarak ayarlandığında geçerli olur. Geçerli değerler:\n- append (varsayılan): ekle.\n- remove: kaldır.\n\n> 1. Bu parametreyi append olarak ayarlarsanız, istek arka uç sunucuya gönderilmeden önce son atlama IP adresı X-Forwarded-For üst bilgi alanına eklenir.\n> 2. Bu parametreyi remove olarak ayarlarsanız, isteğin X-Forwarded-For üst bilgi alanını içerip içermediğine bakılmaksızın, istek arka uç sunucuya gönderilmeden önce X-Forwarded-For üst bilgisi kaldırılır.\n> 3. Bu parametreyi HTTP ve HTTPS dinleyicileri destekler.

append

XForwardedForProtoEnabled

boolean

No

Yük dengeleme örneğinin dinleyici protokolünü almak için X-Forwarded-Proto üst bilgi alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:\n- true: etkin.\n- false: devre dışı.\n\n> Bu parametreyi HTTP, HTTPS ve QUIC dinleyicileri destekler.

false

XForwardedForSLBIdEnabled

boolean

No

Yük dengeleme örnek kimliğini almak için SLB-ID üst bilgi alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:\n- true: etkin.\n- false: devre dışı.\n\n> Bu parametreyi HTTP, HTTPS ve QUIC dinleyicileri destekler.

false

XForwardedForSLBPortEnabled

boolean

No

Yük dengeleme örneğinin dinleyici bağlantı noktasını almak için X-Forwarded-Port üst bilgi alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:\n- true: etkin.\n- false: devre dışı.\n\n> Bu parametreyi HTTP, HTTPS ve QUIC dinleyicileri destekler.

false

XForwardedForClientSourceIpsEnabled

boolean

No

ALB'nin gerçek istemci IP adresını X-Forwarded-For üst bilgi alanından almasına izin verilip verilmeyeceğini belirtir. Geçerli değerler:\n\n- true: etkin.\n- false: devre dışı.\n\n> Bu parametreyi HTTP ve HTTPS dinleyicileri destekler.

false

XForwardedForClientSourceIpsTrusted

string

No

Güvenilen proxy IP adresları.\n\nUygulama Yük Dengeleme (ALB), X-Forwarded-For üst bilgi alanını sağdan sola doğru tarar ve güvenilen IP listesinde olmayan ilk IP adresını gerçek istemci IP adresı olarak seçer. Bu IP adresı, kaynak IP tabanlı hız sınırlaması için kullanılır.

10.1.1.0/24

XForwardedForHostEnabled

boolean

No

Yük dengeleme örneğine erişen istemcinin etki alanı adını almak için X-Forwarded-Host üst bilgi alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:\n- true: etkin.\n- false (varsayılan): devre dışı.\n\n> Bu parametreyi HTTP, HTTPS ve QUIC dinleyicileri destekler.

false

QuicConfig

object

No

İlişkili bir QUIC dinleyicisi etkinleştirildiğindeki yapılandırma bilgileri.

QuicListenerId

string

No

İlişkilendirilecek QUIC dinleyicisinin kimliği. Bu parametre, QuicUpgradeEnabled değeri true olarak ayarlandığında gereklidir. Bu parametre yalnızca HTTPS dinleyicileri için geçerlidir.\n\n> Orijinal dinleyici ve ilişkili QUIC dinleyicisi aynı ALB örneğine ait olmalı ve QUIC dinleyicisi daha önce ilişkilendirilmemiş olmalıdır.

lsn-333

QuicUpgradeEnabled

boolean

No

QUIC yükseltmesinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:\n- true: etkin.\n- false: devre dışı.\n\n> Bu parametre yalnızca HTTPS dinleyicileri için geçerlidir.

false

Certificates

array<object>

No

Sertifika listesi.

object

No

Sertifika yapısı.

CertificateId

string

No

Varsayılan sertifika kimliği. Yalnızca bir varsayılan sunucu sertifikası desteklenir.\n\n> - Bu parametre, dinleyici protokolü türü HTTPS veya QUIC olduğunda gereklidir.\n> - Daha fazla sunucu sertifikası eklemek için, dinleyici oluşturulduktan sonra uzantı sertifikalarını yapılandırmak üzere AssociateAdditionalCertificatesWithListener çağrısı yapın.

123157******

CaCertificates

array<object>

No

CA sertifikası listesi. Yalnızca bir CA sertifikası desteklenir.

object

No

CA sertifikası yapısı.

CertificateId

string

No

CA sertifikası kimliği.\n\n> Bu parametre, CaEnabled değeri true olarak ayarlandığında gereklidir.

123359******

DefaultActions

array<object>

No

Varsayılan kural eylemlerinin listesi.

array<object>

No

Varsayılan kural eylemi yapısı.

ForwardGroupConfig

object

No

Eylem için yönlendirme yapılandırması. Bu parametre yalnızca Type değeri ForwardGroup olarak ayarlandığında gereklidir ve geçerlidir. En fazla 20 yönlendirme eylemi yapılandırması ekleyebilirsiniz.

ServerGroupTuples

array<object>

Yes

Yönlendirme hedefi sunucu grubu demetlerinin listesi.

object

No

Yönlendirme hedefi sunucu grubu demeti yapısı.

ServerGroupId

string

Yes

İsteklerin yönlendirildiği hedef sunucu grubunun kimliği.

sgp-i5qt20******

Type

string

Yes

Eylem türü. En fazla bir eylem türü ekleyebilirsiniz.

Geçerli değerler: İsteklerin birden fazla sunucu grubuna yönlendirildiğini belirten ForwardGroup.

ForwardGroup

Response elements

Element

Type

Description

Example

object

Yanıt yapısı.

JobId

string

Eşzamansız görev kimliği.

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

RequestId

string

İstek kimliği.

365F4154-92F6-4AE4-92F8-7FF******

Examples

Success response

JSON format

{
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF******"
}

Error codes

HTTP status code

Error code

Error message

Description

400 IncorrectStatus.LoadBalancer The status of %s [%s] is incorrect.
400 IncorrectBusinessStatus.LoadBalancer The business status of %s [%s]  is incorrect.
400 IncorrectStatus.Listener The status of %s [%s] is incorrect.
400 OperationDenied.CrossLoadBalancerQUICListener The operation is not allowed because of %s.
400 ResourceAlreadyAssociated.Listener The specified resource %s is already associated.
400 OperationDenied.GRPCServerGroup The operation is not allowed because of %s.
400 ResourceAlreadyAssociated.Certificate The specified resource %s is already associated.
400 ResourceQuotaExceeded.SecurityPolicyAttachedNum The quota of %s is exceeded for resource %s, usage %s/%s.
400 ResourceQuotaExceeded.ServerGroupAttachedNum The quota of %s is exceeded for resource %s, usage %s/%s.
400 ResourceQuotaExceeded.LoadBalancerServersNum The quota of %s is exceeded for resource %s, usage %s/%s.
400 ResourceQuotaExceeded.ServerAddedNum The quota of %s is exceeded for resource %s, usage %s/%s.
400 OperationDenied.ServerGroupProtocolNotSupport The operation is not allowed because of ServerGroupProtocolNotSupport.
400 UnsupportedFeature.FullTraceHttps The feature of FullTraceHttps is not supported for current instance.
400 ResourceInConfiguring.Listener The specified resource of %s is being configured, please try again later.
400 Mismatch.VpcId The %s is mismatched for %s and %s.
400 InvalidParameter Invalid parameter, please check the parameter input.
400 OperationDenied.CACertificateCorrupted The CA certificate is corrupted.
403 Forbidden.LoadBalancer Authentication is failed for %s.
404 ResourceNotFound.Listener The specified resource %s is not found.
404 ResourceNotFound.ServerGroup The specified resource %s is not found.
404 ResourceNotFound.SecurityPolicy The specified resource %s is not found.
404 ResourceNotFound.Certificate The specified resource %s is not found.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.