用途:通过 Aliyun CLI 插件模式管理阿里云 DataHub 资源的全生命周期,按 Region → Project → Topic → Subscription 层级进行创建、查询、更新与删除。
前提条件:需 Aliyun CLI 版本不低于 3.3.3(可用 aliyun version 校验);需执行 aliyun configure set --auto-plugin-install true 启用插件自动安装,并运行 aliyun plugin update 更新插件;需具备有效的阿里云凭证(AK、STS 或 OAuth 身份),可用 aliyun configure list 查看凭证状态。RAM 权限包括 dhs:ListProjects、dhs:CreateProject、dhs:GetProject、dhs:UpdateProject、dhs:DeleteProject、dhs:ListTopics、dhs:CreateTopic、dhs:GetTopic、dhs:UpdateTopic、dhs:DeleteTopic、dhs:ListSubscriptions、dhs:CreateSubscription、dhs:GetSubscription、dhs:DeleteSubscription。
主要能力与用法:
- Project:aliyun datahub list-projects 检查冲突,create-project 创建,get-project 验证。
- Topic:create-topic 支持 BLOB(二进制)或 TUPLE(结构化,需 --record-schema),指定 --shard-count 与 --lifecycle,可 update-topic 修改描述。
- Subscription:create-subscription 支持自动生成或手动指定 subscription-id,并用 get-subscription 验证。
- 清理:按 Subscription → Topic → Project 逆序删除,删除前须列出待删资源并获得用户明确确认,删除 Project 会移除其下所有 Topic、数据与订阅且不可恢复。
限制与安全:每个调用云 API 的 aliyun 命令必须附带 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-datahub-manage/{session-id};不得读取、回显或打印 AK/SK,不得在对话或命令行索要凭证,不得用字面量凭证执行 aliyun configure set;所有用户自定义参数(区域、名称、分片数、生命周期等)须在用户确认后才可执行;权限失败时须查阅参考策略并引导用户申请权限,等待确认后再继续。
参考文档:references/ram-policies.md、related-commands.md、verification-method.md、acceptance-criteria.md、cli-installation-guide.md,以及 DataHub 产品文档与帮助中心。