文档反馈
问问助手本文旨在帮助您理解和解决在多云CDN与云服务商进行接口交互时可能遇到的各类错误。当多云CDN代表您向云服务商发起 API 请求失败时，会接收并记录云服务商返回的错误信息。本文将这些错误进行分类，并提供相应的排查和处理建议。
快速排查
在深入了解错误细节之前，您可以先通过请求失败详情中的错误信息，快速定位问题。通常，错误信息包含两个部分：
- 多云CDN错误类别：由多云CDN标准化后的错误类型，便于您快速归类问题。
- 云服务商原始错误：云服务商 API 返回的原始错误码和描述，为您提供最直接的排查线索。
您可以首先根据多云CDN的错误类别（参考下文的 常见错误类型及处理建议 部分）排查问题。如果问题仍未解决，可以利用云服务商的原始错误信息，通过其官方文档或 OpenAPI 平台进行查询。
影响级别说明
为了帮助您判断问题的紧急程度，我们将错误的影响级别分为三类：
- 高：该类错误通常导致核心功能完全不可用（例如，无法添加、删除或修改配置），需要立即处理。
- 中：该类错误可能影响部分功能或导致性能下降，建议您及时处理。
- 低：该类错误通常是临时性问题，例如云服务商服务抖动或网络波动，一般可通过重试解决。
常见错误类型及处理建议
我们将接口调用错误归纳为以下几类。请根据您遇到的错误类别，查找对应的处理建议。
凭证与权限问题
这类错误是由于您在多云CDN中配置的云账号凭证（API 访问凭证）无效、过期或权限不足导致的。
错误码 | 描述 | 影响级别 | 处理建议 |
|---|---|---|---|
| 鉴权凭证过期 | 高 | 请登录多云CDN控制台，在 厂商管理 页面更新您的 API 访问凭证。 |
| 鉴权凭证错误，请重新检查 | 高 | 请登录多云CDN控制台，在 厂商管理 页面，仔细检查并修正您的 API 访问凭证。 |
| 无权操作该资源，或未在 IAM 分配该 API 权限 | 高 | 请登录对应的云服务商控制台，为您的 API 凭证所关联的子账号（如 IAM 用户、RAM 用户等）授予操作所需资源的权限。 |
| 使用的账号没有访问当前 API 的权限 | 高 | 请登录对应的云服务商控制台，检查并为您的账号授予调用相关 API 的权限。 |
| 鉴权凭证错误或者当前账号没有访问当前 API 的权限 | 高 | 这是一个复合类错误，请参考 复杂错误处理步骤 中的详细指引进行排查。 |
接口访问控制问题
这类错误是由于请求频率超限或 IP 地址访问受限导致的。
错误码 | 描述 | 影响级别 | 处理建议 |
|---|---|---|---|
| 当前账号已达请求频率上限 | 中 | 您的账号在云服务商平台的 API 请求频率超限。请联系云服务商技术支持，咨询解决方案或申请提升配额。 |
| 当前 IP 已达请求频率上限 | 中 | 多云CDN的出口 IP 请求频率超限。这通常是临时性的，请稍后重试。如果问题持续，请联系我们。 |
| 已达 API 请求频率上限 | 中 | 针对某个特定 API 的请求过于频繁。建议您等待 1-5 分钟后重试。 |
| 当前账号已达 API 请求频率上限 | 中 | 您的账号对某个特定 API 的请求过于频繁。建议您等待 1-5 分钟后重试。 |
| 发起请求的 IP 不在白名单内 | 高 | 如果云服务商要求配置 IP 白名单，请通过工单联系技术支持，我们将协助您将多云CDN的出口 IP 添加至白名单。 |
| 发起请求的 IP 在黑名单内 | 高 | 如果您确认是多云CDN的出口 IP 被错误地加入了黑名单，请通过工单联系技术支持处理。 |
配额限制问题
这类错误是由于您在云服务商的资源或服务使用量超出了其规定的配额。
错误码 | 描述 | 影响级别 | 处理建议 |
|---|---|---|---|
| 超过配额限制 | 中 | 您的操作（如创建域名、刷新 URL 数量）超出了云服务商的配额。建议您次日重试，或联系云服务商技术支持申请提升配额。 |
参数错误
这类错误是由于 API 请求中传递的参数不符合云服务商接口的要求。
错误码 | 描述 | 影响级别 | 处理建议 |
|---|---|---|---|
| 请求参数错误 | 中 | 这是由多云CDN系统内部处理参数时产生的错误。如果此问题持续出现，请联系技术支持，并提供相关请求信息。 |
云服务商服务端问题
这类错误源于云服务商的内部服务异常，通常是临时性的。
错误码 | 描述 | 影响级别 | 处理建议 |
|---|---|---|---|
| 云服务商内部发生错误 | 低 | 云服务商服务端出现未知错误。建议等待 1-5 分钟后重试。 |
| 云服务商网关发生错误 | 低 | 云服务商的 API 网关出现异常。建议等待 1-5 分钟后重试。 |
| 云服务商服务不可用 | 低 | 云服务商的后端服务暂时不可用。建议等待 1-5 分钟后重试。 |
| 云服务商处理请求超时 | 低 | 云服务商的后端服务处理请求花费时间过长。建议等待 1-5 分钟后重试。 |
| 云服务商网关超时 | 低 | 云服务商的 API 网关响应超时。建议等待 1-5 分钟后重试。 |
网络及其他问题
错误码 | 描述 | 影响级别 | 处理建议 |
|---|---|---|---|
| 请求超时 | 低 | 多云CDN向云服务商发起的请求在规定时间内未收到响应。建议等待 1-5 分钟后重试。 |
| 请求时发生网络错误 | 低 | 在请求过程中发生网络层面的问题。建议等待 1-5 分钟后重试。 |
| 未能识别错误类型 | 中 | 多云CDN未能将云服务商返回的错误映射到任何已知类别。请根据原始错误信息联系技术支持。 |
说明
对于影响级别为“低”的错误，如果重试 3 次后问题仍然存在，请通过工单系统联系技术支持。
复杂错误处理步骤
ApiPermissionDeniedOrInvalidCredential 错误处理
当您遇到此错误时，说明问题可能出在凭证本身，也可能出在凭证的权限配置上。请按照以下步骤进行排查：
- 验证凭证的准确性。
- 登录多云CDN控制台，进入 厂商管理 页面。
- 找到对应的云服务商账号，仔细核对 API 访问凭证（如 Access Key ID 和 Secret Key）是否与您在云服务商平台获取的完全一致。
说明
确保没有遗漏字符、前后没有多余的空格。
- 检查账号的授权情况。
- 登录相应的云服务商控制台（例如，阿里云的 RAM 控制台、腾讯云的 CAM 控制台）。
- 定位到您提供给多云CDN的 API 凭证所对应的子账号。
- 检查该账号是否已被授予调用目标 API 的权限。
例如，如果错误发生在“刷新缓存”操作上，请确保该账号拥有 CDN 的
PushObjectCache或类似 API 的调用权限。
如果缺少必要权限，请参考 云服务商账号授权为账号补充相应权限。
云服务商错误码参考
如果您希望根据云服务商返回的原始错误码进行深入排查，可以访问其官方的 API 文档或错误码中心。
云服务商 | 产品/服务 | 错误码信息查询入口 |
|---|---|---|
火山引擎 | CDN | |
DCDN | ||
SSL 证书 | ||
阿里云 | CDN | |
DCDN | ||
数字证书管理 | ||
腾讯云 | CDN | |
ECDN | ||
EdgeOne | ||
SSL 证书 | ||
网宿科技 | CDN | |
证书管理 | ||
金山云 | CDN | |
SSL 证书 | ||
华为云 | CDN | |
SSL 证书管理 | ||
UCloud | CDN、SSL 证书 | |
白山云 | CDN、SSL 证书 | 请联系云服务商技术支持。 |
百度智能云 | CDN | |
SSL 证书 | ||
京东云 | CDN | |
SSL 证书 | ||
七牛云 | CDN、SSL 证书 | |
AWS | CloudFront | |
ACM | ||
Akamai | AMD 和 DSA | 请联系云服务商技术支持。 |
Google Cloud | Media CDN | 请联系云服务商技术支持。 |
中国移动 | CDN | 请联系云服务商技术支持。 |
天翼云 | CDN+ | 请联系云服务商技术支持。 |
Azure | CDN | 请联系云服务商技术支持。 |
Cloudflare | CDN | 请联系云服务商技术支持。 |