Bir dinleyicinin ayrıntılarını sorgular.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
alb:GetListenerAttribute |
get |
*LoadBalancer.
|
|
None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| ListenerId |
string |
Yes |
Dinleyici kimliği. |
lsn-o4u54y73wq7b****** |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Dinleyici hakkındaki ayrıntılı bilgiler. |
||
| AclConfig |
object |
ACL yapılandırma yapısı. |
|
| AclRelations |
array<object> |
Dinleyici ile ilişkilendirilmiş erişim kontrolü politikalarının kimlikleri. |
|
|
object |
Dinleyici ile ilişkilendirilmiş erişim kontrolü politikalarının yapısı. |
||
| AclId |
string |
Dinleyici ile ilişkilendirilmiş erişim kontrolü politikasının kimliği. |
acl-doc**** |
| Status |
string |
ACL ile dinleyici arasındaki ilişkilendirme durumu. Geçerli değerler:
|
Associating |
| AclType |
string |
Erişim kontrolü türü. Geçerli değerler:
|
White |
| CaCertificates |
array<object> |
CA sertifikalarının listesi. |
|
|
object |
|||
| CertificateId |
string |
CA sertifikasının kimliği. |
139a00***** |
| IsDefault |
boolean |
Sertifikanın varsayılan sertifika olup olmadığını belirtir. Geçerli değerler:
|
true |
| Status |
string |
Sertifikanın durumu. |
Associated |
| CaEnabled |
boolean |
Karşılıklı kimlik doğrulamanın etkin olup olmadığını belirtir. Geçerli değerler:
|
false |
| Certificates |
array<object> |
Sertifikaların listesi. |
|
|
object |
Sertifika yapısı. |
||
| CertificateId |
string |
Sertifikanın kimliği. Yalnızca sunucu sertifikaları desteklenir. |
123157******* |
| DefaultActions |
array<object> |
Varsayılan kural eylemlerinin listesi. |
|
|
array<object> |
Varsayılan kural eyleminin yapısı. |
||
| ForwardGroupConfig |
object |
İletme eyleminin yapılandırması. Bu parametre yalnızca eylem türü ForwardGroup olduğunda geçerli olur. |
|
| ServerGroupTuples |
array<object> |
İletim için hedef sunucu grupları. |
|
|
object |
İletim için hedef sunucu grupları. |
||
| ServerGroupId |
string |
Hedef sunucu grubunun kimliği. |
sgp-i5qt20****** |
| Type |
string |
Eylem türü. Geçerli değer: İsteklerin birden fazla sunucu grubuna iletildiğini belirten ForwardGroup. |
ForwardGroup |
| GzipEnabled |
boolean |
Belirli dosya türlerini sıkıştırmak için Gzip sıkıştırmasının etkin olup olmadığını belirtir. Geçerli değerler:
|
true |
| Http2Enabled |
boolean |
HTTP/2'nin etkin olup olmadığını belirtir. Geçerli değerler:
Not
Bu parametre yalnızca HTTPS dinleyicileri tarafından desteklenir. |
true |
| IdleTimeout |
integer |
Boşta bağlantı zaman aşımı süresini belirtir. Birim: saniye. Zaman aşımı süresi içinde hiçbir istek alınmazsa, yük dengeleyici mevcut bağlantıyı geçici olarak kapatır ve bir sonraki istek geldiğinde yeni bir bağlantı kurar. |
2 |
| ListenerDescription |
string |
Dinleyicinin özel adı. |
HTTP_80 |
| ListenerId |
string |
Dinleyici kimliği. |
lsn-o4u54y73wq7b****** |
| ListenerPort |
integer |
Yük dengeleyici tarafından kullanılan ön uç bağlantı noktası. |
80 |
| ListenerProtocol |
string |
Dinleyici protokolü. Geçerli değerler: HTTP, HTTPS ve QUIC. |
HTTP |
| ListenerStatus |
string |
Dinleyicinin mevcut durumu. Geçerli değerler:
|
Running |
| LoadBalancerId |
string |
ALB örneğinin kimliği. |
alb-bd6oylbckp6k9x**** |
| LogConfig |
object |
Günlük yapılandırma bilgileri. |
|
| AccessLogRecordCustomizedHeadersEnabled |
boolean |
Erişim günlüklerine özel üst bilgi alanlarının dahil edilip edilmediğini belirtir. Geçerli değerler:
|
true |
| AccessLogTracingConfig |
object |
Erişim günlükleri için Xtrace yapılandırma bilgileri. |
|
| TracingEnabled |
boolean |
Xtrace özelliğinin durumu. Geçerli değerler:
Not
Bu parametreyi yalnızca örnek için erişim günlüğü özelliği (AccessLogEnabled) etkinleştirildiğinde true olarak ayarlayabilirsiniz. |
true |
| TracingSample |
integer |
Xtrace için örnekleme oranı. Geçerli değerler: 1 ile 10000 arası. Not
Bu parametre yalnızca TracingEnabled değeri true olarak ayarlandığında geçerli olur. |
100 |
| TracingType |
string |
Xtrace türü. Geçerli değer: Zipkin. Not
Bu parametre yalnızca TracingEnabled değeri true olarak ayarlandığında geçerli olur. |
Zipkin |
| QuicConfig |
object |
Bir QUIC dinleyicisini ilişkilendirmek için yapılandırma bilgileri. |
|
| QuicListenerId |
string |
İ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çerli olur. Not
Orijinal dinleyici ve ilişkilendirilen QUIC dinleyicisi aynı ALB örneğine ait olmalıdır ve QUIC dinleyicisi daha önce ilişkilendirilmemiş olmalıdır. |
lsn-ek6ad66t**** |
| QuicUpgradeEnabled |
boolean |
QUIC yükseltmesinin etkin olup olmadığını belirtir. Geçerli değerler:
Not
Bu parametre yalnızca HTTPS dinleyicileri için geçerli olur. |
true |
| RequestId |
string |
İstek kimliği. |
365F4154-92F6-4AE4-92F8-7FF****** |
| RequestTimeout |
integer |
İstek zaman aşımı süresini belirtir. Birim: saniye. Bir arka uç sunucusu zaman aşımı süresi içinde yanıt göndermezse, yük dengeleyici beklemeyi durdurur ve istemciye bir |
34 |
| SecurityPolicyId |
string |
Güvenlik ilkesi. Not
Bu parametre yalnızca HTTPS dinleyicileri tarafından desteklenir. |
tls_cipher_policy_1_1 |
| Tags |
array<object> |
Etiketler. |
|
|
object |
Etiket yapısı. |
||
| Key |
string |
Etiket anahtarı. Uzunluğu en fazla 128 karakter olabilir ve |
env |
| Value |
string |
Etiket değeri. Uzunluğu en fazla 128 karakter olabilir ve |
product |
| XForwardedForConfig |
object |
X-Forwarded-For alanı yapılandırması. |
|
| XForwardedForClientCertClientVerifyAlias |
string |
Özel üst bilgi adı. Bu parametre yalnızca XForwardedForClientCertClientVerifyEnabled true olarak ayarlandığında geçerli olur. Ad 1 ila 40 karakter uzunluğunda olmalı ve küçük harf, tire (-), alt çizgi (_) ve rakam içerebilir. Not
Bu parametre yalnızca HTTPS dinleyicileri tarafından desteklenir. |
test_client-verify-alias_123456 |
| XForwardedForClientCertClientVerifyEnabled |
boolean |
Yük dengeleme örneğine erişen istemci sertifikasının doğrulama sonucunu almak için
Not
Bu parametre yalnızca HTTPS dinleyicileri tarafından desteklenir. |
true |
| XForwardedForClientCertFingerprintAlias |
string |
Özel üst bilgi adı. Bu parametre yalnızca XForwardedForClientCertFingerprintEnabled true olarak ayarlandığında geçerli olur. Ad 1 ila 40 karakter uzunluğunda olmalı ve küçük harf, tire (-), alt çizgi (_) ve rakam içerebilir. Not
Bu parametre yalnızca HTTPS dinleyicileri tarafından desteklenir. |
test_finger-print-alias_123456 |
| XForwardedForClientCertFingerprintEnabled |
boolean |
Yük dengeleme örneğine erişen istemci sertifikasının parmak izini almak için
Not
Bu parametre yalnızca HTTPS dinleyicileri tarafından desteklenir. |
true |
| XForwardedForClientCertIssuerDNAlias |
string |
Özel üst bilgi adı. Bu parametre yalnızca XForwardedForClientCertIssuerDNEnabled true olarak ayarlandığında geçerli olur. Ad 1 ila 40 karakter uzunluğunda olmalı ve küçük harf, tire (-), alt çizgi (_) ve rakam içerebilir. Not
Bu parametre yalnızca HTTPS dinleyicileri tarafından desteklenir. |
test_issue-dn-alias_123456 |
| XForwardedForClientCertIssuerDNEnabled |
boolean |
Yük dengeleme örneğine erişen istemci sertifikasının veren bilgilerini almak için
Not
Bu parametre yalnızca HTTPS dinleyicileri tarafından desteklenir. |
true |
| XForwardedForClientCertSubjectDNAlias |
string |
Özel üst bilgi adı. Bu parametre yalnızca XForwardedForClientCertSubjectDNEnabled true olarak ayarlandığında geçerli olur. Ad 1 ila 40 karakter uzunluğunda olmalı ve küçük harf, tire (-), alt çizgi (_) ve rakam içerebilir. Not
Bu parametre yalnızca HTTPS dinleyicileri tarafından desteklenir. |
test_subject-dn-alias_123456 |
| XForwardedForClientCertSubjectDNEnabled |
boolean |
Yük dengeleme örneğine erişen istemci sertifikasının konu bilgilerini almak için
Not
Bu parametre yalnızca HTTPS dinleyicileri tarafından desteklenir. |
true |
| XForwardedForClientSourceIpsEnabled |
boolean |
Uygulama Yük Dengeleyicisinin (ALB), gerçek istemci IP adresini
Not
Bu parametre HTTP ve HTTPS dinleyicileri tarafından desteklenir. |
false |
| XForwardedForClientSourceIpsTrusted |
string |
Güvenilen ara sunucu IP adresları. Uygulama Yük Dengeleme (ALB), |
10.1.1.0/24 |
| XForwardedForClientSrcPortEnabled |
boolean |
Yük dengeleme örneğine erişen istemcinin bağlantı noktasını almak için
Not
Bu parametre HTTP ve HTTPS dinleyicileri tarafından desteklenir. |
true |
| XForwardedForEnabled |
boolean |
İstemcinin gerçek IP adresini almak için
Not
|
true |
| XForwardedForHostEnabled |
boolean |
Yük dengeleme örneğine erişen istemcinin etki alanı adını almak için
Not
Bu parametre HTTP, HTTPS ve QUIC dinleyicileri tarafından desteklenir. |
false |
| XForwardedForProcessingMode |
string |
Not
|
append |
| XForwardedForProtoEnabled |
boolean |
Yük dengeleme örneğinin dinleyici protokolünü almak için
Not
Bu parametre HTTP, HTTPS ve QUIC dinleyicileri tarafından desteklenir. |
true |
| XForwardedForSLBIdEnabled |
boolean |
Yük dengeleme örnek kimliğini almak için
Not
Bu parametre HTTP, HTTPS ve QUIC dinleyicileri tarafından desteklenir. |
true |
| XForwardedForSLBPortEnabled |
boolean |
Yük dengeleme örneğinin dinleyici bağlantı noktasını almak için
Not
Bu parametre HTTP, HTTPS ve QUIC dinleyicileri tarafından desteklenir. |
true |
Examples
Success response
JSON format
{
"AclConfig": {
"AclRelations": [
{
"AclId": "acl-doc****",
"Status": "Associating"
}
],
"AclType": "White"
},
"CaCertificates": [
{
"CertificateId": "139a00*****",
"IsDefault": true,
"Status": "Associated"
}
],
"CaEnabled": false,
"Certificates": [
{
"CertificateId": "123157*******"
}
],
"DefaultActions": [
{
"ForwardGroupConfig": {
"ServerGroupTuples": [
{
"ServerGroupId": "sgp-i5qt20******"
}
]
},
"Type": "ForwardGroup"
}
],
"GzipEnabled": true,
"Http2Enabled": true,
"IdleTimeout": 2,
"ListenerDescription": "HTTP_80",
"ListenerId": "lsn-o4u54y73wq7b******",
"ListenerPort": 80,
"ListenerProtocol": "HTTP",
"ListenerStatus": "Running",
"LoadBalancerId": "alb-bd6oylbckp6k9x****",
"LogConfig": {
"AccessLogRecordCustomizedHeadersEnabled": true,
"AccessLogTracingConfig": {
"TracingEnabled": true,
"TracingSample": 100,
"TracingType": "Zipkin"
}
},
"QuicConfig": {
"QuicListenerId": "lsn-ek6ad66t****",
"QuicUpgradeEnabled": true
},
"RequestId": "365F4154-92F6-4AE4-92F8-7FF******",
"RequestTimeout": 34,
"SecurityPolicyId": "tls_cipher_policy_1_1",
"Tags": [
{
"Key": "env",
"Value": "product"
}
],
"XForwardedForConfig": {
"XForwardedForClientCertClientVerifyAlias": "test_client-verify-alias_123456",
"XForwardedForClientCertClientVerifyEnabled": true,
"XForwardedForClientCertFingerprintAlias": "test_finger-print-alias_123456",
"XForwardedForClientCertFingerprintEnabled": true,
"XForwardedForClientCertIssuerDNAlias": "test_issue-dn-alias_123456",
"XForwardedForClientCertIssuerDNEnabled": true,
"XForwardedForClientCertSubjectDNAlias": "test_subject-dn-alias_123456",
"XForwardedForClientCertSubjectDNEnabled": true,
"XForwardedForClientSourceIpsEnabled": false,
"XForwardedForClientSourceIpsTrusted": "10.1.1.0/24",
"XForwardedForClientSrcPortEnabled": true,
"XForwardedForEnabled": true,
"XForwardedForHostEnabled": false,
"XForwardedForProcessingMode": "append",
"XForwardedForProtoEnabled": true,
"XForwardedForSLBIdEnabled": true,
"XForwardedForSLBPortEnabled": true
}
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 403 | Forbidden.LoadBalancer | Authentication is failed for %s. | Yük dengeleme işlemi için kimlik doğrulama başarısız oldu. |
| 404 | ResourceNotFound.Listener | The specified resource %s is not found. | Dinleyici mevcut değildir. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.