最近更新时间:2023.12.06 10:39:30
首次发布时间: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 | 请求正文参数 | 是 | 主机记录。如果更新指定的是二级域名本身,该参数的值为 @ 。 |
Line | String | 请求正文参数 | 是 | 解析记录对应的线路。该参数的值来自:
|
TTL | Integer | 请求正文参数 | 否 | 解析记录的过期时间。单位是秒。默认值是 600 。 |
Type | String | 请求正文参数 | 否 | 记录类型。该参数的取值如下:
|
Value | String | 请求正文参数 | 否 | 记录值。 |
Weight | Integer | 请求正文参数 | 否 | 解析记录的权重。 |
参数名称 | 数据类型 | 参数说明 |
---|---|---|
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 | 该解析记录是否是启用的。该参数有以下取值:
|
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, "CreatedAt": "2023-04-12T11:21:15+08:00", "UpdatedAt": "2023-04-12T11:21:15+08:00", "Operators": [ "224512@2100042011" ] } }