查询Record Set

功能介绍

查询单个Record Set。

URI

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

请求

• 请求参数

  无

• 请求样例

  查询域名的记录集，Zone ID为“2c9eb155587194ec01587224c9f90149”，Recordset ID为“2c9eb155587228570158722b6ac30007”。

  GET https://{DNS_Endpoint}/v2/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、SOA、SRV、PTR（仅限内网Zone）、CAA（仅限公网Zone）。 详细信息请参见解析记录类型。
  ttl	Integer	解析记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位。 如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。 取值范围： 公网解析：1~2147483647。 内网解析：300~2147483647。 默认值为300s。
  records	Array of strings	域名解析后的值。
  create_at	String	创建时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS
  update_at	String	更新时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS
  status	String	资源状态。 详细信息请参见资源状态。
  default	Boolean	标识是否由系统默认生成，系统默认生成的Record Set不能删除。
  project_id	String	该Record Set所属的项目ID。
  links	Object	指向当前资源或者其他资源的链接。当查询需要分页时，需要包含一个next链接指向下一页。 详细信息请参见表3。

  表3 links参数说明

  名称	参数类型	说明
  self	String	当前资源的链接。
  next	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": "PENDING_CREATE",
      "links": {
          "self": "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"
      },
      "zone_id": "2c9eb155587194ec01587224c9f90149",
      "zone_name": "example.com.",
      "create_at": "2016-11-17T12:03:17.827",
      "update_at": "2016-11-17T12:03:18.827",
      "default": false,
      "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c"
  }
  

返回值

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

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