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