查询Record Set

功能介绍

查询单个Record Set。

URI

GET /v2.1/zones/{zone_id}/recordsets/{recordset_id}

参数说明请参见表1。

表1 URI格式的参数说明
名称	是否必选	参数类型	说明
zone_id	是	String	所属zone的ID。仅支持公网zone。可以通过查询公网Zone列表获取。
recordset_id	是	String	待查询recordset ID。可以通过查询单个Zone下Record Set列表获取。

请求

请求参数
 无
请求样例
 查询域名的记录集，域名的Zone ID为“2c9eb155587194ec01587224c9f90149”，Recordset ID为“2c9eb155587228570158722b6ac30007”。
```
GET https://{DNS_Endpoint}/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007
```

响应

参数说明

表2 响应样例的参数说明
名称	参数类型	说明
id	String	Record Set的ID。
name	String	Record Set的名称。
description	String	Record Set的描述信息。
zone_id	String	托管该记录的zone_id。
zone_name	String	托管该记录的zone_name。
type	String	记录类型。取值范围：A、AAAA、MX、CNAME、TXT、NS、SRV、CAA。详细信息请参见解析记录类型。
ttl	Integer	解析记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位。如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。
records	Array of strings	域名解析后的值。
created_at	String	创建时间。采用UTC时间格式，格式为：YYYY-MM-DDTHH:MM:SSZ
updated_at	String	更新时间。采用UTC时间格式，格式为：YYYY-MM-DDTHH:MM:SSZ
status	String	资源状态。详细信息请参见资源状态。
default	Boolean	标识是否由系统默认生成，系统默认生成的Record Set不能删除。
project_id	String	该Record Set所属的项目ID。
links	Object	指向当前资源或者其他资源的链接。当查询需要分页时，需要包含一个next链接指向下一页。详细信息请参见表3。
line	String	解析线路ID。
weight	Integer	解析记录的权重。
health_check_id	String	健康检查ID。
alias_target	Object	别名记录。详细信息请参见表4。

表3 links参数说明
名称	参数类型	说明
self	String	当前资源的链接。
next	String	下一页资源的链接。

表4 alias_target对象参数说明
名称	参数类型	说明
resource_type	String	资源服务类型，支持别名记录的服务。取值： cloudsite：云速建站 waf：Web应用防火墙
resource_domain_name	String	对应服务下的域名，由各服务提供。

响应样例

{
    "id": "2c9eb155587228570158722b6ac30007",
    "name": "www.example.com.",
    "description": "This is an example record set.",
    "type": "A",
    "ttl": 300,
    "records": [
        "192.168.10.2",
        "192.168.10.1"
    ],
    "status": "ACTIVE",
    "links": {
        "self": "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"
    },
    "alias_target":null,
    "zone_id": "2c9eb155587194ec01587224c9f90149",
    "zone_name": "example.com.",
    "created_at": "2016-11-17T12:03:17.827",
    "updated_at": "2016-11-17T12:56:03.827",
    "default": false,
    "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c",
    "line": "default_view",
    "weight": 1,
    "health_check_id":null
}