AddEntriesToAcl - 添加存取控制條目 - Server Load Balancer

介面說明

每個策略組可包含多個 IP 位址條目或 IP 位址段條目，存取控制策略組的條目限制如下：
- 單帳號每次可添加的 IP 位址條目個數：20
- 每個存取控制策略組可包含的條目個數：500
AddEntriesToAcl 介面屬於非同步介面，即系統返回一個請求 ID，但該存取控制策略組尚未成功添加 IP 條目，系統背景新增工作仍在進行。您可以調用 ListAclEntries 查詢 IP 條目的添加狀態：
- 當存取控制策略組處於 Adding 狀態時，表示 IP 條目正在添加中。
- 當存取控制策略組處於 Available 狀態時，表示 IP 條目添加成功。

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

alb:AddEntriesToAcl

create

*Acl

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

無

名稱	類型	必填	描述	樣本值
AclId	string	是	ACL 執行個體 ID。	acl-hp34s2h0xx1ht4nwo****
AclEntries	array<object>	是	添加的存取控制條目列表。單次調用最多支援 20 個存取控制條目。
	object	否	存取控制策略結構。
Description	string	否	存取控制條目備忘描述，長度為 2~256 個字元，可包含英文字母、數字、中文、半形逗號（,）、半形句號（.）、半形分號（;）、正斜線（/）、at（@）、底線（_）和短劃線（-）。單次調用最多支援 20 個存取控制條目。	test-entry
Entry	string	是	存取控制條目 IP 位址段。	10.0.1.0/24
ClientToken	string	否	用戶端 Token，用於保證請求的等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。說明若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。	5A2CFF0E-5718-45B5-9D4D-70B3******
DryRun	boolean	否	是否只預檢此次請求，取值： true：發送檢查請求，不會在存取控制策略組中添加 IP 條目。檢查項包括是否填寫了必需參數、請求格式、業務限制。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼`DryRunOperation`。 false（預設值）：發送正常請求，通過檢查後返回 HTTP 2xx 狀態代碼並直接進行操作。	false

正常返回樣本

JSON格式

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

HTTP status code	錯誤碼	錯誤資訊	描述
400	ResourceAlreadyExist.AclEntry	The specified resource %s already exists.	存取控制策略組中的IP條目已存在。
400	ResourceQuotaExceeded.AclEntriesNum	The quota of %s is exceeded for resource %s, usage %s/%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	ResourceQuotaExceeded.LoadBalancerAclEntriesNum	The quota of %s is exceeded for resource %s, usage %s/%s.	配額%s已超額度限制，資源是%s，目前已使用%s，配額為%s。
404	ResourceNotFound.Acl	The specified resource %s is not found.	存取控制策略組ACL不存在。

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

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