DNSPod
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > DNSPod > API 文档 > 记录相关接口 > 设置记录状态

设置记录状态

最近更新时间：2024-03-12 01:26:26

我的收藏

本页目录：

1. 接口描述

接口请求域名： dnspod.tencentcloudapi.com 。

修改解析记录的状态

默认接口请求频率限制：20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称 必选 类型 描述
Action 是 String 公共参数，本接口取值：ModifyRecordStatus。
Version 是 String 公共参数，本接口取值：2021-03-23。
Region 否 String 公共参数，本接口不需要传递此参数。
Domain 是 String 域名
示例值：dnspod.cn
RecordId 是 Integer 记录 ID 。可以通过接口DescribeRecordList查到所有的解析记录列表以及对应的RecordId
示例值：162
Status 是 String 记录的状态。取值范围为 ENABLE 和 DISABLE。如果传入 DISABLE，解析不会生效，也不会验证负载均衡的限制。
示例值：ENABLE
DomainId 否 Integer 域名 ID 。参数 DomainId 优先级比参数 Domain 高，如果传递参数 DomainId 将忽略参数 Domain 。可以通过接口DescribeDomainList查到所有的Domain以及DomainId
示例值：1923

3. 输出参数

参数名称 类型 描述
RecordId Integer 记录ID。
示例值：161
RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 设置记录状态

输入示例

POST / HTTP/1.1
Host: dnspod.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyRecordStatus
<公共请求参数>

{
    "Domain": "dnspod.site",
    "DomainId": 62,
    "RecordId": 161,
    "Status": "ENABLE"
}

输出示例

{
    "Response": {
        "RequestId": "ab4f1426-ea15-42ea-8183-dc1b44151166",
        "RecordId": 161
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。

错误码 描述
FailedOperation 操作失败。
FailedOperation.DomainIsLocked 锁定域名不能进行此操作。
FailedOperation.DomainIsSpam 封禁域名不能进行此操作。
FailedOperation.FrequencyLimit 您操作过于频繁，请稍后重试
FailedOperation.LoginAreaNotAllowed 账号异地登录，请求被拒绝。
FailedOperation.LoginFailed 登录失败，请检查账号和密码是否正确。
FailedOperation.UnknowError 操作未响应，请稍后重试。
InvalidParameter.CustomMessage 自定义错误信息。
InvalidParameter.DnssecAddCnameError 该域名开启了 DNSSEC，不允许添加 @ 子域名 CNAME、显性 URL 或者隐性 URL 记录。
InvalidParameter.DomainIdInvalid 域名编号不正确。
InvalidParameter.DomainInvalid 域名不正确，请输入主域名，如 dnspod.cn。
InvalidParameter.DomainIsAliaser 此域名是其它域名的别名。
InvalidParameter.DomainNotAllowedModifyRecords 处于生效中/失效中的域名，不允许变更解析记录。
InvalidParameter.DomainNotBeian 该域名未备案，无法添加 URL 记录。
InvalidParameter.DomainRecordExist 记录已经存在，无需再次添加。
InvalidParameter.EmailNotVerified 抱歉，您的账户还没有通过邮箱验证。
InvalidParameter.LoginTokenIdError Token 的 ID 不正确。
InvalidParameter.LoginTokenNotExists 传入的 Token 不存在。
InvalidParameter.LoginTokenValidateFailed Token 验证失败。
InvalidParameter.MobileNotVerified 抱歉，您的账户还没有通过手机验证。
InvalidParameter.OperateFailed 操作失败，请稍后再试。
InvalidParameter.RecordIdInvalid 记录编号错误。
InvalidParameter.RecordValueInvalid 记录的值不正确。
InvalidParameter.RequestIpLimited 您的IP非法，请求被拒绝。
InvalidParameter.SubdomainInvalid 子域名不正确。
InvalidParameter.UnrealNameUser 未实名认证用户，请先完成实名认证再操作。
InvalidParameter.UrlValueIllegal 很抱歉，您要添加的URL的内容不符合DNSPod解析服务条款，URL添加/启用失败，如需帮助请联系技术支持。
InvalidParameter.UserNotExists 用户不存在。
InvalidParameterValue.DomainNotExists 当前域名有误，请返回重新操作。
InvalidParameterValue.UserIdInvalid 用户编号不正确。
LimitExceeded.AAAACountLimit AAAA记录数量超出限制。
LimitExceeded.AtNsRecordLimit @的NS记录只能设置为默认线路。
LimitExceeded.FailedLoginLimitExceeded 登录失败次数过多已被系统封禁。
LimitExceeded.HiddenUrlExceeded 该域名使用的套餐不支持隐性URL转发或数量已达上限，如需要使用，请去商城购买。
LimitExceeded.NsCountLimit NS记录数量超出限制。
LimitExceeded.SrvCountLimit SRV记录数量超出限制。
LimitExceeded.SubdomainLevelLimit 子域名级数超出限制。
LimitExceeded.SubdomainRollLimit 子域名负载均衡数量超出限制。
LimitExceeded.SubdomainWcardLimit 泛解析级数超出限制。
LimitExceeded.UrlCountLimit 该域名的显性URL转发数量已达上限，如需继续使用，请去商城购买。
OperationDenied.DomainOwnerAllowedOnly 仅域名所有者可进行此操作。
OperationDenied.NoPermissionToOperateDomain 当前域名无权限，请返回域名列表。
OperationDenied.NotAdmin 您不是管理用户。
OperationDenied.NotAgent 您不是代理用户。
OperationDenied.NotManagedUser 不是您名下用户。
RequestLimitExceeded.RequestLimitExceeded API请求次数超出限制。
中国站