更新时间:2024-03-14 GMT+08:00

修改公网Zone

功能介绍

修改单个Zone。

URI

PATCH /v2/zones/{zone_id}

参数说明请参见表1
表1 URI格式的参数说明

名称

是否必选

参数类型

说明

zone_id

String

待修改zone的ID。

可以通过查询公网Zone列表获取。

请求

  • 参数说明
    表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。

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