Azure API Center .NET 技能
用 .NET 管理 Azure API 清单、治理、版本和部署发现。
技能仅展示 Azure SDK 身份认证、资源创建和规格导入等预期操作，未见恶意行为、凭据窃取或隐蔽外传；但未说明最小 RBAC 权限、用户确认、敏感 API 规格处理、变更影响、回滚或恢复，因此扣分。
覆盖服务、工作区、API、版本、定义、环境、部署、元数据和列表流程，并提供有限的 Azure 异常处理；但没有该技能专属测试、重试/幂等指导，且若干 C# 示例的可编译性存在疑问，因此静态评分保持在 10 分以下。
触发词、.NET 目标 SDK 和主要使用场景较明确；但未声明非适用范围、前置 Azure 资源/RBAC 条件、输入输出边界，也未提供中文支持或中国大陆网络可达性说明，因此扣分。
具备清晰章节、安装命令、环境变量、资源层级、工作流、类型表、最佳实践、错误处理、许可证、作者和版本元数据；但缺少变更日志、维护责任人/更新路径、兼容性说明和已知限制，因此扣分。
内容覆盖 API Center 常见管理任务，示例对熟悉 Azure 的 .NET 开发者有直接参考价值；但示例可能需要修正，缺少端到端验证、权限配置、现有资源处理和完整项目上下文，因此只能评为部分有效。
提供 NuGet、API、产品文档和 GitHub 源码链接，并声明 API/包版本；但本次仅有静态材料，未见该技能专属 CI、提交测试或第三方执行证据，核心示例无法在材料内独立复现，因此分数较低。
- 创建、更新和导入操作可能产生外部 Azure 资源变更或写入 API 规格；使用前应确认目标订阅、资源组、RBAC 权限和回滚方案。
- 示例未提供完整可编译项目，尤其应核验 DefaultAzureCredential 用法、集合初始化语法、包版本与 API 模型。
- 未说明 API 规格、联系人和自定义元数据中的敏感信息如何保护，也未说明中国大陆网络环境下相关文档和 Azure 服务的可达性。
它能做什么 & 适用场景
该技能为 Azure.ResourceManager.ApiCenter .NET SDK 提供面向编码代理的操作指南和代码模式。它覆盖 API Center 服务、工作区、API、版本、定义、环境、部署和元数据架构的创建与管理。内容还包括 DefaultAzureCredential 认证、OpenAPI 规范导入导出、API 列表查询及 Azure 异常处理。适合使用 Azure API Center 维护组织级 API 清单和治理流程的 .NET 开发者。
指导代理安装 Azure.ResourceManager.ApiCenter 与 Azure.Identity，读取 Azure 订阅、资源组和 API Center 服务配置，并生成 C# 代码。代码可创建或更新 API Center 服务、工作区、API、API 版本、API 定义、环境、部署和元数据架构；导入或导出 OpenAPI 等 API 规范；遍历工作区中的 API、版本、环境和部署；并处理 400、409 及其他 RequestFailedException 错误。
- 平台团队为组织创建 API Center 服务，并按团队或产品建立工作区。
- .NET 开发者将 API、生命周期阶段、联系人、外部文档和自定义属性登记到 API 清单。
- 治理团队为 API 定义元数据架构，并要求 API 填写团队、成本中心或数据分类。
- 开发团队上传 OpenAPI 规范、管理 API 版本，并导出规范供其他流程使用。
- 运维或平台团队记录开发、测试、预发布和生产环境，并将 API 定义关联到部署。
优缺点一览
- 覆盖 API Center 资源层级和主要生命周期操作。
- 提供可复制的 C# 异步示例，包括规范导入导出、部署关联和元数据治理。
- 明确使用 Azure API 版本 2024-03-01、SDK v1.0.0 GA 和 MIT 许可证。
- 包含认证、环境变量、资源类型、最佳实践和常见 Azure 错误处理。
- 内容聚焦 Azure.ResourceManager.ApiCenter .NET，不是通用 API 管理或网关技能。
- 示例依赖 Azure 订阅、资源组和 API Center 服务；源材料未提供本地模拟环境或完整测试套件。
- 源材料未说明除列出的代理安装方式外的其他客户端安装细节。
如何安装
在支持该集合的环境中运行 npx skills add microsoft/skills，通过向导选择需要的技能。技能会安装到所选代理的目录，例如 GitHub Copilot 使用 .github/skills/；也可以从仓库复制或链接对应技能目录。该技能的源文件位于 .github/plugins/azure-sdk-dotnet/skills/azure-mgmt-apicenter-dotnet/SKILL.md。使用 SDK 时安装：dotnet add package Azure.ResourceManager.ApiCenter 和 dotnet add package Azure.Identity。
如何使用
在编码代理中提出包含 “API Center”、ApiCenterService、ApiCenterWorkspace、ApiCenterApi、API inventory、API governance、API versioning、API catalog 或 API discovery 的任务。提供 Azure 订阅 ID、资源组名和 API Center 服务名；若使用 DefaultAzureCredential 进行生产认证，还需设置 AZURE_TOKEN_CREDENTIALS=prod 或指定凭据。代理可据此生成使用 ArmClient 的 C# 管理代码。
对比同类
与 Azure.ResourceManager.ApiManagement 不同，本技能面向 API Center 的 API 清单、治理、版本、定义、环境和部署登记；源材料将 API Management SDK 定位为 API 网关和策略管理。