最近更新时间：2024.05.10 15:53:52
首次发布时间：2022.11.24 20:57:30
API 名称：UpdateRecord。
API 域名：open.volcengineapi.com。
API 描述：更新指定的解析记录。
POST
每秒最多调用 10 次。
除了以下参数，您还需要 对请求进行鉴权。
| 参数名称 | 数据类型 | 参数类型 | 是否必选 | 参数说明 |
|---|---|---|---|---|
| Action | String | 查询参数 | 是 | API 的名称。该参数的取值是 UpdateRecord。 |
| Version | String | 查询参数 | 是 | API 的版本。该参数的取值是 2018-08-01。 |
| RecordID | String | 请求正文参数 | 是 | 需要更新的解析记录的 ID。 |
| Host | String | 请求正文参数 | 是 | 主机记录，即子域名的域名前缀。如果您需要更新主域名的解析记录，把该参数设置为 @。例如，@.example.com 代表 example.com。 |
| Line | String | 请求正文参数 | 是 | 解析记录对应的线路。该参数的值来自：
|
| TTL | Integer | 请求正文参数 | 否 | 解析记录的过期时间。单位是秒。默认值是 600。 |
Type | String | 请求正文参数 | 否 | 记录类型。该参数的取值如下：
|
| Value | String | 请求正文参数 | 否 | 解析记录的记录值。关于不同类型记录的记录值格式，参见 解析记录类型。 |
| Weight | Integer | 请求正文参数 | 否 | 解析记录的权重。参见 功能版本规格 了解权重的限制。 |
| Remark | String | 请求正文参数 | 否 | 解析记录的备注。支持 UTF-8 编码且长度不超过 50 个字符。 |
参数名称 | 数据类型 | 参数说明 |
|---|---|---|
RequestId | String | 标识本次请求的 ID。 |
Action | String | Action 查询参数的值。 |
Version | String | API 版本。 |
Service | String | 服务类型。 |
Region | String | 服务所在区域。 |
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| RecordID | String | 解析记录的 ID。 |
| FQDN | String | （已废弃）解析记录所包含的主机名，PQDN（Partially Qualified Domain Name） 格式。例如 www.example.com。 |
| PQDN | String | 解析记录所包含的主机名，PQDN（Partially Qualified Domain Name） 格式。例如 www.example.com。 |
| Host | String | 解析记录包含的主机记录。如果该参数值是 @，表示二级域名本身。 |
| Type | String | 解析记录的类型。 |
| TTL | Integer | 解析记录的过期时间。单位是秒。 |
| Line | String | 解析记录对应的线路。该参数的值来自：
|
| Value | String | 解析记录包含的记录值。 |
| Weight | Integer | 解析记录的权重。 |
| RecordSetID | String | 解析记录所在的记录集的 ID。只有 A，AAAA，CNAME 类型的解析记录有记录集。 |
Enable | Boolean | 该解析记录是否是启用的。该参数有以下取值：
|
| Remark | String | 解析记录的备注。 |
| CreatedAt | String | 解析记录的创建时间。 |
| UpdatedAt | String | 该 API 被调用后，解析记录更新的时间。 |
| Operators | String[] | 调用该 API 的火山引擎的账号 ID。如果是子账号调用该 API，该参数的值是子账号的 ID。 |
POST https://open.volcengineapi.com?Version=2018-08-01&Action=UpdateRecord { "Host": "@", "Line": "default", "RecordID": "3170534137672596377", "TTL": 600, "Type": "A", "Value": "2.2.2.2", "Weight": 1 }
{ "ResponseMetadata": { "RequestId": "20230412113423845FDAC0026423CEA958", "Action": "UpdateRecord", "Version": "2018-08-01", "Service": "dns", "Region": "cn-north-1" }, "Result": { "RecordID": "3170534137672596377", "FQDN": "@.example.com", "PQDN": "@.example.com", "Host": "@", "Type": "A", "TTL": 600, "Line": "default", "Value": "2.2.2.2", "Weight": 1, "RecordSetID": "MzE3MDUzNDEzNzY2OTA5ODc5OHxALnlhbWFzaXRlLnRvcC58QXxkZWZhdWx0", "Enable": true, "Remark": "", "CreatedAt": "2023-04-12T11:21:15+08:00", "UpdatedAt": "2023-04-12T11:21:15+08:00", "Operators": [ "224512@2100042011" ] } }