最近更新时间:2024.05.10 15:53:59
首次发布时间:2022.11.24 20:57:30
API 名称:QueryRecord
。
API 域名:open.volcengineapi.com
。
API 描述:获取指定解析记录的详细信息。
GET
每秒最多调用 50 次。
除了以下参数,您还需要 对请求进行鉴权。
参数名称 | 数据类型 | 参数类型 | 是否必选 | 参数说明 |
---|---|---|---|---|
Action | String | 查询参数 | 是 | API 的名称。该参数的取值是 QueryRecord 。 |
Version | String | 查询参数 | 是 | API 的版本。该参数的取值是 2018-08-01 。 |
RecordID | String | 查询参数 | 否 | 解析记录 ID。该参数有以下说明:
|
FQDN | String | 查询参数 | 否 | (废弃)解析记录的主机名。您可以使用 FQDN(Fully Qualified Domain Name)格式(例如 www.example.com. )或 PQDN(Partially Qualified Domain Name)格式(例如 www.example.com )。 |
PQDN | String | 查询参数 | 否 | 解析记录的主机名。您可以使用 FQDN(Fully Qualified Domain Name)格式(例如 www.example.com. )或 PQDN(Partially Qualified Domain Name)格式(例如 www.example.com )。 |
Line | String | 查询参数 | 否 | 解析记录的线路。该参数的值来自 ListLines API 返回的线路的 Value 参数。 |
Type | String | 查询参数 | 否 | 解析记录的类型。 |
Value | String | 查询参数 | 否 | 解析记录的记录值。 |
参数名称 | 数据类型 | 参数说明 |
---|---|---|
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 | 该解析记录是否被启用。该参数有以下取值:
|
Tags | Array of String | 解析记录的标签信息。如果该参数的值包含 GTMLock ,则说明该解析记录与火山引擎云调度(GTM)中的 GTM 实例关联。 |
Remark | String | 解析记录的备注。 |
CreatedAt | String | 解析记录的创建时间。 |
UpdatedAt | String | 解析记录最近一次更新的时间。 |
Operators | String[] | 最近一次更新该解析记录的火山引擎账号的 ID。如果是子账号更新该解析记录,该参数的值是子账号的 ID。 |
GET https://open.volcengineapi.com?Version=2018-08-01&Action=QueryRecord&RecordID=3170534137672596377
{ "ResponseMetadata": { "RequestId": "2023052416510645D0D3D35334AD2EA31D", "Action": "QueryRecord", "Version": "2018-08-01", "Service": "dns", "Region": "cn-north-1" }, "Result": { "RecordID": "3170534137672961176", "FQDN": "www.example.com", "PQDN": "www.example.com", "Host": "www", "Type": "A", "TTL": 600, "Line": "default", "Value": "2.2.2.2", "Weight": 1000, "RecordSetID": "MzE3MDUzNDEzNzY2OTA5ODc5OHx0ZXN0MDIyLnlhbWFzaXRlLnRvcC58QXxkZWZhdWx0", "Enable": true, "Tags": [], "Remark": "", "CreatedAt": "2023-05-24T16:50:31+08:00", "UpdatedAt": "2023-05-24T16:50:31+08:00", "Operators": [ "21xxxxxx1" ] } }