alicloud-data-lake-dlf

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
Category: service
分类:服务

Data Lake Formation

Data Lake Formation

Use Alibaba Cloud OpenAPI (RPC) with official SDKs or OpenAPI Explorer to manage resources for Data Lake Formation.
使用阿里云OpenAPI(RPC)结合官方SDK或OpenAPI Explorer来管理Data Lake Formation的资源。

Workflow

工作流

  1. Confirm region, resource identifiers, and desired action.
  2. Discover API list and required parameters (see references).
  3. Call API with SDK or OpenAPI Explorer.
  4. Verify results with describe/list APIs.
  1. 确认地域、资源标识符以及所需执行的操作。
  2. 查阅API列表和所需参数(请参考参考资料)。
  3. 通过SDK或OpenAPI Explorer调用API。
  4. 使用查询/列举类API验证结果。

AccessKey priority (must follow)

AccessKey优先级(必须遵循)

  1. Environment variables:
    ALICLOUD_ACCESS_KEY_ID
    /
    ALICLOUD_ACCESS_KEY_SECRET
    /
    ALICLOUD_REGION_ID
    Region policy:
    ALICLOUD_REGION_ID
    is an optional default. If unset, decide the most reasonable region for the task; if unclear, ask the user.
  2. Shared config file:
    ~/.alibabacloud/credentials
  1. 环境变量:
    ALICLOUD_ACCESS_KEY_ID
    /
    ALICLOUD_ACCESS_KEY_SECRET
    /
    ALICLOUD_REGION_ID
    地域策略:
    ALICLOUD_REGION_ID
    是可选的默认值。如果未设置,请为任务选择最合理的地域;若不确定,请询问用户。
  2. 共享配置文件:
    ~/.alibabacloud/credentials

API discovery

API发现

  • Product code:
    DataLake
  • Default API version:
    2020-07-10
  • Use OpenAPI metadata endpoints to list APIs and get schemas (see references).
  • 产品代码:
    DataLake
  • 默认API版本:
    2020-07-10
  • 使用OpenAPI元数据端点来列出API并获取模式(请参考参考资料)。

High-frequency operation patterns

高频操作模式

  1. Inventory/list: prefer
    List*
    /
    Describe*
    APIs to get current resources.
  2. Change/configure: prefer
    Create*
    /
    Update*
    /
    Modify*
    /
    Set*
    APIs for mutations.
  3. Status/troubleshoot: prefer
    Get*
    /
    Query*
    /
    Describe*Status
    APIs for diagnosis.
  1. 盘点/列举:优先使用
    List*
    /
    Describe*
    类API获取当前资源。
  2. 变更/配置:优先使用
    Create*
    /
    Update*
    /
    Modify*
    /
    Set*
    类API进行变更操作。
  3. 状态/排查:优先使用
    Get*
    /
    Query*
    /
    Describe*Status
    类API进行诊断。

Minimal executable quickstart

最简可执行快速入门

Use metadata-first discovery before calling business APIs:
bash
python scripts/list_openapi_meta_apis.py
Optional overrides:
bash
python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>
The script writes API inventory artifacts under the skill output directory.
在调用业务API前,先基于元数据进行发现:
bash
python scripts/list_openapi_meta_apis.py
可选覆盖参数:
bash
python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>
该脚本会将API清单文件写入技能输出目录。

Output policy

输出策略

If you need to save responses or generated artifacts, write them under:
output/alicloud-data-lake-dlf/
如果需要保存响应或生成的文件,请写入以下目录:
output/alicloud-data-lake-dlf/

References

参考资料

  • Sources:
    references/sources.md
  • 来源:
    references/sources.md