类别：service

安全中心

使用阿里云 OpenAPI（RPC）配合官方 SDK 或 OpenAPI Explorer，管理安全中心（Security Center）的资源。

工作流程

1. 确认地域（Region）、资源标识符（Resource Identifiers）及期望执行的操作。
2. 发现可用 API 列表及其所需参数（参见“参考资料”章节）。
3. 通过 SDK 或 OpenAPI Explorer 调用目标 API。
4. 使用 Describe* / List* 类 API 验证调用结果。

AccessKey 优先级（必须遵循）

1. 环境变量：ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID
   地域策略：ALICLOUD_REGION_ID 为可选默认值。若未设置，需根据任务选择最合理的地域；若不确定，请先向用户确认。
2. 共享配置文件：~/.alibabacloud/credentials

API 发现

• 产品代码（Product Code）：Sas
• 默认 API 版本：2021-01-14
• 使用 OpenAPI 元数据接口（metadata endpoints）列举 API 并获取其 Schema 定义（参见“参考资料”章节）。

高频操作模式

1. 资产盘点 / 列举资源：优先使用 List* / Describe* 类 API 获取当前资源状态。
2. 变更 / 配置资源：优先使用 Create* / Update* / Modify* / Set* 类 API 执行变更操作。
3. 状态查询 / 故障排查：优先使用 Get* / Query* / Describe*Status 类 API 进行诊断分析。

最小可执行快速入门

在调用业务 API 前，请先基于元数据完成 API 发现：

python scripts/list_openapi_meta_apis.py

可选参数覆盖：

python scripts/list_openapi_meta_apis.py --product-code  --version 

该脚本将 API 清单产物写入技能输出目录（skill output directory）。

输出策略

如需保存响应内容或生成的产物，请统一写入以下路径：
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、时间范围等），以确保可复现性。

前提条件

• 执行前，请预先配置具备最小权限的阿里云凭据（Alibaba Cloud credentials）。
• 推荐优先使用环境变量方式配置：ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET，以及可选的 ALICLOUD_REGION_ID。
• 若地域不明确，在执行变更类（mutating）操作前，必须向用户确认。

参考资料

• 来源文档：references/sources.md