UpdateRecord
更新DNS解析记录，支持多种记录类型及源站鉴权配置
服务地址：
华东1（杭州）
输入参数
只看必填
RecordId记录的ID
Ttl记录的过期时间
Proxied记录是否开启代理加速
请选择布尔值
Data记录的DNS信息
Value记录值或部分内容
Priority记录的优先级
Flag记录的标志位
Tag记录的标签
Weight记录的权重
Port记录的端口
Type记录的证书类型（在CERT记录中）
KeyTag记录的公钥标识
Algorithm记录所采用的加密算法
Certificate记录的公钥证书信息
Usage记录的用途标识
Selector记录所使用的证书或公钥的类型
MatchingType记录用于匹配或验证证书的算法策略
Fingerprint记录的公钥指纹值
SourceTypeCNAME记录的源站类型
BizName记录加速时的业务场景
Comment记录的备注
AuthConfCNAME记录的源站鉴权信息
AuthType源站鉴权类型
SecretKey源站所属账号的SecretKey
AccessKey源站所属账号的AccessKey
Region签名算法版本
Version源站所属区域
HostPolicy回源HOST策略
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

此 API 允许您更新 DNS 记录，包括但不限于 A/AAAA、CNAME、NS、MX、TXT、CAA、SRV、URI 等类型。您可以通过传递相应的记录值、优先级、标志位等字段来修改记录内容。对于需要鉴权的 CNAME 源站（如 OSS、S3），API 还支持配置源站鉴权信息，确保安全访问。

注意事项

  • 记录值（Value）与记录类型需匹配，如 CNAME 记录应对应目标域名。
  • 某些记录类型（如 MX、SRV）需指定优先级（Priority）。
  • CAA 记录需提供 Flag、Tag 等特定字段。
  • 更新 CERT、SSHFP 等安全记录时，需准确设置 Type、Algorithm 等字段。
  • 使用 OSS 或 S3 作为源站时，根据权限配置 AuthConf 中的鉴权详情。

请求参数

字段名称字段详情
RecordIdinteger<int64>

记录的 ID，可以通过 ListRecords 获取。

注意 该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。
示例值:1234567890123参考取值来源:
    ListRecords
    CreateRecord
    BatchCreateRecords
Ttlinteger<int32>

记录的过期时间，单位秒。范围为30~86400，或为 1。当取值为 1 时，表示记录的过期时间为自动。

示例值:30
Proxiedboolean

记录是否开启代理加速。只有 CNAME 记录与 A/AAAA 记录可以开启代理加速。取值：展开详情

示例值:true
Dataobject

记录的 DNS 信息。不同类型的记录，该字段需要传的内容也不同，请参考说明文档。

示例值:{ "value":"2.2.2.2" }
SourceTypestring

CNAME 记录的源站类型。添加 CNAME 记录时，需要填写此参数。取值：展开详情

示例值:OSS
BizNamestring

记录加速时的业务场景，不开启加速的记录不需要传，取值：展开详情

示例值:web
Commentstring

记录的备注。

示例值:This is a remark.
AuthConfobject

CNAME 记录的源站鉴权信息。

HostPolicystring

回源 HOST 策略，记录类型为 CNAME 时生效，设置回源时带 HOST 的策略，有两种模式：展开详情

示例值:follow_origin_domain枚举值:

请求说明

记录的 Data 字段包含记录的 DNS 信息。不同类型的记录，该字段需要传的内容也不同，请参考说明文档。

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:0AEDAF20-4DDF-4165-8750-47FF9C1929C9
变更历史
变更时间变更内容概要操作
2024-10-10
变更错误码400
变更请求参数HostPolicy
2024-09-24
变更错误码400
2024-09-23
变更错误码400
变更错误码404
新增请求参数HostPolicy