查询公网Zone

功能介绍

查询单个公网Zone。

URI

GET /v2/zones/{zone_id}

请求

• 请求参数

  无

• 请求样例

  查询域名Zone ID为“2c9eb155587194ec01587224c9f90149”的域名。

  GET https://{DNS_Endpoint}/v2/zones/2c9eb155587194ec01587224c9f90149

响应

• 要素说明

  表2 响应样例的要素说明

  名称	参数类型	说明
  id	String	zone的ID，uuid形式的一个资源标识。
  name	String	zone名称。
  description	String	对zone的描述信息。
  email	String	管理该zone的管理员邮箱。
  zone_type	String	zone类型，公网（public）或者内网（private）。
  ttl	Integer	该zone下SOA记录中的ttl值。 取值范围：1~2147483647。 默认值为300s。
  serial	Integer	该zone下SOA记录中用于标识zone文件变更的序列值，用于主从节点同步。 该参数暂未使用。
  status	String	资源状态。 详细信息请参见资源状态。
  record_num	Integer	该zone下的recordset个数。
  pool_id	String	托管该zone的pool，由系统分配。
  project_id	String	zone所属的项目ID。
  created_at	String	创建时间。 采用UTC时间格式，格式为：YYYY-MM-DDTHH:MM:SSZ
  updated_at	String	更新时间。 采用UTC时间格式，格式为：YYYY-MM-DDTHH:MM:SSZ
  links	Object	指向当前资源或者其他资源的链接。当查询需要分页时，需要包含一个next链接指向下一页。 详细信息请参见表3。
  masters	Array of strings	主从模式中，从DNS服务器用以获取DNS信息。 目前暂未使用。

  表3 links对象参数说明

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

• 响应样例

  {
      "id": "2c9eb155587194ec01587224c9f90149",
      "name": "example.com.",
      "description": "This is an example zone.",
      "email": "xx@example.com",
      "ttl": 300,
      "serial": 0,
      "masters": [],
      "status": "ACTIVE",
      "links": {
          "self": "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149"
      },
      "pool_id": "00000000570e54ee01570e9939b20019",
      "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c",
      "zone_type": "public",
      "created_at": "2016-11-17T11:56:03.439",
      "updated_at": "2016-11-17T11:56:05.528",
      "record_num": 2
  }
  

返回值

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

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