用途
本技能用于通过阿里云 OpenAPI(RPC)管理 DataAnalysisGBI 资源。当用户需要执行 DataAnalysisGBI 的资源生命周期操作、配置变更、状态查询等任务时,可使用本技能。
主要能力
- 通过官方 SDK 或 OpenAPI Explorer 调用阿里云 OpenAPI(RPC)管理 DataAnalysisGBI 资源。
- 支持资源清单/列表查询、变更/配置、状态/故障排查等高频操作模式。
- 提供 API 发现能力,可通过 OpenAPI 元数据接口列出 API 并获取 schema。
使用方式
工作流程:
- 确认地域、资源标识和期望执行的操作。
- 发现 API 列表及所需参数(参见参考资料)。
- 使用 SDK 或 OpenAPI Explorer 调用 API。
- 通过 describe/list API 验证结果。
凭证优先级(必须遵循):
- 环境变量:ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID
- 地域策略:ALICLOUD_REGION_ID 为可选默认值。若未设置,需为任务决定最合理的地域;若仍不明确,应询问用户。
- 共享配置文件:~/.alibabacloud/credentials
API 发现:
- 产品代码:DataAnalysisGBI
- 默认 API 版本:2024-08-23
- 使用 OpenAPI 元数据端点列出 API 并获取 schema(参见参考资料)。
高频操作模式:
- 清单/列表:优先使用 List* / Describe* API 获取当前资源。
- 变更/配置:优先使用 Create* / Update* / Modify* / Set* API 执行变更。
- 状态/故障排查:优先使用 Get* / Query* / Describe*Status API 进行诊断。
最小可执行快速开始:
在调用业务 API 前,先进行元数据优先的发现:
python scripts/list_openapi_meta_apis.py
可选覆盖参数:
python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>
该脚本会将 API 清单产物写入技能输出目录。
输出策略:
如需保存响应或生成的产物,请写入: output/alicloud-data-analytics-dataanalysisgbi/
验证:
mkdir -p output/alicloud-data-analytics-dataanalysisgbi for f in skills/data-analytics/alicloud-data-analytics-dataanalysisgbi/scripts/*.py; do python3 -m py_compile "$f" done echo "py_compile_ok" > output/alicloud-data-analytics-dataanalysisgbi/validate.txt
通过标准:命令退出码为 0,且生成 output/alicloud-data-analytics-dataanalysisgbi/validate.txt。
输出与证据:
- 将产物、命令输出和 API 响应摘要保存在 output/alicloud-data-analytics-dataanalysisgbi/ 下。
- 在证据文件中包含关键参数(地域/资源 ID/时间范围)以便复现。
适用场景
- 需要管理 DataAnalysisGBI 资源的生命周期操作。
- 需要变更 DataAnalysisGBI 配置。
- 需要查询 DataAnalysisGBI 资源状态或进行故障排查。
限制
- 执行前需配置最小权限的阿里云凭证。
- 优先使用环境变量:ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET、可选的 ALICLOUD_REGION_ID。
- 若地域不明确,在执行变更操作前应先询问用户。
- 参考资料:references/sources.md。