DescribeAssetRiskList - Cloud Firewall - Alibaba Cloud Documentation Center

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
SourceIp	string	No	The source IP address of the visitor.	47.100.XX.XX
Lang	string	No	The language of the response message. Valid values: zh (default): Chinese en: English	zh
IpVersion	integer	Yes	The IP version of the asset that is protected by Cloud Firewall. Valid values: 4 (default): IPv4 6: IPv6	4
IpAddrList	array	No	The IP addresses to query. Separate multiple IP addresses with commas (,). You can query a maximum of 20 IP addresses at a time. Note Example of an IPv4 address: 47.97.XX.XX. Example of an IPv6 address: 2001:db8:ffff:ffff:ffff:XXXX:ffff.
	string	No	The IP addresses to query. Separate multiple IP addresses with commas (,). You can query a maximum of 20 IP addresses at a time. Note Example of an IPv4 address: 47.97.XX.XX. Example of an IPv6 address: 2001:db8:ffff:ffff:ffff:XXXX:ffff.	47.97.XX.XX

Response elements

Element	Type	Description	Example
	object
TotalCount	integer	The total number of entries returned.	12
RequestId	string	The ID of the request.	443C5781-1C03-5FCD-8EC5-FB9C0B9AC396
AssetList	array<object>	The details of the assets.
	object	The details of an asset.
RiskLevel	string	The risk level. Valid values: low: low risk middle: medium risk high: high risk	low
Ip	string	The IP address of the server.	39.108.XX.XX
IpVersion	integer	The IP version of the asset that is protected by Cloud Firewall. Valid values: 4: IPv4 address 6: IPv6 address	4
Reason	string	The reason for the risk.	other

Examples

Success response

JSON format

{
  "TotalCount": 12,
  "RequestId": "443C5781-1C03-5FCD-8EC5-FB9C0B9AC396",
  "AssetList": [
    {
      "RiskLevel": "low",
      "Ip": "39.108.XX.XX",
      "IpVersion": 4,
      "Reason": "other"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.