| name | aliyun-alb-manage |
| description | Use when managing and troubleshoot Alibaba Cloud ALB (Application Load Balancer), including the user asks to inspect, create, change, or debug ALB instances, listeners, server groups, rules, certificates, ACLs, security policies, or health checks in Alibaba Cloud. |
| version | 1.0.0 |
Category: service
Application Load Balancer (ALB)
Use this skill for end-to-end ALB operations via local Python scripts and OpenAPI-compatible workflows.
Validation
mkdir -p output/aliyun-alb-manage
for f in skills/network/slb/aliyun-alb-manage/scripts/*.py; do
python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-alb-manage/validate.txt
Pass criteria: command exits 0 and output/aliyun-alb-manage/validate.txt is generated.
Output And Evidence
- Save all command outputs, request parameters, and API responses under
output/aliyun-alb-manage/.
- For change operations, keep before/after snapshots plus health-check results.
Prerequisites
pip install alibabacloud_alb20200616 alibabacloud_tea_openapi alibabacloud_credentials
Credential priority:
ALIBABACLOUD_ACCESS_KEY_ID / ALIBABACLOUD_ACCESS_KEY_SECRET- Optional STS token:
ALIBABACLOUD_SECURITY_TOKEN
- Shared config:
~/.alibabacloud/credentials
Workflow
- Confirm region, VPC context, target ALB resource IDs, and expected change window.
- Run inventory scripts first (
list_*, get_*) and save baseline outputs.
- Apply one change at a time (listener/server-group/rule/lb lifecycle).
- Wait for async completion when needed (
scripts/wait_for_job.py).
- Validate final state with health checks and state re-query.
Top task playbooks
1) Read-only inventory and quick diagnosis
python3 scripts/list_instances.py --region cn-hangzhou --json --output output/aliyun-alb-manage/instances.json
python3 scripts/list_server_groups.py --region cn-hangzhou --json --output output/aliyun-alb-manage/server-groups.json
python3 scripts/list_acls.py --region cn-hangzhou --json --output output/aliyun-alb-manage/acls.json
2) Inspect one ALB and listener details
python3 scripts/get_instance_status.py --region cn-hangzhou --lb-id alb-xxx --view detail --output output/aliyun-alb-manage/lb-detail.json
python3 scripts/list_listeners.py --region cn-hangzhou --lb-id alb-xxx --json --output output/aliyun-alb-manage/listeners.json
python3 scripts/get_listener_attribute.py --region cn-hangzhou --listener-id lsn-xxx --output output/aliyun-alb-manage/listener-attr.json
3) Validate traffic path health
python3 scripts/check_health_status.py --region cn-hangzhou --listener-id lsn-xxx --output output/aliyun-alb-manage/health.json
python3 scripts/list_server_group_servers.py --region cn-hangzhou --server-group-id sgp-xxx --output output/aliyun-alb-manage/server-group-members.json
4) Controlled change flow (example: update listener)
python3 scripts/update_listener.py --region cn-hangzhou --listener-id lsn-xxx --request-timeout 120 --output output/aliyun-alb-manage/update-listener.json
python3 scripts/check_health_status.py --region cn-hangzhou --listener-id lsn-xxx --output output/aliyun-alb-manage/health-after-update.json
5) Resource lifecycle operations
- ALB lifecycle:
create_load_balancer.py, delete_load_balancer.py, deletion_protection.py
- Listener lifecycle:
create_listener.py, start_listener.py, stop_listener.py, delete_listener.py
- Server-group lifecycle:
create_server_group.py, add_servers.py, remove_servers.py, delete_server_group.py
- Rule lifecycle:
create_rule.py, update_rule.py, delete_rule.py
References
- API quick map:
references/api_quick_map.md
- Script catalog:
references/scripts_catalog.md
- Troubleshooting:
references/troubleshooting.md
- Logs and analysis:
references/log-analysis.md
- Dependencies/order:
references/resource-dependencies.md
- Sources:
references/sources.md
