消息队列 Kafka版
消息队列 Kafka版
文档指南
请输入
- 文档首页
消息队列 Kafka版API 参考V2（2022-05-01）操作审计DescribeTopicAuditInfo - 查询主题审计信息
复制全文
下载 pdfDescribeTopicAuditInfo - 查询主题审计信息
文档反馈
问问助手调用 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：升序
返回参数
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 示例值：无
连接关闭时间。可能为空，表示当前连接仍在持续。
请求示例
POST /?Action=DescribeTopicAuditInfo&Version=2022-05-01 HTTP/1.1
Host: kafka.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20241105T120515Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241105/cn-beijing/Kafka/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
{
"PageNumber": 1,
"PageSize": 10,
"InstanceId": "kafka-cnngf4pulq81xxxx",
"Topic": "topic-test",
"Type": "Produce"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20241105200531860139816C6D5D14D7B7-e7****",
"Action": "DescribeTopicAuditInfo",
"Version": "2022-05-01",
"Service": "Kafka",
"Region": "cn-xxxx"
},
"Result": {
"Records": [
{
"CloseTime": "",
"CreateTime": "2024-11-05T12:05:11Z",
"LastUpdateTime": "2024-11-05T12:05:14Z",
"SourceIp": "11.156.xxx.xxx",
"SourcePort": 58950,
"Topic": "topic-test"
},
{
"CloseTime": "",
"CreateTime": "2024-11-05T12:05:11Z",
"LastUpdateTime": "2024-11-05T12:05:13Z",
"SourceIp": "11.156.xxx.xxx",
"SourcePort": 57904,
"Topic": "topic-test"
},
{
"CloseTime": "",
"CreateTime": "2024-11-05T12:05:11Z",
"LastUpdateTime": "2024-11-05T12:05:12Z",
"SourceIp": "11.156.xxx.xxx",
"SourcePort": 65124,
"Topic": "topic-test"
}
],
"Total": 3
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
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.09.22 16:07:31
这个页面对您有帮助吗？
有用
有用
无用
无用