开发者社区 问答 正文

云解析怎么设置解析记录状态



描述


根据传入参数获取设置解析记录状态。

请求参数

名称类型是否必须描述
ActionString操作接口名,系统规定参数,取值:SetDomainRecordStatus
RecordIdString解析记录的ID,此参数在添加解析时会返回,在获取域名解析列表时会返回
StatusStringEnable: 启用解析 Disable: 暂停解析


返回参数


公共返回参数,详见 公共返回参数
名称类型描述
RequestIdString唯一请求识别码
RecordIdString解析记录的ID
StatusString当前解析记录状态


错误码


对于所有接口的通用性错误,请参考 错误代码表
错误代码描述HTTP 状态码语义
DomainRecordNotBelongToUserThe domain record does not belong to this user.400解析记录在本账户下不存在
DomainForbiddenThe action could not be completed because the domain has been forbidden.400禁止解析操作的域名
DomainRecordLockedThe domain record has been locked.400解析记录被锁定
InvalidStatusThe domain record status is invalid.400无效的状态
RecordForbidden.BlackHoleThe action could not be completed because there are some reords have been into black hole.400域名解析防护进入黑洞
RecordForbidden.DNSChangeThe action could not be completed because DNS is changing.400DNS迁移过程禁止操作


示例



请求示例

http://alidns.aliyuncs.com/?Action=SetDomainRecordStatus&RecordId=9999985&Status=Disable&<公共请求参数>

返回示例



XML格式

<SetDomainRecordStatusResponse><RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId><RecordId>9999985</RecordId><Status>Disable</Status></SetEnableDomainRecordStatusResponse>

JSON示例

{"RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382","RecordId": "9999985","Status": "Disable"}

展开
收起
boxti 2017-10-18 10:45:18 2617 分享 版权
阿里云 AI 助理回答

您描述的是使用阿里云DNS服务(Alibaba Cloud DNS)中设置解析记录状态的API操作。这个API允许用户根据传入的参数来启用或暂停特定解析记录。下面是该操作的详细说明和指导:

请求方法

  • HTTP Method: 通常,阿里云的API调用通过POST方法发送请求,但某些情况下也支持GET。对于此示例,尽管URL显示为GET风格,实际操作推荐使用POST方法,并在请求体中包含参数。

请求参数

  1. Action: 必须参数,指定要执行的操作接口名,此处应填写SetDomainRecordStatus
  2. RecordId: 必须参数,解析记录的唯一标识符,获取自添加解析记录时的响应或通过查询域名解析列表获得。
  3. Status: 必须参数,指定了要设置的解析记录状态,可选值为Enable(启用)或Disable(暂停)。

返回参数

  • RequestId: 每个请求的唯一识别码,用于问题排查。
  • RecordId: 设置状态的解析记录ID,与请求中的相同。
  • Status: 当前解析记录的状态,确认操作是否成功。

错误码

列举了一些可能遇到的错误情况及其含义,例如: - DomainRecordNotBelongToUser: 表示尝试操作的解析记录不属于当前账户。 - DomainForbidden: 域名被禁止进行解析操作。 - DomainRecordLocked: 解析记录被锁定,无法修改。 - InvalidStatus: 提供的状态值无效。 - RecordForbidden.BlackHole: 域名解析因安全原因进入黑洞保护状态,无法操作。 - RecordForbidden.DNSChange: 域名正在进行DNS变更,暂时禁止操作。

示例请求

虽然您提供了一个示例URL,但实际调用时,尤其是通过编程方式调用,需要遵循阿里云API的签名机制,确保请求的安全性和有效性。一个典型的调用会包括AccessKeyId、Signature、SignatureMethod等认证信息,以及上述提到的业务参数,这些通常通过HTTP POST请求头和请求体传递。

注意事项

  • 在实际应用中,调用API之前,请确保已阅读并理解阿里云API文档中关于DNS服务的详细说明。
  • 使用SDK(如Java SDK、Python SDK等)可以简化签名过程和请求构造,提高开发效率。
  • 记得检查您的API调用权限,确保账户有权限执行SetDomainRecordStatus操作。

如果您在实施过程中遇到具体技术问题,建议查阅阿里云官方文档或联系阿里云技术支持获取帮助。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答