文档

UpdateZoneRecord - 修改解析记录

更新时间:

调用UpdateZoneRecord修改域名(Zone)的解析记录,包括主机记录、解析记录、权重等。

接口说明

注意事项

普通区域名修改解析记录至少需要等待 TTL 到期后才能全部生效,加速区域名修改解析记录立即生效,不受 TTL 值影响。

调试

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

授权信息

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

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

请求参数

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

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

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

www
Langstring

返回值语言,取值:

  • zh:中文。

  • en:英文。

默认值:en

en
RecordIdlong

解析记录 ID。可以通过调用 DescribeZoneRecords 查询解析记录列表获取。

172223****
Linestring

解析线路,默认:default。

default
Weightinteger

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

1
Typestring

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

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

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

60
Priorityinteger

MX 记录的优先级。可以为不同邮件服务器设置优先级,优先级取值 1-99,取值越小,优先级越高。

说明 记录类型为 MX 记录时,此参数必选。
1
Valuestring

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

192.16.XX.XX
UserClientIpstring

用户 Ip。

127.0.XX.XX
ClientTokenstring

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

6447728c8578e66aacf062d2df4446dc

返回参数

名称类型描述示例值
object
RequestIdstring

唯一请求识别码。

250E2C38-D0AD-4518-851D-1C1055805F82
RecordIdlong

解析记录 ID。

172223****

示例

正常返回示例

JSON格式

{
  "RequestId": "250E2C38-D0AD-4518-851D-1C1055805F82",
  "RecordId": 0
}

错误码

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