开发与工程 ✓ Microsoft · 官方

Azure API 管理 .NET 管理 SDK

用 .NET 创建、配置和治理 Azure API Management 资源。

48/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 2.7k
最近更新
3 个月前
License
MIT
azure-api-managementdotnetresource-managerapi-policies
+2azure-sdkcloud-provisioning

这个 Skill 能做什么,适合哪些场景?

这是一个面向 Azure API Management 管理平面的 Agent Skill,指导开发者使用 Azure.ResourceManager.ApiManagement 进行资源操作。它覆盖 APIM 服务、API、产品、订阅、策略、用户、组、网关和后端等资源。内容包括安装、DefaultAzureCredential 身份验证、资源层级导航、异步 CRUD、备份恢复和错误处理示例。它不用于通过 APIM 网关直接调用 API 的数据平面操作。

指导安装 Azure.ResourceManager.ApiManagement 和 Azure.Identity,配置 Azure 订阅及身份验证环境变量,并使用 ArmClient 导航订阅、资源组和 APIM 服务。它提供创建或更新 APIM 服务、API、产品和订阅的 C# 示例,展示获取订阅密钥、设置 XML API 策略、备份与恢复服务,以及处理 RequestFailedException 的方法。

适合
  • 负责 Azure 基础设施的 .NET 工程师,需要以代码创建或更新 APIM 服务。
  • API 平台团队需要管理 API、产品、订阅及访问策略。
  • 开发者需要通过 ARM SDK 配置 APIM 用户、组、后端或自托管网关。
  • 运维或平台工程师需要执行 APIM 服务备份与恢复。
  • 需要使用 DefaultAzureCredential 和幂等 CreateOrUpdateAsync 模式开发 Azure 管理程序的团队。

如何安装这个 Skill?

使用前请注意
  • 执行创建、更新、删除、恢复或订阅密钥操作前,应补充明确的用户确认、权限范围、影响评估和可恢复方案。
  • 不要在日志或终端输出订阅密钥,也不要使用示例中的明文密码;应采用安全密钥存储和轮换。
  • 当前版本 v1.3.0、代码签名及若干 SDK 类型用法应在目标项目中通过编译和集成测试确认。
  • 核心功能依赖 Azure ARM、Azure.Identity 和 .NET SDK;应验证目标网络、租户权限及中国大陆环境的服务可达性。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
需要预先安装
  • .NET SDK
  • Azure.ResourceManager.ApiManagement
  • Azure.Identity

在项目中运行:

npx skills add microsoft/skills

在安装向导中选择此技能。README 说明技能会安装到所选 Agent 的目录,例如 GitHub Copilot 使用 .github/skills/,并可在多个 Agent 配置之间建立符号链接。若手动复制,应使用技能目录 .github/plugins/azure-sdk-dotnet/skills/azure-mgmt-apimanagement-dotnet/。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.github/plugins/azure-sdk-dotnet/skills/azure-mgmt-apimanagement-dotnet" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 使用 Azure.ResourceManager.ApiManagement 和 DefaultAzureCredential 创建一个 Developer SKU 的 APIM 服务,并创建 API、产品和订阅。

在已安装该技能的编码 Agent 中提出明确的管理平面任务,例如:"使用 Azure.ResourceManager.ApiManagement 和 DefaultAzureCredential 创建一个 Developer SKU 的 APIM 服务,并创建 API、产品和订阅。" 也可以请求设置 API 策略、执行备份恢复或处理 ARM 错误。直接调用 APIM 网关的数据平面不属于此技能范围。

这个 Skill 有哪些优点和局限?

优点
  • 提供从 ArmClient 到 APIM 子资源的完整资源层级示例。
  • 覆盖服务、API、产品、订阅、策略、备份恢复和错误处理等常见管理任务。
  • 明确区分管理平面与数据平面,降低 SDK 使用范围混淆。
  • 包含 DefaultAzureCredential、幂等更新和长时间运行操作的实践建议。
  • MIT 许可,且隶属于持续更新的 Microsoft Agent Skills 集合。
