search-consumption-cli

Name: search-consumption-cli
Author: microsoft

跨工作区查找 Microsoft Fabric 项目并返回所属工作区与相关 ID。

星标

★ 821

来源

GitHub

更新于

2026-07-18

// 安全评估低风险

仅提示词，不执行代码
开源可审计
社区验证· 821

正在进行安全审计…

凭证密钥
网络外发
代码执行
数据访问
来源供应链

// 安装

复制安装指令，让 AI 自动完成配置 · 推荐新手

请帮我安装 askskill 上的 "search-consumption-cli" 技能：
1. 下载 https://raw.githubusercontent.com/microsoft/skills-for-fabric/main/skills/search-consumption-cli/SKILL.md
2. 保存为 ~/.claude/skills/search-consumption-cli/SKILL.md
3. 装好后重载技能，告诉我可以用了

// 下载

下载 SKILL.md机读安装清单 ↗

// 用法示例

按名称查找项目

输入

帮我在所有 Microsoft Fabric 工作区中查找名为“Sales Lakehouse”的项目，并告诉我它所在的工作区名称、项目类型以及对应的工作区 ID 和项目 ID。

预期产出

返回匹配项目列表，包含项目名称、类型、所属工作区及相关 ID。

列出某类项目

输入

列出我在所有 Microsoft Fabric 工作区中拥有的所有 Lakehouse，并按工作区分组显示每个项目的名称和 ID。

预期产出

按工作区分组的项目清单，展示每个 Lakehouse 的名称与 ID。

确认项目在哪个工作区

输入

我想知道“Marketing Dashboard”在哪个 Microsoft Fabric 工作区里。如果有多个同名项目，请全部列出并返回工作区 ID 和项目 ID。

预期产出

返回包含该项目的工作区信息；若有重名，则列出所有匹配结果及其 ID。

// 文档

Update Check — ONCE PER SESSION (mandatory) The first time this skill is used in a session, run the check-updates skill before proceeding.

GitHub Copilot CLI / VS Code: invoke the check-updates skill (e.g., /fabric-skills:check-updates).

Claude Code / Cowork / Cursor / Windsurf / Codex: read the local package.json version, then compare it against the remote version via git fetch origin main --quiet && git show origin/main:package.json (or the GitHub API). If the remote version is newer, show the changelog and update instructions.

Skip if the check was already performed earlier in this session.

CRITICAL NOTES

The Catalog Search API finds items, not workspaces. To find a workspace by name, use GET /v1/workspaces (see COMMON-CLI.md § Resolve Workspace Properties by Name).

The search text matches against item display name, description, and workspace name.

Dataflow (Gen1) and Dataflow (Gen2) are not supported.

Catalog Search — CLI Skill

Prerequisite Knowledge

COMMON-CORE.md — Fabric REST API patterns, auth
COMMON-CLI.md — CLI implementation (az, curl, jq)

Task	Reference	Notes
Search for an Item	SKILL.md § Search for an Item	By name, description, or workspace name
List All Items of a Type	SKILL.md § List All Items of a Type	Empty search + type filter
Pagination	SKILL.md § Pagination	Continuation token pattern
Agentic Workflow	SKILL.md § Agentic Workflow
Examples	SKILL.md § Examples
Gotchas and Troubleshooting	SKILL.md § Gotchas and Troubleshooting

Must/Prefer/Avoid

MUST DO

Authenticate first — see COMMON-CORE.md § Authentication & Token Acquisition and COMMON-CLI.md § Authentication Recipes. The Catalog Search API requires Catalog.Read.All scope.
Write the JSON body to a temp file — avoids shell quoting issues with filter strings.
Disambiguate — if multiple results match, present display name, type, and workspace name and ask the user to confirm.

PREFER

Catalog Search over list-and-filter — single cross-workspace call, no need to resolve workspace first.
Type filters — narrow results with "filter": "Type eq 'Lakehouse'" to reduce noise.
Empty search with type filter — to list all items of a type across workspaces.
jq for extracting IDs from the response — cleaner than JMESPath for nested hierarchy.workspace.

AVOID

Searching for workspaces — the Catalog Search API returns items, not workspaces. Use GET /v1/workspaces instead (see COMMON-CLI.md § Resolve Workspace Properties by Name).
Inventing filter syntax — only eq, ne, or, and parentheses are supported.
Assuming all item types are supported — Dataflow (Gen1) and Dataflow (Gen2) are not returned yet.

Search for an Item

cat > /tmp/body.json << 'EOF'
{"search": "SalesLakehouse", "filter": "Type eq 'Lakehouse'", "pageSize": 10}
EOF
az rest --method post \
  --resource "https://api.fabric.microsoft.com" \
  --url "https://api.fabric.microsoft.com/v1/catalog/search" \
  --body @/tmp/body.json

The search text matches against item display name, description and workspace name. Type filtering is optional. The response includes id, type, displayName, description, and hierarchy.workspace (with id and displayName) for each match.