更新时间:2024-12-24 GMT+08:00
分享

获取域名地址解析结果

功能介绍

获取域名地址解析结果

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/domain/parse-ip-list/{domain_address_id}

表1 路径参数

参数

是否必选

参数类型

描述

domain_address_id

String

域名id,域名id可通过获取域名组下域名列表接口查询获得,通过返回值中的data.records.domain_address_id(.表示各对象之间层级的区分)获取

project_id

String

项目ID,可以从调API处获取,也可以从控制台获取。可通过项目ID获取方式获取

表2 Query参数

参数

是否必选

参数类型

描述

address_type

Integer

地址类型,0 ipv4,1 ipv6

domain_set_id

String

域名组ID,可通过查询域名组列表接口查询获得,通过返回值中的data.records.set_id(.表示各对象之间层级的区分)获取

fw_instance_id

String

防火墙ID,可通过防火墙ID获取方式获取

enterprise_project_id

String

企业项目ID,用户根据组织规划企业项目,对应的ID为企业项目ID,可通过如何获取企业项目ID获取,用户未开启企业项目时为0

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,可通过如何获取用户Token获取

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

data

Array of strings

域名解析数据

请求示例

查询域名id为30df03ed-92d5-4c56-aa35-2d638b3054ce的IP列表,防火墙id为03ea81c7-d8b9-4c64-bafa-774d2a8083d9,域名组id为1219c137-2789-490b-928e-a121e4b3de9e,项目id为eefb11b22d5944f2aa067954516df1cf

https://{Endpoint}/v1/eefb11b22d5944f2aa067954516df1cf/domain/parse-ip-list/30df03ed-92d5-4c56-aa35-2d638b3054ce?fw_instance_id=03ea81c7-d8b9-4c64-bafa-774d2a8083d9&domain_set_id=1219c137-2789-490b-928e-a121e4b3de9e&domain_address_id=30df03ed-92d5-4c56-aa35-2d638b3054ce

响应示例

状态码: 200

域名的ip解析数据

{ }

状态码

状态码

描述

200

域名的ip解析数据

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码

相关文档