Erişim kontrol listelerini bir dinleyici ile ilişkilendirir.
Operation description
AssociateAclsWithListener işlemi eşzamansızdır. Bu işlemi çağırdıktan sonra sistem bir istek kimliği döndürür, ancak ACL'ler henüz dinleyici ile ilişkilendirilmemiştir. İlişkilendirme görevi arka planda çalışmaya devam eder. ACL'lerin ilişkilendirme durumunu sorgulamak için ListAclRelations işlemini çağırabilirsiniz:
ACL Associating durumundaysa, ACL dinleyici ile ilişkilendiriliyor demektir.
ACL Associated durumundaysa, ACL dinleyici ile ilişkilendirilmiş demektir.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
alb:AssociateAclsWithListener |
create |
*Acl
*LoadBalancer
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| AclIds |
array |
Yes |
ACL örnek kimlikleri. En fazla üç ACL örnek kimliği belirtebilirsiniz. |
|
|
string |
No |
ACL örnek kimliği. |
acl-hp34s2h0xx1ht4nwo**** |
|
| ListenerId |
string |
Yes |
Dinleyici örnek kimliği. Bu işlemi çağırmadan önce, dinleyicinin ait olduğu Uygulama Yük Dengeleyici (ALB) örneğinin bir güvenlik grubuyla ilişkilendirilmemiş olduğunu doğrulayın. Bir ALB örneği bir güvenlik grubuyla ilişkilendirildikten sonra, örneğe bir erişim kontrol ilkesi ekleyemezsiniz. |
lsn-bp1bpn0kn9******* |
| AclType |
string |
Yes |
Erişim kontrol türü. Geçerli değerler:
|
White |
| DryRun |
boolean |
No |
Deneme çalıştırması yapılıp yapılmayacağını belirtir. Geçerli değerler:
|
true |
| ClientToken |
string |
No |
İsteğin idempotent olmasını sağlamak için kullanılan istemci belirteci. Değeri oluşturmak için istemciyi kullanabilirsiniz ve değerin farklı istekler arasında benzersiz olduğundan emin olmalısınız. İstemci belirteci yalnızca ASCII karakterleri içerebilir. Not
Bu parametreyi ayarlamazsanız, sistem otomatik olarak API isteğinin RequestId değerini ClientToken olarak kullanır. Her API isteğinin RequestId değeri benzersizdir. |
5A2CFF0E-5718-45B5-9D4D-70B****** |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Erişim kontrol listelerini bir dinleyici ile ilişkilendirme işlemine ait yanıt. |
||
| JobId |
string |
Eşzamansız görevin kimliği. |
72dcd26b-f12d-4c27-b3af-18f6aed5**** |
| RequestId |
string |
İsteğin kimliği. |
CEF72CEB-54B6-4AE8-B225-F87****** |
Examples
Success response
JSON format
{
"JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
"RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | QuotaExceeded.AclsNum | 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. | |
| 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. | |
| 400 | OperationDenied.LoadBalancerJoinedSecurityGroupNotSupportAcl | The operation is not allowed because of loadbalancer joined security group not support acl. | |
| 404 | ResourceNotFound.Acl | The specified resource %s is not found. | |
| 404 | ResourceNotFound.Listener | The specified resource %s is not found. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.