AddZoneRecord - 添加解析记录

调用AddZoneRecord添加内置权威解析记录。在解析生效范围内,该域名的内网解析记录会覆盖其公网解析记录。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
pvtz:AddZoneRecordcreate
  • Zone
    acs:pvtz::{#accountId}:zone/{#ZoneId}

请求参数

名称类型必填描述示例值
ZoneIdstring

Zone ID,Zone 的唯一识别码。

df2d03865266bd9842306db586d3****
Langstring

返回值语言,取值:

  • zh:中文。

  • en:英文。

默认值:en

en
Rrstring

主机记录。主机记录就是域名前缀,常见用法有 www、@、*(泛解析)、mail(常用于邮箱)。

例如要解析@.exmaple.com,主机记录要填写"@”,而不是空。

www
Typestring

解析记录类型,目前支持如下:

  • A:将域名指向一个 IPV4(点分十进制格式的 IPv4 地址)。
  • AAAA:将域名指向一个 IPV6(IPv6 地址)。
  • CNAME:将域名指向另一个域名(域名地址)。
  • TXT:文本长度限制 255,通常做 SPF 记录(反垃圾邮件)。
  • MX:将域名指向邮件服务器地址(邮件服务器的域名)。
  • PTR:将 IP 地址指向一个域名。
  • SRV:记录提供特定的服务的服务器(格式为 优先级 权重 端口 目标地址,每项中间需以空格分隔)。
说明 添加 PTR 记录前需要先配置反解 Zone,具体操作请参考反向解析及 PTR 记录
A
Linestring

解析请求来源。取值:

  • default:默认解析线路(相当于全局线路,建议您配置默认线路用于兜底,保障没有智能线路命中的情况下可以返回解析记录)。
  • 阿里云线路(指解析请求来自阿里云,包括公共云、金融云、政务云)。
  • 自定义线路(可以定制内网域名解析针对来源于某个特殊 IP 段的 DNS 查询请求返回特定的 IP 地址)
说明
  • 内置权威加速区域名才支持添加的解析请求来源线路。
  • 选择默认解析,输入“default”即可,阿里云线路和自定义线路需填写指定线路编码。 例:aliyun_r_cn-beijing-a
  • default
    Weightinteger

    权重值(1-100 内的整数,包括 1 和 100,默认为 1),支持对每个地址设置不同的权重值,实现解析查询按照权重比例返回地址。

    1
    Ttlinteger

    本地缓存时间。目前取值仅支持 5、30、60、3600(1 小时)、43200(12 小时)、86400(一天),单位秒(s),默认 60。

    60
    Priorityinteger

    MX 记录的优先级。取值越小,优先级越高,取值范围:[1,99]

    5
    Valuestring

    记录值。根据不同解析记录类型,填写相应的记录值。

    114.55.XX.XX
    UserClientIpstring

    用户 Ip。

    127.0.XX.XX
    Remarkstring

    备注。

    en
    ClientTokenstring

    客户端 Token,用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过 64 个 ASCII 字符。

    6447728c8578e66aacf062d2df4446dc

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    唯一请求识别码。

    0B7AD377-7E86-44A8-B9A8-53E8666E72FE
    RecordIdlong

    解析记录 ID。

    429570****
    Successboolean

    是否成功。

    true

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "0B7AD377-7E86-44A8-B9A8-53E8666E72FE",
      "RecordId": 0,
      "Success": true
    }

    错误码

    访问错误中心查看更多错误码。