管理ACL審核結果 - Cloud Firewall - 阿里雲 - Cloud Firewall

修改 ACL 檢查詳情狀態。

介面說明

QPS 限制

本介面的單使用者 QPS 限制為 10 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理呼叫。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-cloudfirewall:UpdateAclCheckDetailStatus

get

*All Resource

*

無

請求參數

名稱	類型	必填	描述	樣本值
Lang	string	否	語言。枚舉值： en : 英文。 zh : 中文（預設）。	zh
TaskId	string	是	ACL 檢查任務 ID。	task-c92d4544ef7b6a42
Uuid	string	是	ACL 檢查詳情中的 ACL 策略唯一標識 ID。	bbbb43c9-a931-4d89-9939-86d509139a20
Status	string	是	修改狀態。枚舉值： Pending : 待處理。 Ignored : 已忽略。 Processed : 已處理。	Pending

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	850A84D6************00090125EEB1
CheckRecord	object	ACL 檢查記錄。
Acls	array<object>	ACL 檢查結果列表。
	array<object>	ACL 檢查結果。
Acl	object	ACL 檢查結果。
Direction	string	安全存取控制策略管控的流量方向。取值： in：流量從外到內。 out：流量從內到外。	in
Order	integer	存取控制策略生效的優先順序。優先順序數字從 1 開始順序遞增，優先順序數字越小，優先順序越高。	desc
SourceType	string	存取控制策略中的源地址類型。取值： net：源網段（CIDR 地址） group：源地址簿 location：來源區域	net
ApplicationName	string	存取控制策略支援的應用類型。取值： FTP HTTP HTTPS Memcache MongoDB MQTT MySQL RDP Redis SMTP SMTPS SSH SSL_No_Cert SSL VNC 說明支援的應用類型取值與協議類型（Proto）取值存在依賴關係。Proto 為 TCP 協議時，ApplicationNameList 支援選擇以上所有應用類型。當 ApplicationNameList 和 ApplicationName 同時傳值時，以 ApplicationNameList 為準。	ANY
HitTimes	integer	存取控制策略的叫用次數。	1
Description	string	存取控制策略的描述資訊。	test_policy
SourceGroupType	string	存取控制策略中的源地址簿類型。取值： ip：IP 位址簿，包含一個或多個 IP 位址段。 tag：ECS 標籤地址簿，包含一個或多個 ECS 標籤下的 IP 位址。 domain：網域名稱地址簿，包含一個或多個網域名稱地址。 threat：威脅地址簿，包含一個或多個惡意 IP 或網域名稱地址。 backsrc：回源地址簿，包含一個或多個 DDoS 防護執行個體或 WAF 執行個體的回源地址。	ip
DnsResultTime	integer	DNS 解析的時間戳記。使用秒級時間戳記格式表示。	1579261141
DnsResult	string	DNS 解析結果。	192.168.0.1/32
Proto	string	存取控制策略中訪問流量的協議類型。取值： TCP UDP ICMP ANY（表示所有協議類型）說明不設定該參數表示查詢所有協議類型。	ANY
DestinationGroupType	string	存取控制策略中的目的地址簿類型。取值： ip：IP 位址簿，包含一個或多個 IP 位址段。 tag：ECS 標籤地址簿，包含一個或多個 ECS 標籤下的 IP 位址。 domain：網域名稱地址簿，包含一個或多個網域名稱地址。 threat：威脅地址簿，包含一個或多個惡意 IP 或網域名稱地址。 backsrc：回源地址簿，包含一個或多個 DDoS 防護執行個體或 WAF 執行個體的回源地址。	domain
Destination	string	存取控制策略中的目的地址。支援模糊查詢。DestinationType（目的類型）不同，目的地址的取值也不同。當 DestinationType 為`net`時，目的地址為 CIDR 格式的 IP 位址段。例如：10.0.3.0/24。當 DestinationType 為`domain`時，目的地址為網域名稱。例如：aliyun。當 DestinationType 為`group`時，目的地址為地址簿的名稱。例如：db_group。當 DestinationType 為`location`時，目的地址為地區名稱（具體地區位置編碼請參見 AddControlPolicy。例如：["BJ11", "ZB"]。說明不設定該參數表示查詢所有類型的目的地址。	kms.cn-shanghai.aliyuncs.com
HitLastTime	integer	最新命中時間戳記。使用秒級時間戳記格式表示。	1579261141
DestPortGroup	string	存取控制策略中流量訪問的目的連接埠類型。取值： port：連接埠 group：連接埠地址簿	port
AclUuid	string	安全存取控制策略的唯一標識 ID。	1e8ed1b2-cebc-4b95-a9cc-0cb7ce2c0c2c
DestPortType	string	存取控制策略中流量訪問的目的連接埠類型。取值： port：連接埠 group：連接埠地址簿	port
Source	string	存取控制策略中的源地址。取值：當 SourceType 為`net`時，Source 為源 CIDR 地址。例如：10.2.4.0/24 當 SourceType 為`group`時，Source 為源地址簿名稱。例如：db_group	10.71.94.24
DestinationType	string	存取控制策略中的目的地址類型。取值： net：目的網段（CIDR 地址） group：目的地址簿 domain：目的網域名稱	group
DestPort	string	存取控制策略中訪問流量的目的連接埠。	22/22
IpVersion	integer	Cloud Firewall 防護的資產的 IP 版本。取值： 4（預設）：IPv4。 6：IPv6。	4
AclAction	string	存取控制策略中設定的流量通過 Cloud Firewall 的方式（動作）。取值： accept：允許存取 drop：拒絕 log：觀察	log
Release	string	存取控制策略的啟用狀態。策略建立後預設啟用該策略。取值： true：啟用存取控制策略 false：不啟用存取控制策略	true
ApplicationId	string	存取控制策略中設定訪問流量的應用 ID。	HTTP
DestinationGroupCidrs	array	存取控制策略中的目的地址簿中的網段列表。
	string	存取控制策略中的目的地址簿中的網段列表。	192.168.0.1/32
