用途:通过 Python SDK 调用阿里云 OpenAPI,覆盖域名信息服务(Domain / domain20180129)与云解析 DNS(Alidns / alidns20150109)两组接口,用于账号域名资产查询、域名可用性与价格检查,以及 DNS 解析记录的查询与变更。两类产品 SDK 与 endpoint 不同,不可混用。
主要能力:QueryDomainList 查询账号下域名列表,支持分页及按域名、到期/注册时间、查询类型、资源组、标签等筛选;CheckDomain 检查域名是否可注册并返回价格信息,支持 create/renew/transfer/restore 等操作命令;DescribeDomainRecords 分页查询主域名下解析记录并获取 RecordId;AddDomainRecord 新增解析记录并返回新 RecordId;UpdateDomainRecord 按 RecordId 更新 RR、类型、记录值、TTL、线路等。
使用方式:先确认凭证,检查环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID 与 ALIBABA_CLOUD_ACCESS_KEY_SECRET,未设置时读取当前目录 .env 文件;再安装依赖:pip install -r aliyun-domain-skills/scripts/requirements.txt,或手动安装 alibabacloud_domain20180129、alibabacloud_alidns20150109、alibabacloud_credentials、alibabacloud_tea_openapi、alibabacloud_tea_util、python-dotenv。随后创建对应客户端,构建 Request,调用 with_options 方法并解析返回 JSON。脚本位于 scripts/ 目录,API 契约(入参与返回值)见 reference/ 下 YML。
适用场景:列出账号域名、筛选即将到期域名、注册前查可用性与价格、排查解析、新增子域记录、切换 IP 或调整 TTL/线路。
限制:Domain 与 Alidns 无强制调用顺序,可按业务组合;AddDomainRecord、UpdateDomainRecord 为写操作,新增前建议用 DescribeDomainRecords 确认无冲突,更新前需先取得 RecordId;CheckDomain 存在频率限制,同一阿里云账号及其 RAM 用户为 10QPS,接口总量 100QPS;时间戳参数需为毫秒级;401/403 多为凭证无效或 RAM 权限不足,InvalidAccessKeyId 与 SignatureDoesNotMatch 分别对应 AccessKeyId 与 AccessKeySecret 问题;未通过凭证检查不应继续执行。其它域名详情、注册任务等能力暂未提供。