MongoDB Atlas Azure ARM 管理技能
帮助 .NET 开发者通过 Azure Marketplace 管理 MongoDB Atlas 组织资源。
文档明确说明 Azure ARM 资源范围，并列出认证变量与客户端密钥风险，且没有隐蔽外传或恶意行为证据；但创建、更新和删除均会产生外部资源变更，未要求用户确认、说明最小 RBAC 权限、数据流、敏感信息处理或回滚恢复，因此扣分。
安装依赖、核心类型、主要工作流、长时间操作和常见错误均有说明，静态上主路径可理解；但未提供该技能专属测试或已复现证据，部分 SDK 签名、API 版本和 Marketplace 参数无法仅凭文件确认，异常输入与失败诊断覆盖有限，因此受静态上限限制并扣分。
目标受众、适用场景以及不直接管理 Atlas 集群、数据库、集合和用户的边界写得清楚，覆盖创建、读取、列表、更新和删除；但没有明确触发条件、非适用场景的更细分类、中文支持或中国大陆网络可达性说明，因此扣分。
结构清晰，包含安装、认证、类型、工作流、模型、状态、错误和最佳实践；有 MIT 许可证、作者和版本字段，也有官方文档链接。但缺少变更日志、兼容性矩阵、维护责任人的明确更新路径、FAQ 和已知限制的系统化说明，因此扣分。
示例覆盖组织资源的主要生命周期，并给出可直接改写的 C# 代码；但示例含占位订阅信息、固定 Marketplace offer 参数和示例邮箱，未证明代码可编译或端到端成功，删除流程也没有恢复指导，因此按静态评估上限计分并扣分。
技能提供版本、API 版本、NuGet、Microsoft Learn、API Reference 和 Azure SDK 仓库引用，具备一定可审计性；仓库还显示通用 CI 和测试基础设施，但未显示覆盖该技能关键路径的专属测试或第三方执行结果，因此不超过静态上限并扣分。
- 执行创建、更新或删除前应明确获得用户确认，并核对订阅、资源组、组织名称和 RBAC 权限。
- 不要把 AZURE_CLIENT_SECRET、邮箱或其他个人信息直接写入源代码、日志或提示词；应补充安全存储与脱敏要求。
- 应使用与实际 NuGet/API 版本匹配的官方文档验证示例，尤其是 Marketplace offer、term 和 patch 参数。
- 删除操作缺少回滚或恢复说明；应先确认资源依赖、保留必要导出，并说明不可逆后果。
- 未提供中文说明或中国大陆网络可达性证据，相关用户需自行验证 Azure、NuGet 和文档访问条件。
它能做什么 & 适用场景
该技能指导开发者使用 Azure.ResourceManager.MongoDBAtlas SDK，将 MongoDB Atlas 组织作为 Azure ARM 资源进行管理。它覆盖组织的创建、读取、列表查询、标签和属性更新，以及删除操作。技能还说明 Azure 身份验证、Marketplace 订阅详情、资源状态和常见错误处理。它不直接管理 Atlas 集群、数据库、集合或用户角色。
提供 Azure.ResourceManager.MongoDBAtlas、Azure.Identity 和 Azure.ResourceManager 的安装命令与 C# 示例；指导使用 DefaultAzureCredential 和 ArmClient 访问 Azure；创建并获取 MongoDB Atlas 组织 ARM 资源；按资源组或订阅列出组织；更新标签和组织用户属性；处理创建、更新、删除等长时间运行操作；检查资源调配状态和 Marketplace 订阅状态；解释 ResourceNotFound、AuthorizationFailed、InvalidParameter 和 MarketplaceError 等错误。
- 需要通过 Azure Marketplace 为 MongoDB Atlas 组织配置统一计费的 .NET 开发者。
- 需要在 Azure 资源组中创建、读取或删除 MongoDB Atlas 组织的云平台工程师。
- 需要按订阅或资源组盘点 Atlas 组织及其调配状态的运维人员。
- 需要通过 Azure ARM 更新组织管理员信息或资源标签的应用团队。
- 已经创建 Azure 侧组织资源、但需要通过 MongoDB Atlas API 管理集群和数据库的团队。
优缺点一览
- 覆盖组织资源的完整 ARM 生命周期，包括创建、读取、列表、更新和删除。
- 提供可复制的 C#、身份验证、Marketplace 配置和长时间运行操作示例。
- 明确区分 Azure 侧组织资源与 MongoDB Atlas 内部集群和数据库管理。
- MIT 许可，且 README 说明仓库持续开发并通过测试框架维护技能质量。
- 不能直接管理 Atlas 集群、数据库、集合或用户和角色。
- 需要 Azure 订阅、资源组权限以及正确的 Marketplace offer 详情。
- 源材料没有提供该特定技能的独立测试覆盖证据。
- 源材料没有说明除 .NET 和 Azure SDK 示例之外的运行时平台支持。
如何安装
先运行 npx skills add microsoft/skills，在安装向导中选择此技能。技能源路径为 .github/plugins/azure-sdk-dotnet/skills/azure-mgmt-mongodbatlas-dotnet/SKILL.md；README 说明技能会安装到所选 Agent 的目录，例如 GitHub Copilot 使用 .github/skills/。然后在 .NET 项目中运行：dotnet add package Azure.ResourceManager.MongoDBAtlas、dotnet add package Azure.Identity、dotnet add package Azure.ResourceManager。
如何使用
向编码 Agent 提出具体请求，例如“使用 Azure.ResourceManager.MongoDBAtlas 创建名为 my-atlas-org 的 Azure ARM 组织资源，并配置 Marketplace 订阅详情”。准备 AZURE_SUBSCRIPTION_ID 和 AZURE_RESOURCE_GROUP；若使用服务主体，可设置 AZURE_TENANT_ID、AZURE_CLIENT_ID 和 AZURE_CLIENT_SECRET。技能中的 C# 示例使用 DefaultAzureCredential、ArmClient 和异步 ARM 操作。
对比同类
与 MongoDB Atlas API 直接管理相比，此技能面向 Azure ARM 和 Azure Marketplace 集成，负责 Azure 侧的 Atlas 组织资源；集群和数据库管理仍需使用 MongoDB Atlas API。