Alibaba Cloud Product + API Discovery#

Follow this workflow to collect products, resolve API metadata, and build summaries for skill planning.

Workflow#

1. Fetch product lists from the three sources

• Ticket System (ListProducts)
• Support & Service (ListProductByGroup)
• BSS OpenAPI (QueryProductList)

Run the bundled scripts (from this skill folder):

bash

python scripts/products_from_ticket_system.py
python scripts/products_from_support_service.py
python scripts/products_from_bssopenapi.py

Provide required env vars in each script (see references).

1. Merge product lists

bash

python scripts/merge_product_sources.py

This writes output/product-scan/merged_products.json and .md.

1. Fetch OpenAPI metadata product list

bash

python scripts/products_from_openapi_meta.py

This writes output/product-scan/openapi-meta/products.json and products_normalized.json.

1. Fetch OpenAPI API docs per product/version

bash

python scripts/apis_from_openapi_meta.py

By default this can be large. Use filters for dry runs:

• OPENAPI_META_MAX_PRODUCTS=10
• OPENAPI_META_PRODUCTS=Ecs,Ons
• OPENAPI_META_VERSIONS=2014-05-26

1. Join products with API counts

bash

python scripts/join_products_with_api_meta.py

1. Summarize products by category/group

bash

python scripts/summarize_openapi_meta_products.py

1. (Optional) Compare products vs existing skills

bash

python scripts/analyze_products_vs_skills.py

Output discipline#

All generated files must go under output/. Do not place temporary files elsewhere.

Validation#

bash

mkdir -p output/aliyun-openapi-discovery
for f in skills/platform/openapi/aliyun-openapi-discovery/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-openapi-discovery/validate.txt

Pass criteria: command exits 0 and output/aliyun-openapi-discovery/validate.txt is generated.

Output And Evidence#

• Save artifacts, command outputs, and API response summaries under output/aliyun-openapi-discovery/.
• Include key parameters (region/resource id/time range) in evidence files for reproducibility.

Prerequisites#

• Configure least-privilege Alibaba Cloud credentials before execution.
• Prefer environment variables: ALICLOUD_ACCESS_KEY_ID, ALICLOUD_ACCESS_KEY_SECRET, optional ALICLOUD_REGION_ID.
• If region is unclear, ask the user before running mutating operations.

References#

• Product source APIs: see references/product-sources.md
• OpenAPI meta endpoints: see references/openapi-meta.md