You need to enable JavaScript to run this app.
导航
QueryRecord - 获取解析记录信息
最近更新时间:2025.06.23 20:22:18首次发布时间:2023.09.21 16:44:20
我的收藏
有用
有用
无用
无用

获取一条解析记录的详细信息。

使用说明

请求频率:每秒最多调用 10 次。

请求说明

  • 请求方式:GET
  • 请求地址:https://private-zone.volcengineapi.com/?Action=QueryRecord?Version=2022-06-01

调试

请求参数

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

参数
类型
是否必填
示例值
描述
Action
String

QueryRecord

要执行的操作,取值:QueryRecord。

Version
String

2022-06-01

API的版本,取值:2022-06-01。

ZID
Long

1234

标识域名的唯一 ID。您可以通过以下 API 获取:

如果您需要验证子用户是否对域名所在的项目有操作权限,您需要传入该参数。

RecordID
String

9079256848785222159

解析记录 ID。您可以通过以下 API 获取:

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
CreatedAt
String

2023-09-20T15:24:43+08:00

解析记录的创建时间。

Enable
Boolean

true

解析记录是否被启用。

Host
String

abc

主机名。

LastOperator
String

21000041

最近一次更新解析记录的火山引擎账号的 ID。如果是子账号更新了解析记录,该参数的值是子账号的 ID。

Line
String

default

解析记录的线路。

RecordID
String

9079256848785341361

解析记录 ID。

Remark
String

remark

解析记录备注。

TTL
Integer

600

解析记录的过期时间。单位是秒。

Type
String

A

解析记录类型。

UpdatedAt
String

2023-09-20T15:24:43+08:00

解析记录最近一次的更新时间。

Value
String

10.0.0.1

记录值。

Weight
Integer

1

记录的权重。如果您没有开启负载均衡,则该参数不会被返回。

ZID
Integer

42027

域名 ID。

请求示例

GET https://private-zone.volcengineapi.com/?Action=QueryRecord&Version=2022-06-01&ZID=37424&RecordID=9079256848785222159


返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230920210025D5437C593B0F73225162",
        "Action": "QueryRecord",
        "Version": "2022-06-01",
        "Service": "private_zone",
        "Region": "cn-north-1"
    },
    "Result": {
        "ZID": 42027,
        "RecordID": "9079256848785341361",
        "Host": "host-52c5c19c",
        "Value": "txt-record-009f4eea",
        "Type": "TXT",
        "TTL": 600,
        "Weight": 10,
        "Enable": false,
        "Remark": "",
        "CreatedAt": "2023-09-20T15:24:43+08:00",
        "UpdatedAt": "2023-09-20T15:24:43+08:00",
        "LastOperator": "21xxxxx41"
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
ErrDBNotFound

db not found

数据条目未找到

400
ErrParamInvalid

validation fail: params:[%s] , value:[%v]

参数校验失败

500
ErrInternalServer

server internal error

服务内部错误