AssociateAclsWithListener - 關聯存取控制和監聽 - Server Load Balancer

介面說明

AssociateAclsWithListener 介面屬於非同步介面，即系統返回一個請求 ID，但該 ACL 尚未成功綁定監聽器，系統背景綁定任務仍在進行。您可以調用 ListAclRelations 查詢 ACL 的綁定狀態：

當 ACL 處於 Associating 狀態時，表示 ACL 正在綁定監聽器中。
當 ACL 處於 Associated 狀態時，表示 ACL 已成功綁定監聽器。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

alb:AssociateAclsWithListener

create

*Acl

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

*LoadBalancer

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

無

請求參數

名稱	類型	必填	描述	樣本值
AclIds	array	是	ACL 執行個體 ID，最多支援 3 個 ACL 執行個體 ID。
	string	否	ACL 執行個體 ID。	acl-hp34s2h0xx1ht4nwo****
ListenerId	string	是	監聽執行個體 ID	lsn-bp1bpn0kn9*******
AclType	string	是	存取控制類型： White：僅轉寄來自所選存取控制策略組中設定的 IP 位址或位址區段的請求，白名單適用於只允許特定 IP 訪問的情境。設定白名單存在一定業務風險。一旦設定白名單，就只有白名單中的 IP 可以訪問負載平衡監聽。如果開啟了白名單訪問，但存取原則組中沒有添加任何 IP，則負載平衡監聽會轉寄全部請求。 Black：來自所選存取控制策略組中設定的 IP 位址或位址區段的所有請求都不會轉寄，黑名單適用於只限制某些特定 IP 訪問的情境。如果開啟了黑名單訪問，但存取原則組中沒有添加任何 IP，則負載平衡監聽會轉寄全部請求。	White
DryRun	boolean	否	是否只預檢此次請求，取值： true：發送檢查請求，不會關聯 ACL 到監聽。檢查項包括是否填寫了必需參數、請求格式、業務限制。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼`DryRunOperation`。 false（預設值）：發送正常請求，通過檢查後返回 HTTP 2xx 狀態代碼並直接進行操作。	true
ClientToken	string	否	用戶端 Token，用於保證請求的等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。說明若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。	5A2CFF0E-5718-45B5-9D4D-70B******

返回參數

名稱	類型	描述	樣本值
	object	將存取控制關聯到監聽。
JobId	string	非同步任務 ID	72dcd26b-f12d-4c27-b3af-18f6aed5****
RequestId	string	請求 ID	CEF72CEB-54B6-4AE8-B225-F87******

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	QuotaExceeded.AclsNum	The quota of %s is exceeded, usage %s/%s.	配額%s已超額度限制，目前已使用%s，配額為%s。
400	IncorrectStatus.Acl	The status of %s [%s] is incorrect.	存取控制策略組ACL的目前狀態不支援本次操作。
400	ResourceQuotaExceeded.ListenerAclEntriesNum	The quota of %s is exceeded for resource %s, usage %s/%s.	配額%s已超額度限制，資源是%s，目前已使用%s，配額為%s。
400	OperationDenied.AclNotSupport	The operation is not allowed because of %s.	因為%s，該操作不被允許。
400	ResourceAlreadyExist.AclEntry	The specified resource %s already exists.	存取控制策略組中的IP條目已存在。
400	ResourceInUse.Acl	The specified resource %s is in use.	資源%s正在使用中。
400	OperationDenied.LoadBalancerJoinedSecurityGroupNotSupportAcl	The operation is not allowed because of loadbalancer joined security group not support acl.	不允許操作，原因是Server Load Balancer執行個體加入安全性群組後，不能再綁定存取控制策略
404	ResourceNotFound.Acl	The specified resource %s is not found.	存取控制策略組ACL不存在。
404	ResourceNotFound.Listener	The specified resource %s is not found.	監聽不存在。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。