ListTopics

获取或搜索事件列表

Server Alibabacloud Dataworks alibabacloud-dataworks-mcp-server
Category Read
Risk class Low
Parameters 94 required

What ListTopics does on Alibabacloud Dataworks

AI agents call ListTopics to retrieve information from Alibabacloud Dataworks without modifying anything — typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

ParameterTypeRequiredDescription
Owner string 事件责任人的阿里云UID
NodeId number 事件关联的任务节点ID,与参数InstanceId互斥
EndTime string Yes 截止发现时间,需要使用UTC格式(yyyy-MM-dd'T'HH:mm:ssZ)
PageSize number Yes 每页显示的条数,默认为10条,最大100条
BeginTime string Yes 起始发现时间,需要使用UTC格式(yyyy-MM-dd'T'HH:mm:ssZ)
InstanceId number 事件关联的实例ID,与参数NodeId互斥
PageNumber number Yes 分页的页数。默认值为1,最小值为1,最大值为30
TopicTypes string 事件的类型,包括SLOW(变慢)和ERROR(出错)。多个事件类型之间使用英文逗号(,)分隔
TopicStatuses string 事件的状态,包括IGNORE(已忽略)、NEW(新发现)、FIXING(处理中)和RECOVER(已恢复)。多个事件状态之间使用英文逗号(,)分隔

Parameters from the server's own tool schema.

Why ListTopics needs a policy

Even though ListTopics only reads data, uncontrolled read access leaks sensitive information and racks up API costs — an agent caught in a retry loop can make thousands of calls a minute without anyone noticing.

Questions about ListTopics

What does the ListTopics tool do? +

获取或搜索事件列表. It is categorised as a Read tool in the Alibabacloud Dataworks MCP Server, which means it retrieves data without modifying state.

What parameters does ListTopics accept? +

ListTopics accepts 9 parameters: Owner, NodeId, EndTime, PageSize, BeginTime, InstanceId, PageNumber, TopicTypes, TopicStatuses. Required: EndTime, PageSize, BeginTime, PageNumber. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on ListTopics? +

Register the Alibabacloud Dataworks MCP server in PolicyLayer and add a rule for ListTopics: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Alibabacloud Dataworks. Nothing to install.

What risk level is ListTopics? +

ListTopics is a Read tool with low risk. Read-only tools are generally safe to allow by default.

Can I rate-limit ListTopics? +

Yes. Add a rate_limit block to the ListTopics rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block ListTopics completely? +

Set action: deny in the PolicyLayer policy for ListTopics. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides ListTopics? +

ListTopics is provided by the Alibabacloud Dataworks MCP server (alibabacloud-dataworks-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.