SuperAPI AI 工具集

alicloud-data-lake-dlf-next

数据与分析

查看项目

更新于 10-15 09:02

技能介绍

用途

该技能用于通过阿里云 OpenAPI(RPC)配合官方 SDK 或 OpenAPI Explorer,管理数据湖构建(Data Lake Formation,简称 DLF Next)的目录与治理资源。当用户需要执行 DLF Next 的目录/治理资源操作时适用。

主要能力

  • 通过 OpenAPI 管理 Data Lake Formation 资源。
  • 支持 API 发现:产品代码为 DlfNext,默认 API 版本为 2025-03-10,可使用 OpenAPI 元数据端点列出 API 并获取 schema。
  • 提供高频操作模式:
    • 清单/列表:优先使用 List* / Describe* API 获取当前资源。
    • 变更/配置:优先使用 Create* / Update* / Modify* / Set* API 执行变更。
    • 状态/排障:优先使用 Get* / Query* / Describe*Status API 进行诊断。

使用方式

工作流程:

  1. 确认地域、资源标识与目标操作。
  2. 发现 API 列表及所需参数(参见参考资料)。
  3. 通过 SDK 或 OpenAPI Explorer 调用 API。
  4. 使用 describe/list 类 API 验证结果。

凭证优先级(必须遵循):

  • 环境变量:ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID。
  • 地域策略:ALICLOUD_REGION_ID 为可选默认值。若未设置,需为任务决定最合理的地域;若仍不明确,询问用户。
  • 共享配置文件:~/.alibabacloud/credentials。

最小可执行快速开始: 在调用业务 API 前先进行元数据优先的发现:

python scripts/list_openapi_meta_apis.py

可选覆盖参数:

python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>

该脚本会将 API 清单产物写入技能输出目录。

输出策略: 如需保存响应或生成的产物,请写入: output/alicloud-data-lake-dlf-next/

验证:

mkdir -p output/alicloud-data-lake-dlf-next for f in skills/data-lake/alicloud-data-lake-dlf-next/scripts/*.py; do python3 -m py_compile "$f" done echo "py_compile_ok" > output/alicloud-data-lake-dlf-next/validate.txt

通过标准:命令退出码为 0,且生成 output/alicloud-data-lake-dlf-next/validate.txt。

输出与证据:

  • 将产物、命令输出与 API 响应摘要保存至 output/alicloud-data-lake-dlf-next/。
  • 在证据文件中包含关键参数(地域/资源 ID/时间范围)以便复现。

适用场景

  • 需要通过 OpenAPI/SDK 对阿里云 Data Lake Formation(DlfNext)执行目录与治理资源操作的场景。
  • 需要先发现可用 API 及其参数,再调用业务 API 的场景。
  • 需要对资源进行清单查询、变更配置或状态诊断的场景。

限制与前置条件

  • 执行前需配置最小权限的阿里云凭证。
  • 优先使用环境变量:ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET,可选 ALICLOUD_REGION_ID。
  • 若地域不明确,在执行变更类操作前需询问用户。
  • 参考资料:references/sources.md。