用途:诊断第三方备份工具接入阿里云 OSS 时的集成故障,例如 Veeam 备份校验失败或需申请兼容白名单、群晖/NAS 报“V1 signature is forbidden”、rclone 或 AWS CLI 走 S3 兼容接口同步异常、IA/归档桶备份产生高额取回费用等。
主要能力:按“工具×症状”目录做归因,覆盖签名适配、端点形式、请求风格、权限映射、白名单申请、取回费用归因与工具用法;产出可照抄的配置建议,并对配置类问题用官方 OSS 文档校验,最终答案需引用脚本返回的文档 URL。
使用方式:必须运行入口脚本 python3 scripts/oss_backup_integration_diagnosis.py --tool <t> [--error-code <msg>] [--symptom <s>] [--storage-class <cls>] [--bucket <b>] [--region <r>];参数全部可选,先自动填充用户消息里的信息直接运行,不要把参数问全。也可加 --question "" 触发官方文档校验。读脚本输出的 JSON(match.type、diagnosis.category、root_cause_directions、configuration_advice、retrieval_judgment 等)据此作答。
限制:技能零云 API 调用、零凭证、不读不存 AK/SK/STS,仅运行上述入口脚本,禁止任何 aliyun CLI、OpenAPI、计费/定价查询或对用户桶执行工具;只给建议不落地变更,不代为开通白名单、不改存储类型或 RAM、不做恢复与退款。只说明费用归因机制,不报单价、月度金额、资源包规格或换算估算。缺失信息须在答案中显式声明,未知即未知。
关键事实:OSS 仅接受 virtual-hosted 请求风格与形如 https://s3.oss-{region}.aliyuncs.com 的 S3 兼容端点;仅升级工具版本不足以解决 V1 禁用,需显式启用 V4 并配置桶地域 ID;S3 HeadBucket 映射 OSS GetBucketInfo,403 常缺 oss:GetBucketInfo;取回费按量计费、无资源包抵扣,IA 未满 30 天(Archive 60、冷归档/深度冷归档 180)被覆盖或删除会补收剩余天数费用;Veeam 兼容白名单需通过人工工单开通。