局限
  • 仅覆盖 Azure API Management 管理平面,不提供网关数据平面调用指导。
  • 服务创建可能耗时 30 分钟以上,示例中的 Developer SKU 主要适合开发测试且无 SLA。
  • 源内容未说明该单项技能的独立测试场景或平台兼容性验证结果。
  • 需要 Azure 订阅、相应权限和 .NET 项目环境;具体 RBAC 权限未在源内容中列出。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Azure API 管理 .NET 管理 SDK 本页 ✓ Microsoft · 官方 48 · 谨慎使用 ★ 2.7k 3 个月前 MIT
Azure Redis 管理 SDK(.NET) ✓ Microsoft · 官方 48 · 谨慎使用 ★ 2.7k 3 个月前 MIT
Azure Playwright 工作区管理技能 ✓ Microsoft · 官方 54 · 谨慎使用 ★ 2.7k 3 个月前 MIT
Azure Durable Task 资源管理器技能 ✓ Microsoft · 官方 49 · 谨慎使用 ★ 2.7k 3 个月前 MIT
Azure Cosmos DB .NET 资源管理技能 ✓ Microsoft · 官方 54 · 谨慎使用 ★ 2.7k 3 个月前 MIT

与 APIM 数据平面调用相比,本技能专注于通过 Azure Resource Manager 创建和管理服务、API、产品、订阅及策略;它不指导直接向 APIM 网关端点发起业务 API 请求。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
48/ 100 五分制 2.4 / 5
1信任安全14 / 25 · 2.8/5

文档明确区分管理面与数据面,并建议使用 DefaultAzureCredential、避免硬编码密钥;但示例可创建、修改、删除 APIM 资源,包含恢复操作、订阅密钥输出和明文密码示例,缺少最小权限、用户确认、敏感数据保护、影响披露及可验证回滚说明,因此扣分。

2可靠稳定7 / 20 · 1.8/5

覆盖服务、API、产品、订阅、策略及错误处理等主要路径,且提供部分异常处理;但版本、API 签名和示例完整性未在本技能内验证,存在长时间操作、资源状态、输入校验和边界失败反馈不足。按静态校准,未超过 10 分。

3适用触发9 / 15 · 3.0/5

名称、受众、管理面范围和触发词较清晰,并说明不负责网关数据面调用;但未充分声明不适用场景、权限前提、区域限制或中文使用边界,且 Azure/.NET 依赖会限制非 Azure 环境的适用性。

4规范维护8 / 15 · 2.7/5

具备 front matter、MIT 许可、作者和版本字段,文档按安装、认证、工作流、参考文件分层,并提供多个示例;但没有变更日志、明确维护责任和更新路径,缺少依赖版本锁定、故障排查和已知限制说明。

5有效结果6 / 15 · 2.0/5

能够直接提供常见 APIM 管理操作的 .NET 代码模式,具有较明显的手写替代价值;但示例未显示经过该技能专属测试,部分代码依赖上下文或可能需要 API 版本调整,安全敏感和破坏性操作仍需较多人工审查,因此未给高分。按静态校准,未超过 7 分。

6证据核验4 / 10 · 2.0/5

技能包含可审计的代码、包名、官方文档引用和仓库级 CI/测试材料;但提供的 CI 与测试并未证明该选定技能的关键路径,缺少技能专属 acceptance criteria、执行结果或独立复现证据。按静态校准,未超过 5 分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 9ccaf7c3704a 评估证据[1][2][3][4][5][6][7][8][9][10][11][12][13]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能需要付费吗?
技能仓库采用 MIT 许可证。源内容没有说明 Azure API Management 资源本身的费用。
它能直接调用我的 API 网关吗?
不能。SKILL.md 明确将直接调用 APIM 网关端点归为数据平面,而本技能面向管理平面。
生产环境应如何进行身份验证?
内容建议使用 DefaultAzureCredential,并在生产环境设置 AZURE_TOKEN_CREDENTIALS=prod,或直接使用 ManagedIdentityCredential 等具体凭据。
长时间运行的操作如何处理?
必须等待完成时使用 WaitUntil.Completed;对于服务创建等可能持续 30 分钟以上的操作,最佳实践也建议考虑 WaitUntil.Started。

