调用DescribeOutgoingDestinationIP查询主动外联的目的IP信息-云防火墙-阿里云-云防火墙(Cloud Firewall)-阿里云帮助中心

查询主动外联的目的IP信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-cloudfirewall:DescribeOutgoingDestinationIP

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Lang	string	否	接收消息的语言类型。取值： zh（默认）：中文。 en：英文。枚举值： en : 英文 zh : 中文	zh
StartTime	string	是	设置查询开始时间。使用秒级时间戳格式表示。	1656837360
EndTime	string	是	设置查询结束时间。使用秒级时间戳格式表示。	1656923760
PageSize	string	否	设置分页查询每页包含多少条结果。默认值为 6，表示每页包含 6 条结果。最大值为 10。	10
CurrentPage	string	否	设置分页查询返回第几页数据。默认值为 1，表示返回第 1 页数据。	1
CategoryId	string	否	产品分类 ID。默认值为空，取值： All ：全部分类 RiskDomain ：风险域名分类 RiskIP ：风险 IP 分类 AliYun ：云产品分类 NotAliYun ：非云产品分类	All
DstIP	string	否	主动外联域名的目的 IP。	10.0.XX.XX
PublicIP	string	否	外联 ECS 的公网 IP。	192.0.XX.XX
PrivateIP	string	否	外联 ECS 的私网 IP。	192.168.XX.XX
Port	string	否	端口号。	80
Sort	string	否	按照指定的字段排序。取值： SessionCount（默认值）：请求次数。 TotalBytes：总流量数。	SessionCount
Order	string	否	排序方式。取值： asc：升序。 desc（默认）：降序。	desc
TagIdNew	string	否	情报标签 ID。取值： AliYun：阿里云产品 RiskDomain：风险域名 RiskIP：风险 IP TrustedDomain：信誉网站 AliPay：支付宝 DingDing：钉钉 WeChat：微信 QQ：腾讯 QQ SecurityService：安全服务 Microsoft：微软 Amazon：亚马逊 Pan：网盘 Map：地图 Code：代码托管 SystemService：系统服务 Taobao：淘宝 Google：谷歌 ThirdPartyService：第三方平台服务 FirstFlow：首次 Downloader：恶意下载 Alexa Top1M：热门网站 Miner：矿池 Intelligence：威胁情报 DDoS：DDoS 木马 Ransomware：勒索软件 Spyware：间谍软件 Rogue：流氓软件 Botnet：僵尸网络 Suspicious：可疑网站 C&C：远控 Gang：团伙 CVE：漏洞 CVE Backdoor：木马后门 Phishing：钓鱼网站 APT：APT 攻击 Supply Chain Attack：供应链攻击 Malicious software：恶意软件	AliYun
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 为准。	FTP

返回参数

名称	类型	描述	示例值
	object
TotalCount	integer	外联 IP 的总数量。	50
RequestId	string	本次调用请求的 ID。	F0F82705-CFC7-5F83-86C8-A063892F****
DstIPList	array<object>	主动外联的 IP 列表。
	array<object>	主动外联的 IP 列表。
AclCoverage	string	是否覆盖访问控制策略。取值： Uncovered：未覆盖。 FullCoverage：已覆盖。	Uncovered
DstIP	string	主动外联域名的目的 IP。	10.0.XX.XX
AclRecommendDetail	string	ACL 的建议信息。	建议放行
HasAclRecommend	boolean	是否有推荐 ACL。取值： true：是。 false：否。	true
InBytes	integer	入方向的流量。单位：Byte。	472
CategoryName	string	产品的分类名称。取值：阿里云产品非阿里云产品	阿里云产品
RuleName	string	ACL 规则名称。	默认规则
RuleId	string	ACL 规则 UUID。	fadsfd-dfadf-df****
SessionCount	integer	请求次数。	4
GroupName	string	规则的组名称。	rules_test
SecuritySuggest	string	主动外联域名的安全策略。取值： pass：放行。 alert：拒绝。 drop：观察。	pass
OutBytes	integer	出方向的流量。单位：Byte。	965
AclStatus	string	访问控制策略的健康状态。取值： Normal：健康。 Abnormal：不健康。	Normal
IsMarkNormal	boolean	是否加入白名单。取值： true：已加入。 false：未加入。	true
CategoryId	string	产品分类 ID。取值： Aliyun：阿里云产品。 NotAliyun：非阿里云产品。	Aliyun
TagList	array<object>	标签列表。
	object	标签列表。
