You need to enable JavaScript to run this app.
导航
公共错误码
最近更新时间:2024.06.24 14:04:40首次发布时间:2022.11.24 20:57:30

响应状态码

API 请求成功时,HTTP 响应状态码是 200。

API 请求失败时,会出现以下任意一个情况:

  • HTTP 响应状态码是 4xx 或 5xx。
  • 响应正文的 ResponseMetadata 结构体包含 Error 字段。

如果响应出现异常,响应正文的内容如下。此时您可根据 Error 结构体中的 CodeNCodeMessage 等提示信息排查问题原因。

类型CodeCodeNMessageHTTP 响应状态码MessageCN
服务内部错误ErrInternalServer500100server internal error500服务内部错误
公共类型校验错误ErrParsingParams400100parsing params error400解析请求失败
ErrMissingAccountParameter400101`account` parameter missing401account参数缺失
ErrParamInvalid400102validation fail: %s400参数校验失败
ErrDBDuplicated400103duplicated: %s409数据库条目重复
ErrDBNotFound400104record not found :%s400数据库条目未找到
ErrZoneNotFound400105zone not found400未找到域名
域名操作校验ErrVipZoneCanNotBeDeleted400110vip zone can not be deleted400付费版域名不支持删除
ErrRequestSizeAboveMax400111zones numbers should be less than or equal to %s400请求的域名数量超出限制
ErrAccountZoneCountLimited400112account zone count limited when creating zone400该账户域名数量超出限制
域名找回操作校验ErrZoneInactive400120zone is inactive400域名待找回
ErrZoneAlreadyRetrieve400121zone already retrieve400域名已经被找回
ErrZoneRetrieveNotFound400122search retrieve zone not found400该域名未发起找回
ErrZoneRetrieveRecordExpired400123zone retrieve record expired400验证记录已过期
ErrCreateRetrieveTxtReachingMaxTimes400124create retrieve txt record reaching max times400验证记录生成次数超出限制
ErrTXTRecordNotFound400125type txt record not found400验证记录未找到
记录操作校验ErrHostCanNotBeEmpty400130host can't be empty, use @ instead400主机记录不能为空
ErrSearchParamMissingParams400131request param: rr or type or value or line cannot be empty400记录查询条件缺失
ErrPageSizeNotValid400132page size must be less than 500 when search400分页查找的记录数量不能大于500
ErrAccountRecordCountLimited400133account record count limited when creating record400该账户记录数量超出限制
ErrZoneRecordCountLimited400134zone record count limited when creating record400该域名记录数量超出限制
ErrSpecNotValid400135record %s not valid when creating record400参数不符合功能版本规格限制
ErrLoadBalancerLimit400136record load balancer count limited when creating record400记录组中记录数量超出功能版本规格限制
数据统计校验ErrNamesNotMatch400140domain name and zone name do not match400域名与子域名不匹配
ErrDomainStatisticsNotValid400141this zone can't view domain statistics400当前功能版本不支持查看子域名数据统计

API 请求成功的响应示例

{
    "ResponseMetadata": {
        "RequestId": "20230411150314CE53198BCFE9484824BA",
        "Action": "QueryZone",
        "Version": "2018-08-01",
        "Service": "dns",
        "Region": "cn-north-1"
    },
    "Result": {
        "InstanceNo": "DNS71279xxxxx9644332",
        "ZoneName": "xxxxx.com",
        "Remark": "",
        "ExpiredTime": 1691164799000,
        "ConfigurationCode": "monthly_plan_publiczone",
        "Status": 1,
        "AllocateDNSServerList": [
            "ns1.volcdns.com",
            "ns2.volcdns.com",
            "ns3.volcdns.com",
            "ns4.volcdns.com",
            "ns5.volcdns.com"
        ],
        "RealDNSServerList": [
            "ns1.volcdns.com",
            "ns2.volcdns.com",
            "ns3.volcdns.com",
            "ns4.volcdns.com",
            "ns5.volcdns.com"
        ],
        "IsNSCorrect": false,
        "Stage": 2,
        "TradeCode": "ultimate_inner",
        "UpdatedAt": "2023-04-03T19:17:32+08:00",
        "RecordCount": 0
    }
}

API 请求失败的响应示例

{
    "ResponseMetadata": {
        "RequestId": "2023041116283931DC4B51E4C8C7660227",
        "Action": "QueryZone",
        "Version": "2018-08-01",
        "Service": "dns",
        "Region": "cn-north-1",
        "Error": {
            "CodeN": 400100,
            "Code": "ErrParsingParams",
            "Message": "parsing params error",
            "MessageCN": "解析请求失败"
        }
    }
}