DestPortGroupPorts	array	目的連接埠地址簿中包含的連接埠列表。
	string	目的連接埠地址簿中包含的連接埠列表。	22/22
SourceGroupCidrs	array	存取控制策略中的源地址簿中的網段列表。
	string	存取控制策略中的源地址簿中的網段列表。	192.168.0.1/32
ApplicationNameList	array	存取控制策略支援的應用類型列表。
	string	存取控制策略支援的應用類型列表。	SSH
SpreadCnt	integer	佔用存取控制策略的規格數，即每條策略佔用規格數的累加值。單條策略佔用存取控制策略的規格數=訪問源位址區段個數 * 目的地址個數（IP 位址段個數或地區個數或網域名稱個數）* 應用數 * 連接埠段個數。	10
CreateTime	integer	策略建立時間。使用秒級 Unix 時間戳記表示。	1761062400
ModifyTime	integer	策略最後修改時間。使用秒級 Unix 時間戳記表示。	1761062400
RepeatType	string	存取控制策略的策略有效期間的重複類型。取值： Permanent（預設）：總是 None：指定單次時間 Daily：每天 Weekly：每周 Monthly：每月	None
RepeatDays	array	存取控制策略的策略有效期間的重複日期集合。當 RepeatType 為`Permanent`、`None`、`Daily`時，RepeatDays 為空白集合。例如：[] 當 RepeatType 為 Weekly 時，RepeatDays 不可為空。例如：[0, 6] 說明 RepeatType 設定為 Weekly 時，RepeatDays 不允許重複。當 RepeatType 為`Monthly`時，RepeatDays 不可為空。例如：[1, 31] 說明 RepeatType 設定為 Monthly 時，RepeatDays 不允許重複。
	integer	存取控制策略的策略有效期間的重複日期集合。當 RepeatType 為`Permanent`、`None`、`Daily`時，RepeatDays 為空白集合。例如：[] 當 RepeatType 為 Weekly 時，RepeatDays 不可為空。例如：[0, 6] 說明 RepeatType 設定為 Weekly 時，RepeatDays 不允許重複。當 RepeatType 為`Monthly`時，RepeatDays 不可為空。例如：[1, 31] 說明 RepeatType 設定為 Monthly 時，RepeatDays 不允許重複。	1