RiskLevel	integer	风险评估等级。取值： 1：低危。 2：中危。 3：高危。	1
TagName	string	情报标签名称。	ReleaseLabel
TagId	string	情报标签 ID。	ReleaseLabel
TagDescribe	string	情报标签的描述。	ReleaseLabel
ClassId	string	情报标签的分类。取值： Suspicious：可疑。 Malicious：恶意。 Trusted：信任。	Trusted
ApplicationPortList	array<object>	应用端口列表。说明列表仅展示前 99 个应用端口。当外联应用端口超过 99 个时，仅展示前 99 条数据。
	object	端口列表。
Port	integer	应用的端口。	80
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 为准。	HTTP
UnknownReason	array	识别协议为 Unknown 情况下，未分析到协议的原因列表。
	string	协议分析失败原因。	tcp_not_establish
CategoryClassId	string	情报标签的分类。取值： Suspicious：可疑。 Malicious：恶意。 Trusted：信任。	Trusted
SecurityReason	string	安全原因。	智能策略：该目的域名所属组织为阿里云计算有限公司，主要业务为阿里云，未发现安全风险，可用于配置外联白名单。
TotalBytes	string	总流量。单位：byte。	800
HasAcl	string	是否有访问控制规则。取值： true：有。 false ：没有。	true
AddressGroupList	array<object>	地址簿信息。
	object
AddressGroupUUID	string	地址簿唯一标识。	f04ac7ce-628b-4cb7-be61-310222b7****
AddressGroupName	string	地址簿名称。	IP地址簿
AssetCount	integer	主动外联的资产总数。	20
PrivateAssetCount	integer	主动外联的私网资产总数。	20
LocationName	string	区域名。	山东省青岛市

示例

正常返回示例

JSON格式

{
  "TotalCount": 50,
  "RequestId": "F0F82705-CFC7-5F83-86C8-A063892F****",
  "DstIPList": [
    {
      "AclCoverage": "Uncovered",
      "DstIP": "10.0.XX.XX",
      "AclRecommendDetail": "建议放行",
      "HasAclRecommend": true,
      "InBytes": 472,
      "CategoryName": "阿里云产品",
      "RuleName": "默认规则",
      "RuleId": "fadsfd-dfadf-df****",
      "SessionCount": 4,
      "GroupName": "rules_test",
      "SecuritySuggest": "pass",
      "OutBytes": 965,
      "AclStatus": "Normal",
      "IsMarkNormal": true,
      "CategoryId": "Aliyun",
      "TagList": [
        {
          "RiskLevel": 1,
          "TagName": "ReleaseLabel",
          "TagId": "ReleaseLabel",
          "TagDescribe": "ReleaseLabel",
          "ClassId": "Trusted"
        }
      ],
      "ApplicationPortList": [
        {
          "Port": 80,
          "ApplicationName": "HTTP",
          "UnknownReason": [
            "tcp_not_establish"
          ]
        }
      ],
      "CategoryClassId": "Trusted",
      "SecurityReason": "智能策略：该目的域名所属组织为阿里云计算有限公司，主要业务为阿里云，未发现安全风险，可用于配置外联白名单。",
      "TotalBytes": "800",
      "HasAcl": "true",
      "AddressGroupList": [
        {
          "AddressGroupUUID": "f04ac7ce-628b-4cb7-be61-310222b7****",
          "AddressGroupName": "IP地址簿"
        }
      ],
      "AssetCount": 20,
      "PrivateAssetCount": 20,
      "LocationName": "山东省青岛市"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	ErrorAliUid	Aliuid invalid.	aliuid无效
400	ErrorTimeError	The time is invalid.	时间选择错误
400	ErrorIpFormat	The IP address is invalid.	无效的IP
400	ErrorDBSelectError	A database select error occurred.	内部错误：数据库查询错误
400	ErrorPortError	The port is invalid.	无效的端口
400	ErrorSecuritySuggest	The security suggest is invalid.	无效的security suggest
400	ErrorSortError	The sort is invalid.	无效的排序字段
400	ErrorOrderFailed	The order is invalid.	无效的order
400	ErrorPageNo	Either page number or page size is invalid.	无效的page number 或者 page size
400	ErrorIntervalError	The interval is invalid.	无效的时间间隔
400	ErrorDataTypeError	The data type is invalid.	无效的数据类型
400	ErrorMarshalJSON	internal error.	内部错误。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。