用途:诊断和修复 Oracle Cloud Infrastructure(OCI)API 报错。OCI 错误信息含糊,如 NotAuthorizedOrNotFound(404)既可能缺少 IAM 策略也可能 OCID 写错,NotAuthenticated(401)覆盖六种配置问题,CERTIFICATE_VERIFY_FAILED 的修复因 SDK 语言、操作系统和是否处于企业代理而异。本技能提供错误到根因与修复的映射表及可运行诊断命令。
主要能力:按错误码分类诊断。401 NotAuthenticated 提供 diagnose_auth() 脚本,依次检查 ~/.oci/config 是否存在、必需字段(user、fingerprint、tenancy、region、key_file)、密钥文件是否存在、是否误用公钥、权限是否为 600、指纹是否匹配。404 提供 OCID 格式校验、compartment 资源列举和 IAM 策略检查命令及策略示例。SSL 提供 certifi 升级、REQUESTS_CA_BUNDLE 指向系统 CA、企业代理 CA 追加等修复。429 提供带抖动的退避重试及 SDK 内置 retry_strategy。超时(status -1)需显式设置 timeout=(connect, read)。500 建议重试并查看状态页。
使用方式:需配置 ~/.oci/config,Python 3.8+ 与 pip install oci,安装 OCI CLI(pip install oci-cli)。可用 oci iam region list --output table 做连通性测试。捕获 ServiceError 时输出 status、code、message 与 request_id,便于工单排查。
适用场景:OCI SDK 与 CLI 报错的定位与修复。限制:资料未提供具体价格、支持平台范围与效果保证;重试次数、超时数值等仅为其示例,需按实际调整。