alibabacloud-mongodb-instances-manage

阿里云 MongoDB 实例管理技能用于对阿里云云数据库 MongoDB 版实例进行全生命周期管理，覆盖单节点、副本集和分片集群三种实例类型。

一、用途 该技能面向需要通过命令行创建和管理阿里云 MongoDB 实例的场景，包括实例的创建、查询、变配、删除，以及分片集群的节点管理、安全配置等操作。

二、主要能力

1. 实例创建：支持创建单节点（开发/测试）、副本集（读密集）和分片集群（高并发）实例。
2. 实例查询：支持查询实例列表、单实例详情以及所有支持的地域。查询列表时需按实例类型分别查询，未指定 --db-instance-type 时默认仅返回副本集，会遗漏分片集群。
3. 实例变配：支持修改副本集实例配置，包括规格、存储、副本数、只读副本数等。不支持存储降配、实例类型变更和存储类型变更。
4. 实例删除：支持删除按量付费实例；包年包月实例不能直接删除。删除前需检查备份保留策略并展示确认信息。
5. 分片集群节点管理：支持添加单个节点、批量添加节点、修改节点规格等。必须保留至少 2 个 Mongos 和 2 个 Shard，最多 32 个。
6. 安全配置：实例创建完成后可引导进行 root 密码设置、IP 白名单、ECS 安全组绑定、全局白名单模板关联、维护窗口修改、公网地址分配等。

三、使用方式

1. 环境要求：需安装阿里云 CLI 且版本不低于 3.3.3，运行 aliyun version 验证。
2. 插件安装：需运行 aliyun configure set --auto-plugin-install true 启用自动插件安装，运行 aliyun plugin update 更新插件，并安装 dds、kms、resourcemanager、bssopenapi 插件。
3. AI-Mode：执行前需运行 aliyun configure ai-mode enable 并设置 User-Agent；所有退出路径均需先运行 aliyun configure ai-mode disable。
4. 命令调用：每条 aliyun CLI 命令均需携带 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-mongodb-instances-manage。
5. 凭证检查：仅使用 aliyun configure list 检查凭证状态，禁止读取或打印 AK/SK。
6. 参数确认：执行任何创建或修改操作前，必须展示完整参数列表并获得用户 Y/Yes 确认。
7. 状态预检：执行非查询操作前，必须调用 describe-db-instance-attribute 检查 DBInstanceStatus，仅 Running 状态可下发操作。
8. VPC/VSwitch 校验：即使用户已提供 VPC/VSwitch ID，也必须使用 DDS 专用 API（describe-rds-vpcs、describe-rds-vswitchs）校验，禁止使用通用 VPC API。

四、适用场景 适用于需要通过命令行批量或自动化管理阿里云 MongoDB 实例的运维与开发场景，包括实例创建、规格调整、节点扩缩容、实例删除以及创建后的安全配置引导。

五、限制

1. 存储降配、实例类型变更、存储类型变更不支持。
2. 单节点实例部分地域/可用区不支持，需先查询 describe-available-resource --replication-factor 1。
3. 分片集群节点修改 modify-node-spec 必须严格串行，需等待上一次修改完成。
4. 批量修改 modify-node-spec-batch 不支持修改 Shard 只读副本数。
5. 包年包月实例不能直接删除。
6. 写操作后仅展示 RequestId（及可用的 DBInstanceId/OrderId），不得自动轮询，需用户确认后再轮询。
7. 不得提供无官方文档依据的时间估算。
8. 权限不足时需引导用户参考 RAM 策略文档申请权限，等待确认后再重试。

六、其他说明 实例创建通常需要 10-25 分钟达到 Running 状态。创建后根据用户是否有后续操作决定是否自动轮询。包年包月实例需显示剩余天数，10 天内到期需在列表下方警告并引导续费。