文档中心

消息队列 Kafka版

操作审计

DescribeTopicAuditInfo - 查询主题审计信息

DescribeTopicAuditInfo - 查询主题审计信息

调用 DescribeTopicAuditInfo 接口，查询指定主题的生产或消费记录。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：DescribeTopicAuditInfo

要执行的操作，取值：DescribeTopicAuditInfo。

Version string 必选示例值：2022-05-01

API 的版本，取值：2022-05-01。

PageNumber integer 必选示例值：1

查询的分页编码。

PageSize integer 必选示例值：10

查询的分页大小。

InstanceId string 必选示例值：kafka-cnngf4pulq81xxxx

实例 ID。

Topic string 必选示例值：topic-test

查询的 Topic 名称。

Type string 必选示例值：Produce

查询的记录类型。取值说明如下：

Produce：生产。

Consume：消费。

SourceIp string 可选示例值：192.168

过滤使用的源端 IP。模糊匹配，默认不过滤。

SourcePort string 可选示例值：23

过滤使用的源端端口。模糊匹配，默认不过滤。

SortOrder string 可选示例值：Desc

查询结果将根据修改时间进行排序。取值说明如下：

Desc（默认）：降序。

Asc：升序。

AggregateBySourceIp boolean 可选示例值：True

是否按照 IP 聚合。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

Total integer 示例值：3

符合查询结果的总数。

Records object[] 示例值：详情请参见示例代码

查询结果。

Topic string 示例值：topic-test

Topic 名称。

SourceIp string 示例值：11.156.xxx.xxx

连接对应的源 IP 地址。

SourcePort integer 示例值：58950

连接对应的源端口。

LastUpdateTime string 示例值：2024-11-05T12:05:12Z

最近操作 Topic 的时间。

CreateTime string 示例值：2024-11-05T12:05:11Z

连接建立的时间。

CloseTime string 示例值：无

连接关闭时间。可能为空，表示当前连接仍在持续。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidParameter.PageNumber	The specified parameter PageNumber is not valid.	参数值 PageNumber 无效，请检查后重试。
400	InvalidParameter.PageSize	The specified parameter PageSize is not valid.	参数值 PageSize 无效，请检查后重试。
400	InvalidParameter.Type	The specified parameter Type is not valid.	参数值 Type 无效，请检查后重试。

最近更新时间：2026.10.28 14:35:30

这个页面对您有帮助吗？

有用

有用

无用

无用