SuperAPI AI 工具集

pulumi-context-api

编程与开发

查看项目

更新于 10-16 04:53

技能介绍

用途:Pulumi Context API 以图的方式回答组织云基础设施问题,例如某资源依赖什么、变更会影响哪些对象。它覆盖通过 Pulumi Discovery 发现的资源,不限于 Pulumi 管理的资源。当问题涉及关系时,应优先使用它而非 Resource Search,因为后者只能查找单个资源、无法沿边遍历。

主要能力:提供图查询接口,可查询资源、堆栈及其关系,结果按调用者可见的堆栈和账户裁剪。返回结果带有完整性信号,如 meta.resultMode、meta.visibility、pageInfo.continuationToken,用于判断结果是否完整。

使用方式:若会话中已有图工具(如 graph_query 和 get_graph_schema),直接调用并跳过前两步。否则需 Pulumi CLI v3.243.0 或更新版本并已 pulumi login,先执行 pulumi api GetGraphQuerySchema --output=markdown 获取选择器编写指南,再执行 pulumi api GraphQuery -F orgName=<org> --input selector.json 查询,请求体是 JSON 选择器而非查询文本。应显式指定组织名,可用 pulumi whoami -v 列出可访问组织。

适用场景:关系型问题、影响分析、依赖排查、清理清单等。

限制:处于公开预览阶段,仅面向 Enterprise 和 Business Critical 版本组织,且需要授予 resources:search 的角色(默认 Member 和 Admin 角色具备)。图仅返回每种节点类型 schema 声明的字段子集,不是完整资源属性包;需要属性值本身时应改用 Resource Search。完整性声明需所有信号均正常,否则应说明答案覆盖范围。具体边界以 primer 的“What it cannot answer yet”为准。