查询单个Zone下Record Set列表

功能介绍

查询单个Zone下Record Set列表。

URI

GET /v2/zones/{zone_id}/recordsets

请求

• 请求参数

  无

• 请求样例

  查询Zone ID为“2c9eb155587194ec01587224c9f90149”的域名的记录集列表。

  GET https://{DNS_Endpoint}/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets?limit=&offset=

响应

• 要素说明

  表2 响应样例的要素说明

  名称	参数类型	说明
  links	Object	指向当前资源或者其他资源的链接。当查询需要分页时，需要包含一个next链接指向下一页。 详细信息请参见表5。
  recordsets	Array of object	recordset列表对象，详细信息请参见表3。
  metadata	Object	返回满足过滤条件的资源总数，详细信息请参见表4。

  表3 recordsets字段说明

  名称	参数类型	说明
  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链接指向下一页。 详细信息请参见表5。

  表4 metadata参数说明

  名称	参数类型	说明
  total_count	Integer	满足查询条件的资源总数，不受分页（即limit、offset参数）影响。

  表5 links参数说明

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

• 响应样例

  {
      "links": {
          "self": "https://Endpoint/v2/recordsets?limit=1&marker=&name=&status=&zone_id=2c9eb155587194ec01587224c9f90149",
          "next": "https://Endpoint/v2/recordsets?limit=11&marker=2c9eb155587194ec01587224c9f9014a&name=&status=&zone_id=2c9eb155587194ec01587224c9f90149"
      },
      "recordsets": [
          {
              "id": "2c9eb155587194ec01587224c9f9014a",
              "name": "example.com.",
              "type": "SOA",
              "ttl": 300,
              "records": [
                  "ns1.hotrot.de. xx.example.com. (1 7200 900 1209600 300)"
              ],
              "status": "ACTIVE",
              "links": {
                  "self": "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587194ec01587224c9f9014a"
              },
              "zone_id": "2c9eb155587194ec01587224c9f90149",
              "zone_name": "example.com.",
              "create_at": "2016-11-17T11:56:03.439",
              "update_at": "2016-11-17T12:56:03.827",
              "default": true,
              "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c"
          },
          {
              "id": "2c9eb155587194ec01587224c9f9014c",
              "name": "example.com.",
              "type": "NS",
              "ttl": 172800,
              "records": [
                  "ns2.hotrot.de.",
                  "ns1.hotrot.de."
              ],
              "status": "ACTIVE",
              "links": {
                  "self": "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587194ec01587224c9f9014c"
              },
              "zone_id": "2c9eb155587194ec01587224c9f90149",
              "zone_name": "example.com.",
              "create_at": "2016-11-17T11:56:03.439",
              "update_at": "2016-11-17T12:56:03.827",
              "default": true,
              "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c"
          },
          {
              "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:56:03.827",
              "default": false,
              "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c"
          }
      ],
      "metadata": {
          "total_count": 3
      }
  }

返回值

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

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