星盾安全加速

产品文档

星盾安全加速

listDNSRecords

描述

列出、搜索、排序和筛选域的DNS记录。

请求方式

GET

请求地址

https://starshield.jdcloud-api.com/v1/zones/{zone_identifier}/dns_records

名称 类型 是否必需 默认值 描述
zone_identifier String True

请求参数

名称 类型 是否必需 默认值 描述
match String False all 是否匹配所有搜索要求或至少一个(任何)
name String False DNS record name
order String False 用于排序的字段
page Number False 1 分页结果的页码
per_page Number False 20 每页的DNS记录数
content String False DNS记录内容
type String False DNS记录类型
proxied Boolean False DNS记录代理状态
direction String False asc - 升序;desc - 降序

返回参数

名称 类型 描述
result Result
requestId String

Result

名称 类型 描述
dataList DnsRecord[ ]

DnsRecord

名称 类型 描述
meta Meta
locked Boolean 此记录是否可以被修改/删除(true意味着它由星盾管理)。
data Data
name String DNS记录名称
ttl Number DNS记录的生存时间。值为1是 "自动"。
zone_id String 域标识符标签
modified_on String 记录最近修改时间
created_on String 创建记录时间
proxiable Boolean 记录是否由星盾代理
content String 有效的IPv4地址
type String 记录类型
ty_pe String 记录类型(值同type)
id String DNS记录标识符标签
proxied Boolean 是否利用星盾的性能和安全优势
zone_name String 记录的域名
priority Number 与一些记录如MX和SRV一起使用,以确定优先级。如果你没有为MX记录提供一个优先级,默认值为0将被设置。

Data

名称 类型 描述
size Number 位置的大小(米)
altitude Number 位置高度(米)
long_degrees Number 经度
lat_degrees Number 纬度
precision_horz Number 水平定位精度
precision_vert Number 垂直定位精度
long_direction String 经度方向
long_minutes Number 经度分
long_seconds Number 经度秒
lat_direction String 纬度方向
lat_minutes Number 纬度分
lat_seconds Number 纬度秒
service String 以下划线为前缀的服务类型
proto String 有效的协议
name String 有效的主机名
priority Number 与一些记录如MX和SRV一起使用,以确定优先级。如果你没有为MX记录提供一个优先级,默认值为0将被设置。
weight Number 记录的权重
port Number 服务的端口
target String 有效的主机名
ty_pe Number 类型
key_tag Number Key Tag
algorithm Number Algorithm
certificate String 证书
flags Number Flags
protocol Number 协议
public_key String 公钥
digest_type Number 摘要类型
digest String 摘要
order Number Order
preference Number Preference
regex String Regex
replacement String Replacement
usage Number Usage
selector Number Selector
matching_type Number Matching Type
fingerprint String 指纹
content String 记录内容

Meta

名称 类型 描述
auto_added Boolean 如果星盾在初始设置期间自动添加了此 DNS 记录,则会存在。
source String 记录来自哪里

返回码

返回码 描述
200 request successful
更新时间:2023-03-02 11:08:53
feedback