更新时间:2024-12-25 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为a43a844e-26cf-4319-87c4-5c714888dbc5的IP列表,防火墙id为fced7179-64a4-4438-bc6d-b510a2da2f64,域名组id为2cd83033-67d0-4515-9d72-c40caa11e8c6,项目id为408972e72dcd4c1a9b033e955802a36b

https://{Endpoint}/v1/408972e72dcd4c1a9b033e955802a36b/domain/parse-ip-list/a43a844e-26cf-4319-87c4-5c714888dbc5?fw_instance_id=fced7179-64a4-4438-bc6d-b510a2da2f64&domain_set_id=2cd83033-67d0-4515-9d72-c40caa11e8c6&domain_address_id=a43a844e-26cf-4319-87c4-5c714888dbc5

响应示例

状态码: 200

域名的ip解析数据

{ }

状态码

状态码

描述

200

域名的ip解析数据

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码

相关文档