UpdateRecord - 更新解析记录

更新DNS解析记录,支持多种记录类型及源站鉴权配置。

接口说明

此 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 中的鉴权详情。

调试

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

授权信息

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

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

请求参数

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

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

1234567890123
Ttlinteger

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

30
Proxiedboolean

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

  • true:开启代理。
  • false:关闭代理加速。
true
Dataobject

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

Valuestring

记录值或部分内容。添加 A/AAAA、CNAME、NS、MX、TXT、CAA、SRV、URI 记录时,该参数必填。在不同类型的记录中,分别表示不同的含义:

  • A/AAAA:指向的 Ip 地址。多个 Ip 时,用","分隔。至少需要有一个 Ipv4 地址。
  • CNAME:指向的目标域名。
  • NS:指定域名的名称服务器。
  • MX: 有效的目标邮件服务器域名。
  • TXT:有效的文本字符串。
  • CAA:有效的证书颁发机构域名。
  • SRV:有效的目标主机域名。
  • URI: 有效的 URI 字符串。
example.com
Priorityinteger

记录的优先级,范围为0~65535。数值越小,优先级越高。添加 MX、SRV、URI 记录时,该参数必填。

10
Flaginteger

记录的标志位。CAA 记录的 Flag 指示其优先级和处理方式,取值范围为0~255。添加 CAA 记录时,该参数必填。

128
Tagstring

记录的标签。CAA 记录的 Tag 表示其具体类型和用途。添加 CAA 记录时,该参数必填。

issue
Weightinteger

记录的权重,范围为0~65535。添加 SRV、URI 记录时,该参数必填。

0
Portinteger

记录的端口,范围为0~65535。添加 SRV 记录时,该参数必填。

0
Typeinteger

记录的证书类型(在 CERT 记录中),或公钥类型(在 SSHFP 记录中)。添加 CERT、SSHFP 记录时,该参数必填。

0
KeyTaginteger

记录的公钥标识,范围为0~65535。添加 CERT 记录时,该参数必填。

0
Algorithminteger

记录所采用的加密算法,范围为0~255。添加 CERT、SSHFP 记录时,该字段必填。

0
Certificatestring

记录的公钥证书信息。添加 CERT、SMIMEA 和 TLSA 记录时,该参数必填。

dGVzdGFkYWxrcw==
Usageinteger

记录的用途标识,范围为0~255。添加 SMIMEA 和 TLSA 时,该参数必填。

0
Selectorinteger

记录所使用的证书或公钥的类型,范围为0~255。添加 SMIMEA 和 TLSA 时,该参数必填。

0
MatchingTypeinteger

记录用于匹配或验证证书的算法策略,范围为0~255。添加 SMIMEA 和 TLSA 记录时,该参数必填。

0
Fingerprintstring

记录的公钥指纹值。添加 SSHFP 记录时,该参数必填。

abcdef1234567890
SourceTypestring

CNAME 记录的源站类型。添加 CNAME 记录时,需要填写此参数。取值:

  • OSS:OSS 源站。
  • S3:S3 源站。
  • LB:负载均衡器源站。
  • OP:源地址池源站。
  • Domain:普通域名源站。

该参数不传或传空时,则默认为 Domain,即普通域名源站类型。

OSS
BizNamestring

记录加速时的业务场景,不开启加速的记录不需要传,取值:

  • video_image:视频图片。
  • api:api 接口。
  • web:web 网页。
web
Commentstring

记录的备注。

This is a remark.
AuthConfobject

CNAME 记录的源站鉴权信息。

AuthTypestring

源站鉴权类型,不同的源站类型,支持的鉴权类型不同,源站类型是指本接口中的 SourceType 参数,现在源站类型为 OSS 和 S3 时,需要填写源站鉴权类型,可选值:

  • public:公共读,当源站类型为 OSS 或 S3,且源站为公共读时,选此值。
  • private: 私有读,当源站类型为 S3,且源站为私有读时,选此值。
  • private_same_account: 私有同账号读,当源站类型为 OSS,在同一个阿里云账号下,且源站为私有读时,选此值。
private
SecretKeystring

源站所属账号的 SecretKey,当源站类型为 OSS 且源站鉴权类型为私有跨账号读,或者源站类型为 S3 且源站鉴权类型为私有读时,需要填写此值。

u0Nkg5gBK*******QF5wvKMM504JUHt
AccessKeystring

源站所属账号的 AccessKey,当源站类型为 OSS 且源站鉴权类型为私有跨账号读,或者源站类型为 S3 且源站鉴权类型为私有读时,需要填写此值。

VIxuvJSA2S03f******kp208dy5w7
Regionstring

签名算法版本,当源站类型为 S3 且源站鉴权类型为私有读时需要,支持以下两种:

  • v2

  • v4

不传时,默认为 v4。

v2
Versionstring

源站所属区域,当源站类型为 S3 时,需要填写此值,源站所属的区域需要在 S3 的官方网站上获取。

us-east-1
HostPolicystring

回源 HOST 策略,记录类型为 CNAME 时生效,设置回源时带 HOST 的策略,有两种模式:

  • follow_hostname: 跟随主机记录。
  • follow_origin_domain: 跟随源站域名。
follow_origin_domain

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

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

0AEDAF20-4DDF-4165-8750-47FF9C1929C9

示例

正常返回示例

JSON格式

{
  "RequestId": "0AEDAF20-4DDF-4165-8750-47FF9C1929C9"
}

错误码

HTTP status code错误码错误信息描述
400InvalidParameterThe specified parameter is invalid.输入参数规范校验失败。
400ServiceInvokeFailedThe call to the internal service failed. The engineer is resolving the problem. Please wait a moment before trying, or contact customer service for details.调用服务失败,请稍后重试或联系客服咨询详情。
400InternalExceptionFailed to call the service. Try again later or contact technical support.调用服务失败,请稍后重试或联系客服咨询详情。
400NoPermissionYou do not have permissions to access or operate on the resource.Contact your account administrator to attach the AliyunESAFullAccess policy to the current user.对当前资源无权限访问或者操作。请联系您阿里云账户的管理员,以授予您 AliyunESAFullAccess 策略。
400InvalidParameter.RecordDataInvalid record content. Adjust your configurations based on the API documentation.记录内容参数错误,请根据接口文档调整参数内容。
400Instance.NotOnlineYour plan is unavailable due to an overdue payment. Complete the payment first.您的套餐实例因欠费当前处于非上线状态,请先完成续费操作以继续使用。
400Record.ReservedAnother operation on the record is in progress. Try again later.记录操作正在进行中,请稍等重试。
400Record.ServiceBusyThe record is being configured. Try again later.该记录正在配置中,请稍后再试。
400Record.ConflictThe specified record content conflicts with existing records. Adjust your configurations based on the related product documentation.和已有记录冲突,请根据冲突规则的产品文档调整记录内容。
400SourceCircleExistThe host record of the resource to be operated on is already the source station of another resource, or the source station of the current resource has been added as a host record. To avoid loopback, modify the host record or source station and retry.当前要操作资源的主机记录已经是其他资源的源站,或者当前资源的源站已经被添加为主机记录,为避免回环产生,请修改主机记录或者源站后进行重试。
404Record.NotFoundThe record does not exist. Check your configurations and try again.传入的请求记录不存在,请检查您的输入参数后重试。

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

变更历史

变更时间变更内容概要操作
2024-10-10OpenAPI 错误码发生变更查看变更详情
2024-09-24OpenAPI 错误码发生变更查看变更详情
2024-09-23OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情