RepeatStartTime	string	策略生效的重複開始時間。使用 HH:mm 格式的 24 小時制時間，如 08:00，必須為整點或半點鐘時間，且小於重複結束時間至少半小時。說明當 RepeatType 為 Permanent、None 時，RepeatStartTime 為空白。當 RepeatType 為 Daily、Weekly、Monthly 時，RepeatStartTime 必須有值，您需要設定重複開始時間。	08:00
RepeatEndTime	string	策略生效的重複結束時間。使用 HH:mm 格式的 24 小時制時間，如 23:30，必須為整點或半點鐘時間，且大於重複開始時間至少半小時。說明當 RepeatType 為 Permanent、None 時，RepeatEndTime 為空白。當 RepeatType 為 Daily、Weekly、Monthly 時，RepeatEndTime 必須有值，您需要設定重複結束時間。	23:30
StartTime	integer	查詢開始時間。使用秒級時間戳記格式表示。	1736130347
EndTime	integer	查詢結束時間。使用秒級時間戳記格式表示。	1752754426
AddressListCount	integer	地址簿中包含地址的個數。	1
GroupUuid	string	地址簿的唯一標識 ID。說明取值來源：批量查詢地址簿列表。	5a96a798-9b73-47f7-831e-1d7aa3c987a9
AutoAddTagEcs	integer	是否自動添加新匹配標籤的 ECS（新購且完成標籤設定的 ECS 或修改標籤的 ECS）公網 IP 到地址簿。	0
GroupName	string	地址簿的名稱。	subscribe
ReferenceCount	integer	地址簿被引用次數。	1
GroupType	string	地址簿的類型。取值： ip：IP 位址簿。 domain：網域名稱地址簿。 port：連接埠地址簿。 tag：ECS 標籤地址簿。 allCloud：雲端服務地址簿。 threat：威脅情報地址簿。	port
TagRelation	string	多個 ECS 標籤間的關係。	and
TagList	array<object>	ECS 標籤列表。
	object	ECS 標籤。
TagValue	string	ECS 標籤鍵。	tfTestAcc0
TagKey	string	ECS 標籤鍵。	produce
AddressList	array	地址簿的地址清單資訊。
	string	地址簿的地址清單資訊。	183.2.201.71/32,60.28.235.22/32,210.51.58.107/32,60.28.235.81/32,210.51.58.51/32,60.28.235.52/32,1.1.1.1/32,154.212.141.143/32,167.94.146.55/32,185.226.197.47/32,101.251.238.174/32
NatGatewayId	string	NAT Gateway 的 ID。	ngw-gw85zno51npz7lgc04z89
DomainResolveType	integer	存取控制策略的網域名稱解析方式。取值： FQDN：基於 FQDN DNS：基於 DNS 動態解析 FQDN_AND_DNS：基於 FQDN 與 DNS 動態解析	0
VpcFirewallId	string	VPC 邊界防火牆的執行個體 ID。	cen-cw4z051hr8x53qniv5
AclStatus	string	ACL 檢查狀態。	configuring
AclAssessmentDetail	string	該條 ACL 策略的研判詳情。	No traffic hit policy.
RecordAssessmentDetail	string	該條 ACL 檢查研判詳情。	Due to business offline or other reasons, the number of hits of the object policy in a period of time is 0.
CheckName	string	ACL 檢查名稱。取值： PolicyHitCountZero：無流量命中策略 PolicySourceDestinationSame：來源和目的物件相同無效策略 PolicyDuplicate：重複冗餘策略 PolicyConflict：業務衝突策略 DefaultPolicyNotDeny：預設兜底策略不是 Deny All 白名單機制 PolicyPortHighRisk：高風險連接埠放行風險策略 PolicyTooLoose：管控策略過於寬鬆 AddressBookIpSeparated：IP 位址簿重複、重疊、分散 AddressBookPortSeparated：連接埠位址簿重複、重疊、分散 AddressBookDomainValid：網域名稱位址簿合法性校驗。	PolicyHitCountZero
Description	string	規則描述。	dwd_mysql_lingwan_faxing_chat_config_di
LastCheckTime	string	最新檢測時間戳記，單位為秒。	1724982259
Level	string	風險等級。	High
PolicyTotalCount	integer	策略總數。	1
TaskId	string	ACL 檢查任務 ID。	task-c92d4544ef7b6a42

