获取一条解析记录的详细信息。
请求频率:每秒最多调用 10 次。
除了以下参数,您还需要 对请求进行鉴权。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
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 | 数据条目未找到 |
400 | ErrParamInvalid | 参数校验失败 |
500 | ErrInternalServer | 服务内部错误 |