最近更新时间:2023.12.06 10:39:30
首次发布时间:2022.11.24 20:57:30
API 名称:UpdateRecordStatus
。
API 域名:open.volcengineapi.com
。
API 描述:启用或者禁用指定的解析记录。
POST
每秒最多调用 10 次。
除了以下参数,您还需要 对请求进行鉴权。
参数名称 | 数据类型 | 参数类型 | 是否必选 | 参数说明 |
---|---|---|---|---|
Action | String | 查询参数 | 是 | API 的名称。该参数的取值是 UpdateRecordStatus 。 |
Version | String | 查询参数 | 是 | API 的版本。该参数的取值是 2018-08-01 。 |
RecordID | String | 请求正文参数 | 是 | 解析记录的 ID。 |
Enable | Boolean | 请求正文参数 | 否 | 是否启用该解析记录。该参数有以下取值:
|
参数名称 | 数据类型 | 参数说明 |
---|---|---|
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 | 解析记录对应的线路代号。关于该参数的值所对应的线路名称,您可以调用 ListLines API 获取。 |
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=UpdateRecordStatus { "Enable": false, "RecordID": "3170534137672596377" }
{ "ResponseMetadata": { "RequestId": "202304121150099DA3F1A4F85CC29311FC", "Action": "UpdateRecordStatus", "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": false, "CreatedAt": "2023-04-12T11:21:15+08:00", "UpdatedAt": "2023-04-12T11:34:23+08:00", "Operators": [ "2245xxxxx42011" ] } }