修改公网Zone

功能介绍

修改单个Zone。

URI

PATCH /v2/zones/{zone_id}

请求

• 参数说明

  表2 请求样例的参数说明

  名称	是否必选	参数类型	说明
  description	否	String	域名的描述信息。长度不超过255个字符。 如果为空，表示维持原值。 默认值为空。
  email	否	String	管理该zone的管理员邮箱。 如果为空，表示维持原值。 默认值为空。
  ttl	否	Integer	用于填写默认生成的SOA记录中有效缓存时间，以秒为单位。 取值范围： 300~2147483647。 如果为空，表示维持原值。 默认值为空。

• 请求样例

  修改域名Zone ID为“2c9eb155587194ec01587224c9f90149”的域名信息。

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

  {
      "description": "This is an example zone.",
      "email": "xx@example.org",
      "ttl": 300
  }

响应

• 要素说明

  表3 响应样例的要素说明

  名称	参数类型	说明
  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链接指向下一页。 详细信息请参见表4。
  masters	Array of strings	主从模式中，从DNS服务器用以获取DNS信息。 目前暂未使用。

  表4 links对象参数说明

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

• 响应样例

  {
      "id": "2c9eb155587194ec01587224c9f90149",
      "name": "example.com.",
      "description": "This is an example zone.",
      "email": "xx@example.com",
      "ttl": 300,
      "serial": 1,
      "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.749",
      "record_num": 2
  }

返回值

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

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