UpdateRecord-更新解析记录--TrafficRoute DNS 套件-火山引擎

文档中心

立即注册

导航

TrafficRoute DNS 套件

UpdateRecord-更新解析记录

最近更新时间：2024.11.20 11:13:11首次发布时间：2023.02.08 13:12:22

更新一条解析记录。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com?Action=UpdateRecord?Version=2022-06-01

请求参数

除了以下参数，您还需要对请求进行鉴权。

Query

名称	类型	是否必选	示例值	描述
Action	String	是	`UpdateRecord`	API 的名称。该参数的取值是 `UpdateRecord`。
Version	String	是	`2022-06-01`	API 的版本。该参数的取值是 `2022-06-01`。

Body

名称	类型	是否必选	示例值	描述
RecordID	String	是	`9079256848778957482`	解析记录 ID。您可以通过以下 API 获取： CreateRecord API ListRecords API
Enable	Boolean	否	`true`	是否启用解析记录。 true：启用解析记录。 false：禁用解析记录。如果您不设置该参数，该参数的值不会改变。
Host	String	否	`abc`	子域名的域名前缀（主机记录）。参见添加解析记录了解域名前缀的格式要求。如果您不设置该参数，该参数的值不会改变。
Value	String	否	`1.1.1.1`	记录值。参见解析记录类型。如果您不设置该参数，该参数的值不会改变。
Type	String	否	`A`	解析记录类型。如果您不设置该参数，该参数的值不会改变。
Weight	Integer	否	`1`	记录值的权重。只有域名开启了负载均衡后，记录值的权重才会生效。参见 UpdatePrivateZone API 了解如何为域名开启或关闭负载均衡。如果您不设置该参数，该参数的值不会改变。
TTL	Integer	否	`60`	解析记录的过期时间。单位为秒。如果您不设置该参数，该参数的值不会改变。
Line	String	否	`subnet-3cj8h1e5kij286c6rrt5m****`	解析记录的线路。可以是 `default` 或 VPC 子网 ID。在设置该参数之前，您必须在调用 CreatePrivateZone API 时开启智能解析功能。否则，该参数设置无效。如果您不设置该参数，该参数的值不会改变。
Remark	String	否	`Remark`	备注。如果您不设置该参数，该参数的值不会改变。
ZID	Integer	否	`123456`	标识域名的唯一 ID。您可以通过以下 API 获取：添加域名 API 获取域名列表 API 如果您需要验证子用户是否对域名所在的项目有操作权限，您需要传入该参数。

返回参数

ResponseMetadata 对象

名称	类型	描述
RequestId	String	标识本次请求的 ID。
Action	String	Action 查询参数的值。
Version	String	API 版本。
Service	String	服务类型。
Region	String	服务所在地域。

示例

请求示例

POST https://open.volcengineapi.com/?Action=UpdateRecord&Version=2022-06-01

{
    "RecordID": "9079256848778957482",
    "Enable": true,
    "Host": "abc",
    "Value": "1.1.1.1",
    "Type": "A",
    "Weight": 10,
    "TTL": 600,
    "Line": "default",
    "Remark":""
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20221215101225DB0A30AF803D07576779",
        "Action": "UpdateRecord",
        "Version": "2022-06-01",
        "Service": "private_zone",
        "Region": "cn"
    },
}

错误码

您可访问公共错误码，获取详细信息。