类别：service

简单应用服务器（SWAS-OPEN 2020-06-01）

使用 SWAS-OPEN OpenAPI 管理完整的 SAS 资源：实例、云盘、快照、镜像、密钥对、防火墙、Cloud Assistant、监控、标签及轻量级数据库。

前提条件

• 准备具备最小权限的 RAM 用户/角色所对应的 AccessKey。
• 选择正确的地域及匹配的终端节点（公网/VPC）。ALICLOUD_REGION_ID 可作为默认地域；若未设置，则应自动选择最合理的地域，当无法确定时需向用户确认。
• 本 OpenAPI 使用 RPC 签名机制；建议优先使用 Python SDK 或 OpenAPI 探索器，而非手动签名。

SDK 使用优先级

1. Python SDK（首选）
2. OpenAPI 探索器
3. 其他 SDK

Python SDK 快速查询（实例 ID / IP / 套餐）

推荐使用虚拟环境（避免受 PEP 668 系统安装限制影响）。

python3 -m venv .venv
. .venv/bin/activate
python -m pip install alibabacloud_swas_open20200601 alibabacloud_tea_openapi alibabacloud_credentials

import os
from alibabacloud_swas_open20200601.client import Client as SwasClient
from alibabacloud_swas_open20200601 import models as swas_models
from alibabacloud_tea_openapi import models as open_api_models


def create_client(region_id: str) -> SwasClient:
    config = open_api_models.Config(
        region_id=region_id,
        endpoint=f"swas.{region_id}.aliyuncs.com",
    )
    ak = os.getenv("ALICLOUD_ACCESS_KEY_ID") or os.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
    sk = os.getenv("ALICLOUD_ACCESS_KEY_SECRET") or os.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
    if ak and sk:
        config.access_key_id = ak
        config.access_key_secret = sk
    return SwasClient(config)


def list_regions():
    client = create_client("cn-hangzhou")
    resp = client.list_regions(swas_models.ListRegionsRequest())
    return [r.region_id for r in resp.body.regions]


def list_instances(region_id: str):
    client = create_client(region_id)
    resp = client.list_instances(swas_models.ListInstancesRequest(region_id=region_id))
    return resp.body.instances


def main():
    for region_id in list_regions():
        for inst in list_instances(region_id):
            ip = getattr(inst, "public_ip_address", None) or getattr(inst, "inner_ip_address", None)
            spec = getattr(inst, "plan_name", None) or getattr(inst, "plan_id", None)
            print(inst.instance_id, ip or "-", spec or "-", region_id)


if __name__ == "__main__":
    main()

Python SDK 脚本（推荐用于资产盘点与汇总统计）

• 全地域实例资产清单（TSV/JSON 格式）：scripts/list_instances_all_regions.py
• 按套餐统计实例数量：scripts/summary_instances_by_plan.py
• 按状态统计实例数量：scripts/summary_instances_by_status.py
• 修复基于 SSH 密钥的访问（支持自定义端口）：scripts/fix_ssh_access.py
• 获取某实例当前 SSH 端口：scripts/get_ssh_port.py

CLI 注意事项

• aliyun CLI 可能未将 swas-open 暴露为产品名称；建议优先使用 Python SDK。 如必须使用 CLI，请先在 OpenAPI 探索器中生成请求示例，再迁移至 CLI 调用。

工作流程

1. 确认资源类型与地域（实例/云盘/快照/镜像/防火墙/命令/数据库/标签）。
2. 在 references/api_overview.md 中定位对应 API 分组与操作。
3. 选择调用方式（Python SDK / OpenAPI 探索器 / 其他 SDK）。
4. 执行变更类操作后，务必通过查询类 API 验证资源状态与结果。

常用操作映射表

• 实例查询/启动/停止/重启：ListInstances、StartInstance(s)、StopInstance(s)、RebootInstance(s)
• 命令执行：RunCommand 或 CreateCommand + InvokeCommand；使用 DescribeInvocations/DescribeInvocationResult 查询执行状态与输出
• 防火墙：ListFirewallRules/CreateFirewallRule(s)/ModifyFirewallRule/EnableFirewallRule/DisableFirewallRule
• 快照/云盘/镜像：CreateSnapshot、ResetDisk、CreateCustomImage 等

Cloud Assistant 执行注意事项

• 目标实例必须处于 Running 状态。
• 必须已安装 Cloud Assistant Agent（可使用 InstallCloudAssistant 安装）。
• 对于 PowerShell 命令，请确保 Windows 实例上已安装所需模块。
• 执行完成后，请使用 DescribeInvocations 或 DescribeInvocationResult 获取执行状态与输出内容。

详见 references/command-assistant.md。

需澄清的问题（不确定时请主动询问）

1. 目标地域是哪个？是否需要使用 VPC 终端节点？
2. 目标实例 ID 是哪些？当前是否处于 Running 状态？
3. 需要执行何种类型/脚本/超时设置的命令？Linux 还是 Windows？
4. 是否需要批量执行或定时执行？

输出策略

如需保存结果或响应数据，请写入以下路径： output/compute-swas-open/

验证

mkdir -p output/alicloud-compute-swas-open
for f in skills/compute/swas/alicloud-compute-swas-open/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-compute-swas-open/validate.txt

通过标准：命令退出码为 0，且成功生成 output/alicloud-compute-swas-open/validate.txt 文件。

输出与证据要求

• 所有产物、命令输出及 API 响应摘要均须保存至 output/alicloud-compute-swas-open/ 目录下。
• 证据文件中需包含关键参数（如地域、资源 ID、时间范围等），以保障可复现性。

前提条件

• 执行前须配置具备最小权限的 Alibaba Cloud 凭据。
• 推荐使用环境变量方式配置：ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET；ALICLOUD_REGION_ID 为可选。
• 若地域不明确，在执行变更类操作前必须向用户确认。

工作流程

1. 确认用户意图、地域、资源标识符，并明确操作是否为只读或变更类。
2. 首先执行一个最小化的只读查询，以验证连通性与权限是否正常。
3. 使用显式参数与限定作用域的方式执行目标操作。
4. 验证执行结果，并保存输出与证据文件。

参考资料

• API 概览与操作分组：references/api_overview.md
• 终端节点与集成说明：references/endpoints.md
• Cloud Assistant 关键特性说明：references/command-assistant.md
• 官方资料来源列表：references/sources.md