UpdateRecord_边缘安全加速_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
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
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 中的鉴权详情。

流控信息

请求速率为10/1(s)。

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称字段详情
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

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
InvalidParameter
The specified parameter is invalid.诊断
400
ServiceInvokeFailed
The call to the internal service failed. The engineer is resolving the problem. Please wait a moment before trying, or contact customer service for details.诊断
400
InternalException
Failed to call the service. Try again later or contact technical support.诊断
400
NoPermission
You do not have permissions to access or operate on the resource.Contact your account administrator to attach the AliyunESAFullAccess policy to the current user.诊断
400
InvalidParameter.RecordData
Invalid record content. Adjust your configurations based on the API documentation.诊断
400
Instance.NotOnline
Your plan is unavailable due to an overdue payment. Complete the payment first.诊断
400
Record.Reserved
Another operation on the record is in progress. Try again later.诊断
400
Record.ServiceBusy
The record is being configured. Try again later.诊断
400
Record.Conflict
The specified record content conflicts with existing records. Adjust your configurations based on the related product documentation.诊断
400
SourceCircleExist
The 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.诊断
404
Record.NotFound
The record does not exist. Check your configurations and try again.诊断

变更历史

变更时间变更内容概要操作
2024-10-10
变更错误码400
变更请求参数HostPolicy
2024-09-24
变更错误码400
2024-09-23
变更错误码400
变更错误码404
新增请求参数HostPolicy

相关示例