云解析服务 DNS云解析服务 DNS

更新时间:2021/06/16 GMT+08:00
分享

查询名称服务器列表

功能介绍

查询名称服务器列表。

URI

GET /v2/nameservers?type={type}&region={region}

参数说明请参见表1
表1 URI格式的参数说明

名称

是否必选

参数类型

说明

type

String

待查询名称服务器的类型。

取值范围: public、private。

  • 如果为空,表示查询所有类型的名称服务器。
  • 如果为public,表示查询公网的名称服务器。
  • 如果为private,表示查询内网的名称服务器。

搜索模式精确搜索。

默认值为空。

region

String

待查询的region ID。

当查询公网的名称服务器时,此处不填。

搜索模式精确搜索。

默认值为空。

请求

  • 请求参数

  • 请求样例

    查询公网名称服务器列表。

    GET https://{DNS_Endpoint}/v2/nameservers?type=public&region=

响应

  • 要素说明
    表2 响应样例的要素说明

    名称

    参数类型

    说明

    nameservers

    Array of object

    name server列表对象,详细内容请参见表3

    表3 nameservers参数说明

    名称

    参数类型

    说明

    type

    String

    名称服务器类型。

    region

    String

    region下对应的名称服务器。

    当为公网名称服务器时,此值为空。

    ns_records

    Array of object

    名称服务器地址列表。详细内容请参见表4

    表4 ns_records参数说明

    名称

    参数类型

    说明

    hostname

    String

    主机名。

    当为内网名称服务器时,此值为空。

    address

    String

    名称服务器地址。

    当为公网名称服务器时,此值为空。

    priority

    Integer

    优先级。

    示例:

    如果priority的值为“1”,表示会第一个采用该域名服务器进行解析。

  • 响应样例
    {
        "nameservers": [
           {
               "region": null,
               "type": "public",
               "ns_records": [
                  {
                      "hostname": "ns1.huawei.com.",
                      "priority": 1
                  },
                  {
                       "hostname": "ns2.huawei.com.",
                       "priority": 2
                  }
               ]
            },
            {
                "region": "xxx",
                "type": "private",
                "ns_records": [
                   {
                        "priority": 1,
                        "address": "100.125.1.0"
                   },
                   {
                        "priority": 2,
                        "address": "100.125.1.1"
                    }
                ]
            }
        ]
    }
    

返回值

接口正常的返回值为2xx,例如200、202或者204。

返回值含义以及更多返回值请参考状态码

分享:

    相关文档

    相关产品