同仓库的其他 Skills

均来自 microsoft/agent-skills

开发与工程 ✓ Microsoft · 官方

Azure Redis 管理 SDK(.NET)

帮助 .NET 开发者通过 Azure Resource Manager 配置和管理 Azure Cache for Redis。

★ 2.7k FS 48 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Playwright 工作区管理技能

用 .NET 通过 Azure Resource Manager 配置和管理 Microsoft Playwright Testing 工作区。

★ 2.7k FS 54 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Durable Task 资源管理器技能

帮助 .NET 开发者通过 Azure Resource Manager 配置和管理 Durable Task Scheduler。

★ 2.7k FS 49 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Cosmos DB .NET 资源管理技能

用 .NET 通过 ARM 部署和管理 Azure Cosmos DB 资源。

★ 2.7k FS 54 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure 文档智能 .NET 技能

帮助 .NET 开发者从发票、收据、身份证件和表单中提取结构化信息。

★ 2.7k FS 45 不推荐 3 个月前
开发与工程 ✓ Microsoft · 官方

Fabric 容量管理助手(.NET)

用 .NET 通过 Azure Resource Manager 管理 Microsoft Fabric 容量。

★ 2.7k FS 53 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

MongoDB Atlas Azure ARM 管理技能

帮助 .NET 开发者通过 Azure Marketplace 管理 MongoDB Atlas 组织资源。

★ 2.7k FS 51 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure API Center .NET 技能

用 .NET 管理 Azure API 清单、治理、版本和部署发现。

★ 2.7k FS 48 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Bot Service 管理 SDK(.NET)

帮助 .NET 开发者通过 ARM 创建和管理 Azure Bot 及其渠道。

★ 2.7k FS 48 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure MySQL Flexible Server .NET 技能

帮助 .NET 开发者以 Azure SDK 管理 MySQL Flexible Server 及其数据库资源。

★ 2.7k FS 45 不推荐 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure API Management Python 技能

帮助编码代理使用 Python SDK 管理 Azure API Management 的服务、API、产品、订阅与策略。

★ 2.7k FS 54 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

MCP 服务器开发指南

帮助开发者为外部 API 构建结构清晰、可测试、便于 LLM 使用的 MCP 服务器。

★ 2.7k FS 49 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure SQL .NET 管理技能

用 .NET 部署和管理 Azure SQL 资源。

★ 2.7k FS 46 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure PostgreSQL Flexible Server .NET 技能

用 .NET 管理 Azure PostgreSQL Flexible Server 的部署、配置与运维。

★ 2.7k FS 35 不推荐 3 个月前
自动化与运维 ✓ Microsoft · 官方

Azure AI 网关治理

用 Azure API Management 统一治理 AI 模型、MCP 工具和智能体流量。

★ 2.7k FS 55 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Event Grid .NET 技能

为 .NET 应用提供发布、接收和处理 Azure Event Grid 事件的实用指导。

★ 2.7k FS 53 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Rust Blob 存储技能

帮助 Rust 开发者使用官方 Azure SDK 管理 Blob 和容器。

★ 2.7k FS 53 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Arize AI Azure 管理 SDK 技能

帮助 .NET 开发者通过 Azure 管理 Arize AI 可观测性资源。

★ 2.7k FS 49 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure 技能创建指南

帮助编码代理创建结构清晰、精简且可验证的 Azure SDK 技能。

★ 2.7k FS 48 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Event Hubs .NET 技能

为 .NET 开发者提供 Azure Event Hubs 高吞吐事件发送、接收与检查点处理指南。

★ 2.7k FS 47 谨慎使用 3 个月前

相关 Skills