调用DescribeOutgoingDestinationCategory查询主动外联目的分类-云防火墙-阿里云-云防火墙(Cloud Firewall)-阿里云帮助中心

查询主动外联目的分类。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

yundun-cloudfirewall:DescribeOutgoingDestinationCategory

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
SourceIp `deprecated`	string	否	访问者源 IP 地址。	59.82.45.XXX
Lang	string	否	接收消息的语言类型。	zh
StartTime	string	是	设置查询开始时间。使用秒级时间戳格式表示。	1749657600
EndTime	string	是	设置查询结束时间。使用秒级时间戳格式表示。	1750818370
CategoryId	string	否	目的分类 ID。除 All、RiskDomain、AliYun、NotAliYun 外，NotAliYun 下还包含 TrustedDomain、AliPay、DingDing、WeChat、Google、Alibaba、CDN、NAT、TrustIP 等分类；实际支持超过 25 个分类值，应以接口返回的分类结果为准。枚举值： All : 全部 RiskDomain : 风险域名 AliYun : 阿里云产品 NotAliYun : 非阿里云产品	All
TypeId	string	否	固定类别 ID。枚举值： All : 全部 AliYun : 阿里云产品 NotAliYun : 非阿里云产品	All
DstType	string	否	目标类型。本参数必填，缺失时返回 ErrorDstType。取值区分大小写：Domain 表示域名，DstIP 表示目的 IP。枚举值： DstIP : 目的 IP Domain : 域名	Domain

返回参数

名称	类型	描述	示例值
	object
TotalCount	integer	总条数。	10
RequestId	string	返回结果的请求 ID。	C1ED80BC-FFC8-57DB-8151-705DC31****
TypeList	array<object>	主动外联分类列表。
	array<object>	主动外联分类。
TypeName	string	固定类别名称。	AliYun
TypeId	string	固定类别 ID。枚举值： All : 全部 AliYun : 阿里云产品 NotAliYun : 非阿里云产品	All
TypeDescribe	string	固定类别描述。	AliYun
CategoryList	array<object>	主动外联分类列表。
	object	主动外联分类。
CategoryId	string	主动外联分类 ID。	123
CategoryName	string	主动外联分类名称。	AliYun
CategoryDescribe	string	主动外联分类描述。	AliYun
ClassId	string	主动外联分类分级 ID。	Trusted

示例

正常返回示例

JSON格式

{
  "TotalCount": 10,
  "RequestId": "C1ED80BC-FFC8-57DB-8151-705DC31****",
  "TypeList": [
    {
      "TypeName": "AliYun",
      "TypeId": "All",
      "TypeDescribe": "AliYun",
      "CategoryList": [
        {
          "CategoryId": "123",
          "CategoryName": "AliYun",
          "CategoryDescribe": "AliYun",
          "ClassId": "Trusted"
        }
      ]
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	ErrorAliUid	Aliuid invalid.	aliuid无效
400	ErrorDstType	The dst type is invalid.	无效的目的类型
400	ErrorDBSelectError	A database select error occurred.	内部错误：数据库查询错误
400	ErrorObjectOperation	The objectOperation is invalid.	无效的objectOperation

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

变更历史

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