樣本

正常返回樣本

JSON格式

{
  "RequestId": "850A84D6************00090125EEB1",
  "CheckRecord": {
    "Acls": [
      {
        "Acl": {
          "Direction": "in",
          "Order": 0,
          "SourceType": "net",
          "ApplicationName": "ANY",
          "HitTimes": 1,
          "Description": "test_policy",
          "SourceGroupType": "ip",
          "DnsResultTime": 1579261141,
          "DnsResult": "192.168.0.1/32",
          "Proto": "ANY",
          "DestinationGroupType": "domain",
          "Destination": "kms.cn-shanghai.aliyuncs.com",
          "HitLastTime": 1579261141,
          "DestPortGroup": "port",
          "AclUuid": "1e8ed1b2-cebc-4b95-a9cc-0cb7ce2c0c2c",
          "DestPortType": "port",
          "Source": "10.71.94.24",
          "DestinationType": "group",
          "DestPort": "22/22",
          "IpVersion": 4,
          "AclAction": "log",
          "Release": "true",
          "ApplicationId": "HTTP",
          "DestinationGroupCidrs": [
            "192.168.0.1/32"
          ],
          "DestPortGroupPorts": [
            "22/22"
          ],
          "SourceGroupCidrs": [
            "192.168.0.1/32"
          ],
          "ApplicationNameList": [
            "SSH"
          ],
          "SpreadCnt": 10,
          "CreateTime": 1761062400,
          "ModifyTime": 1761062400,
          "RepeatType": "None",
          "RepeatDays": [
            1
          ],
          "RepeatStartTime": "08:00",
          "RepeatEndTime": "23:30",
          "StartTime": 1736130347,
          "EndTime": 1752754426,
          "AddressListCount": 1,
          "GroupUuid": "5a96a798-9b73-47f7-831e-1d7aa3c987a9",
          "AutoAddTagEcs": 0,
          "GroupName": "subscribe",
          "ReferenceCount": 1,
          "GroupType": "port",
          "TagRelation": "and",
          "TagList": [
            {
              "TagValue": "tfTestAcc0",
              "TagKey": "produce"
            }
          ],
          "AddressList": [
            "183.2.201.71/32,60.28.235.22/32,210.51.58.107/32,60.28.235.81/32,210.51.58.51/32,60.28.235.52/32,1.1.1.1/32,154.212.141.143/32,167.94.146.55/32,185.226.197.47/32,101.251.238.174/32"
          ],
          "NatGatewayId": "ngw-gw85zno51npz7lgc04z89",
          "DomainResolveType": 0,
          "VpcFirewallId": "cen-cw4z051hr8x53qniv5"
        },
        "AclStatus": "configuring",
        "AclAssessmentDetail": "No traffic hit policy."
      }
    ],
    "RecordAssessmentDetail": "Due to business offline or other reasons, the number of hits of the object policy in a period of time is 0.\n",
    "CheckName": "PolicyHitCountZero",
    "Description": "dwd_mysql_lingwan_faxing_chat_config_di",
    "LastCheckTime": "1724982259",
    "Level": "High",
    "PolicyTotalCount": 1,
    "TaskId": "task-c92d4544ef7b6a42"
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	ErrorAclCheckNotExist	ACL check not exist.
400	ErrorAclCheckDetailNotExist	ACL check detail not exist.

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

變更歷史

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